What Does This Module Do?
The WhatsApp QR Login module lets you connect a WhatsApp number to your WhatsMarkSaaS Bundle account using a QR code.
After you scan the QR code with the WhatsApp app on your phone, you can use WhatsApp from your browser. You and your team members can send and receive messages from the WhatsMarkSaaS Bundle inbox.
The module also includes additional features:
Connect a WhatsApp number — Connect a personal or business WhatsApp number without needing WhatsApp Cloud API approval.
Use a shared inbox — You and your team can view and reply to messages from the same inbox.
Send different types of messages — Send text, images, videos, audio, voice notes, locations, contact cards, reactions, and replies.
Use saved replies and customer details — Save frequently used messages and automatically add customer information, such as their name, when sending a message.
Use Contacts and Bot Flow Builder — WhatsApp conversations are linked to your Contacts, and you can use them with automated Bot Flows. QR Login supports fewer Bot Flow features than WhatsApp Cloud API. See Bot Flow Builder Support for the supported features.
How It Works
How WhatsApp QR Login Works
After you connect your WhatsApp number, the platform works to a session that stays connected to your account.
Scan the QR code — Open WhatsApp on your phone and scan the QR code shown in the platform.
Connect your WhatsApp account — Your phone approves the platform as a linked device.
Receive messages automatically — New WhatsApp messages appear in your platform inbox in real time. Your phone does not need to stay connected to the internet.
Send messages from your WhatsApp number — Messages are sent using your connected WhatsApp number. Customers see your WhatsApp name, phone number, and profile picture.
Keep using WhatsApp on your phone — You can continue using WhatsApp normally on your phone while the platform is connected.
Your First Connection
Connecting your WhatsApp number takes about 30 seconds.
Step 1: Open the Connection Page
Sign in to your workspace and go to WhatsApp QR Login from the menu.
Step 2: Click "New Connection"
Give it a friendly name — for example "Sales line" or "Support". The name is just for you; WhatsApp itself never sees it.
Step 3: Scan the QR with Your Phone
On your phone open WhatsApp → Settings → Linked Devices → Link a Device. Point the camera at the QR shown on the screen.
⏱️ QR CODES EXPIRE QUICKLY
QR Code Expiration
The QR code is valid for about 60 seconds.
If you do not scan it within this time, click Refresh to generate a new QR code.
Tip: Keep WhatsApp open on your phone and have your phone camera ready before clicking Refresh. This makes it easier to scan the new QR code before it expires.
Step 4: Wait for "Connected"
After you scan the QR code, wait for the connection to complete.
The QR code will disappear, a green check mark will appear, and the page will show your WhatsApp phone number and WhatsApp display name.
When the status changes to Connected, click Open Chats to start using WhatsApp from the platform.
🔁 YOU ONLY NEED TO DO THIS ONCE
You only need to scan the QR code when you connect the WhatsApp number for the first time.
After the connection is established, the gateway keeps the connection active automatically. You do not need to scan the QR code again unless WhatsApp asks you to reconnect the account.
Implementation Roadmap
Phase 1: Plan Setup (Super Admin)
- Configure subscription plans to enable the WhatsApp QR Login feature
- Verify the gateway service is running and reachable
⚙️ ADMIN SETUP REQUIRED
This phase must be completed by a system administrator with access to the WhatsMarkSaaS Bundle admin panel and the gateway service.
Phase 2: Tenant Connection
- Open the QR Login page in the tenant dashboard
- Create a new connection and scan the QR with your phone
- Verify "Connected" status appears with your phone number and display name
Phase 3: Day-to-Day Usage
- Open the chat inbox and start replying to incoming messages
- Save canned replies for common responses
- Set up CRM merge fields for personalised outreach
Phase 4: Connect Contacts & Bot Flow Builder
- Check the Contacts list — connected chats show a QR Chat column linking to the conversation, see Contact Management
- Build automated flows — select WhatsApp QR Login as the channel/trigger source in the Bot Flow Builder, keeping in mind the node support differences below
Bot Flow Builder Support
WhatsApp QR Login supports automated Bot Flows, but it does not support all the Bot Flow node types available with WhatsApp Cloud API.
This is a limitation of how QR Login connects to WhatsApp. while some features are only available through the official WhatsApp Cloud API.
For example, features such as Meta message templates, interactive buttons, and interactive lists are not available through QR Login.
See the supported node types below to check which Bot Flow features you can use with QR Login.
| Node Type | Supported on QR Login? |
|---|---|
| Trigger | ✅ Yes |
| Text Message | ✅ Yes |
| Media Message (image, video, audio, document) | ✅ Yes |
| Location Message | ✅ Yes |
| Contact Message | ✅ Yes |
| Update Contact | ✅ Yes |
| Button Message | ❌ Cloud API only |
| Call to Action (CTA URL) | ❌ Cloud API only |
| List Message | ❌ Cloud API only |
| Template Message | ❌ Cloud API only |
| AI Assistant | ❌ Cloud API only |
| Webhook / API Call | ❌ Cloud API only |
| Delay | ⚠️ No effect on QR (see below) |
⛔ UNSUPPORTED NODES ARE SKIPPED SILENTLY, NOT FLAGGED
The Bot Flow Builder does not currently show a warning when you add a node that is not supported by WhatsApp QR Login.
If a QR Login flow reaches an unsupported node, such as Button Message or Template Message, the node is skipped.
No message is sent, and no error or activity log entry is created. The flow simply continues with the next node.
For flows that may be used with both QR Login and Cloud API:
Use only these node types to keep the flow working as expected:
- Text
- Media
- Location
- Contact
- Update Contact
If your flow needs buttons, lists, templates, or AI Assistant replies, use a WhatsApp Cloud API connection instead.
⏱️ THE DELAY NODE DOESN'T PAUSE QR FLOWS
Delay Node
The Delay node works differently depending on the WhatsApp connection type.
- Cloud API — The flow waits for the specified time before continuing to the next node.
- QR Login — The flow does not wait. It continues to the next node immediately.
Do not use the Delay node to add a wait between messages in a QR Login flow. If you need a delay between messages, use a Cloud API connection.