Connect WhatsApp with a QR code
Link the WhatsApp or WhatsApp Business app on your phone by scanning a QR code, and understand the risks of this unofficial connection.
For owners and admins
On this page
You can link the WhatsApp number you already use by scanning a QR code, just like WhatsApp Web. Your chats, including group chats, arrive in the inbox and you reply from there. It works with both the WhatsApp and the WhatsApp Business app.
If you don't see WhatsApp (QR / Personal) on the Connect page, your Luminobot administrator hasn't turned it on yet. Use the WhatsApp Business API instead.
Read this first: the risks
This is not the official WhatsApp Business API and isn't approved by WhatsApp.
- WhatsApp can temporarily or permanently ban numbers it thinks are automated, especially for bulk messages, many new chats, or reports from the people you message.
- To protect your number, Luminobot spaces messages from it a few seconds apart and caps how many it sends per day. The connect page shows the exact numbers.
- Broadcasts and drip campaigns can't send from a QR number.
- Your phone must stay online and connected.
For marketing, broadcasts or high volume, use the WhatsApp Business API.
Connect your number
You need permission to manage connected accounts and to use chat channels (workspace owners and managers have both), or be an organization owner or admin.
- Open Connect a channel and click Connect on the WhatsApp (QR / Personal) tile. You land on Connect a messaging channel with WhatsApp selected.
- Read the notice and tick I understand the risks and accept them for this number. You can't continue without it.
- Choose what to import (see below).
- Click Generate QR code.
- On your phone, open WhatsApp → Settings → Linked devices → Link a device, and scan the code. The code refreshes by itself; scan it within about a minute.
The page then moves through 1 · Scan, 2 · Paired, 3 · History and 4 · Ready. Keep the phone online while WhatsApp sends your chats. You can leave the page at any time: pairing and the import carry on, and new messages already arrive in the inbox.
The number uses one account slot of your plan, including while you're still pairing.
Import your chat history
WhatsApp only sends old chats right after you scan, so you choose before you link:
- Import your existing chat history? Don't import, Last 7 days, Last 30 days, Last 90 days or Everything WhatsApp provides.
- Sync your phone's contacts into Contacts: imports the rest of your WhatsApp address book. People you chat with are always added.
- Include group chats in the import: new group messages always arrive; this only controls old ones.
Imported messages are added quietly: no notifications, no unread badges, and no AI or workflow replies. Photos and files load when you open them. You can import history later from the channel's settings (Chat channels → your channel).
Sending limits
Open the channel from Chat channels to see Number safety: Sent today, the Gap between messages and who accepted the risk notice.
- A message sent too soon after the last one waits a moment. If it can't go out shortly, you see "This WhatsApp QR number is sending too fast" with how long to wait.
- When the daily limit is reached, new messages from the number are refused until midnight UTC.
When the number disconnects
If the phone unlinks the device, the channel shows Logged out. If WhatsApp refuses the number, it shows Blocked by WhatsApp. Workspace owners and managers get a notification either way.
- Logged out: click Rescan QR (on the Chat channels page or the channel page) and scan a new code.
- Blocked by WhatsApp: the number may be banned. Check WhatsApp on the phone. If it works again, rescan the QR. For volume, move to the WhatsApp Business API.
- The QR code expired: it wasn't scanned in time. Click Generate a new QR code.
Disconnecting
On the Chat channels page, click Disconnect on the channel. This logs the device out, so it also disappears from Linked devices on your phone. The chat history stays in the inbox, and the number no longer counts toward your plan.
Good to know
- WhatsApp QR numbers don't use templates and have no 24-hour window: you can message contacts directly. Keep it personal and low-volume.
- The same number can be connected in more than one workspace. New messages appear in each.