WhatsApp (QR Code)
The WhatsApp QR Code trigger connects the agent to a WhatsApp number by scanning a QR Code, using the unofficial API. It is the fastest way to try it out, but there is no SLA from Meta — the session can drop at any time and the number can be banned if used for spam.
When to use (and when not to)
Section titled “When to use (and when not to)”| Use it for | Do not use it for |
|---|---|
| Quick tests with your own number | Real customer support |
| Short demos to showcase the agent | High volume of messages |
| Prompt validation in a near-realistic environment | Anything that relies on stability |
For any production scenario, use WhatsApp Official (Cloud API).
Connecting
Section titled “Connecting”- Open the agent in the admin panel.
- Go to Triggers.
- On the WhatsApp QR Code card, click Connect.
- SquadOS generates a QR Code that expires after 2 minutes.
- On your phone, open WhatsApp → Linked devices → Link a device → point at the QR Code.
- Once WhatsApp validates it, the card shows Connected with the phone number.
If the QR expires, click Refresh QR Code to generate a new one.
How it works
Section titled “How it works”- SquadOS hosts a WhatsApp Web session behind the scenes (via Wuzapi).
- Inbound messages become conversations in SquadOS and the agent replies.
- The reply goes out as if you had typed it yourself.
The session is periodically validated in the background — if the phone’s WhatsApp disconnects (no internet, low battery, or manual logout in the app), the card flips to Disconnected.
Disconnecting
Section titled “Disconnecting”On the connected card, click Disconnect. SquadOS terminates the Wuzapi session for the agent. You can also force-close it from the phone, under Linked devices → remove the “WhatsApp Web” entry.
Limitations
Section titled “Limitations”- No SLA — WhatsApp can terminate the session without notice.
- Ban risk — improper use can get the number banned.
- No templates — you cannot proactively start conversations like with Cloud API.
- No official support — any change in WhatsApp’s protocol can break the connection.
Common issues
Section titled “Common issues”- QR Code does not scan — make sure WhatsApp on the phone is up to date. Generate a new QR using the refresh button.
- Session drops on its own — WhatsApp invalidated the session; generate a new QR and reconnect. If it happens often, switch to WhatsApp Official.
- Messages arrive but the agent does not reply — check that the agent is active and the prompt is valid. Look under Conversations for the incoming message.