Skip to main content
GenosOS connects to WhatsApp using @whiskeysockets/baileys, a direct WhatsApp Web implementation. Setup requires only your phone and a QR code scan.

​
Connect WhatsApp

Tell your assistant you want to connect: 
You: "Connect my WhatsApp"
The agent triggers the QR overlay in your browser. Scan it with your phone’s WhatsApp app, and the connection is established.
1

Start the connection

Tell your assistant: “Connect my WhatsApp” — the agent enables the channel and requests a login.
2

Scan the QR code

A QR code overlay appears in your browser. Open WhatsApp on your phone, go to Linked Devices, tap Link a Device, and scan the code.
3

Done

The overlay closes automatically when the scan succeeds. Your assistant is now reachable on WhatsApp.
The QR code expires after about 60 seconds. If it times out before you scan it, tell your assistant “reconnect WhatsApp” to generate a new one.

​
DM policy

The default policy is pairing — unknown senders receive a 6-digit code, and you approve each one. Change it conversationally: 
You: "Let anyone message me on WhatsApp"
You: "Only let my contacts reach me"
You: "Close WhatsApp to new messages"
The available policies:
PolicyBehavior
pairingUnknown senders get a 6-digit code. You approve via the agent.
allowlistOnly numbers you specify can message your assistant.
openAnyone can send messages (requires allowFrom: ["*"]).
disabledIgnore all incoming WhatsApp messages.
To approve a pending pairing request: 
You: "Who is waiting to connect on WhatsApp?"
You: "Approve +15551234567"

​
Security

WhatsApp is a messaging channel. The agent cannot run shell commands, execute processes, or invoke bash scripts from a WhatsApp conversation — regardless of what the message asks for. This is an architectural restriction, not a setting. What WhatsApp conversations can do: read files, search memory, send messages to other channels, use web tools, query APIs.
Never approve a pairing request from a number you don’t recognize. The pairing code is your gate — treat it like a password.

​
Troubleshooting

Session expired — QR re-scan needed WhatsApp sessions expire when you link too many devices or the session is invalidated remotely. Your assistant will notify you. Tell it “reconnect WhatsApp” to start a new QR scan. QR code appears but scan fails Make sure you’re scanning from Linked Devices in WhatsApp, not the QR code reader in your camera app. The camera app reads QR codes differently. Messages not arriving Check the DM policy: 
You: "What is the WhatsApp DM policy?"
If the policy is pairing, the sender may be waiting for approval. If it is allowlist, they may not be in the allowed list. Bot responds in DMs but not in groups Group responses are controlled by groupPolicy. By default, WhatsApp groups use an allowlist — the group must be explicitly added. Tell your assistant: “Let the assistant respond in [group name]”.