---
url: >-
  https://docs.corbitaltech.dev/products/whatsapp-qr-login-for-whatsmark-saas-bundle/installation.md
description: >-
  Follow this comprehensive guide to install the WhatsApp QR Login Module for
  WhatsMarkSaaS.
---

# 🚀 WhatsApp QR Login Module Installation Guide

***

::: warning Important Notice
This module requires the **latest version of WhatsMarkSaaS Bundle**.

Before using this module, make sure the included Node.js gateway is installed and running on your server. Your WhatsMark SaaS Bundle application must also be able to connect to the gateway.
:::

## Prerequisites

Before installing the WhatsApp QR Login Module, make sure you have:

* **WhatsMarkSaaS Bundle** (latest version) installed and running
* **Node.js 20+** available on the host that will run the gateway service
* **Admin access** to your WhatsMarkSaaS Bundle dashboard
* **A WhatsApp account on a phone** ready to scan the QR

### Configure Plan Features

After successful installation:

* Navigate to **Admin > Plans & Pricing**
* Edit the subscription plans that should include WhatsApp QR Login
* Find the **WhatsApp QR Login** feature textbox and enter **1** to enable it (or **0** to disable)
* Save the plan configuration

::: details 📋 PLAN CONFIGURATION EXAMPLE
Here's a typical configuration for enabling WhatsApp QR Login on a plan:

1. Go to **Admin > Plans & Pricing**
2. Select the plan you want to update (e.g. "Professional" or "Enterprise")
3. Find the **Features** or **Modules** section
4. Locate the **WhatsApp QR Login** feature textbox
5. Enter **1** to enable the feature (or **0** to disable)
6. Save the changes
7. Repeat for other plans as needed
   :::

## First Connection Test

Once installation is complete, test the module end-to-end:

1. Log in as a tenant on a plan that has QR Login enabled
2. Open the **WhatsApp QR Login** page from the menu
3. Click **New Connection**, give it a name, and scan the QR with your phone
4. Wait for the status to turn **Connected** — your phone number and WhatsApp display name should appear
5. Click **Open Chats** and send a test message

If the QR doesn't appear, the connection fails, or messages don't flow, see the [Troubleshooting](/products/whatsapp-qr-login-for-whatsmark-saas-bundle/troubleshooting.md) page.

## Next Steps

Once installation is complete:

1. **Configure plan features** — enable WhatsApp QR Login on the right subscription plans
2. **Tenant onboarding** — guide tenants through their first QR scan
3. **Read the Chat Interface guide** — learn the inbox, composer, and message types

For detailed configuration steps, refer to the [Getting Started Guide](/products/whatsapp-qr-login-for-whatsmark-saas-bundle/getting-started.md).