Link WhatsApp with a QR code

Who this is for: an owner giving one agent its own WhatsApp number. You need: the agent awake, a phone with that number’s WhatsApp, and a number not linked to another WhatsApp Web.

🖐 Hands-on step

This part is done by you at the desktop app: QR codes, keys, tokens and deletions never pass through an agent or the tablet. An agent can only open the screen for you.

Steps

1. Open Settings → Accounts → WhatsApp → Add account, pick the agent, choose Unofficial — scan a QR code.

   Add account dialog with the two WhatsApp routes — agent/channels/whatsapp-qr-01-add.png

2. Press Start QR pairing. The QR is valid for two minutes.

   The QR code waiting to be scanned — agent/channels/whatsapp-qr-02-qr.png

3. On the phone: WhatsApp → Linked Devices → Link a Device → scan. The row turns connected and shows the number.

4. Choose Who can chat: Public — anyone for customers, Private — listed ids only plus the allowed numbers (country code, no +) for staff. Press Save — the agent’s gateway restarts with the new policy.

After that, every message to the number reaches the agent, which answers from it. Customer conversations show up in the panel’s Inbox tab.

Tip

Use Scan again (new phone) on the same row when the number moves to another phone. Unlink removes the session and tells the phone; if the phone still lists the device, remove it under Linked Devices.

Ask your agent

✦ Ask your agent

Things you can say to an agent in Bakulai Agent:

“connect WhatsApp to Maya”“why did Maya's WhatsApp disconnect?”

• “is Maya's WhatsApp connected?”runs directly
• “open the WhatsApp pairing dialog for Maya”runs directly
• “make Maya's WhatsApp public”asks you firstcoming soon

Limits & safety

• The QR route is unofficial — Meta may block the number. One number = one agent.
• The session file stays on your computer; the tablet and the agents never see it.
• The agent replies to anyone in a Public channel: give it a role brief that says what it may promise.

Troubleshooting

• “Strangers currently receive a pairing code…” — press Save once more; the row was created with an old policy.
• QR expired — press Start QR pairing again.
• Connected, but no replies — the agent is asleep (wake it) or the number is Private and the sender is not listed.
• Two agents, one number — the second scan disconnects the first. Use a second number, or One number per room.

Related

Who can chat · One number per room · Channels overview