Use this when the native WhatsApp channel needs to be re-linked to your phone.
The code generated below replaces scanning a QR — you enter it in
WhatsApp → Settings → Linked Devices → Link a Device → Link with phone number.
WhatsApp number
Loading…
…
Save as the WhatsApp number for this workspace?
The currently paired session is unaffected until you click Generate pairing code again.
WHATSAPP_PHONE_NUMBER is not set in your agent's .env.
Type a number above (E.164 format, e.g. +2348136227627) and click Save.
Allowed contacts (optional)
Numbers this agent will chat with once paired. Leave blank to default to the WhatsApp number above (self-chat). On a successful pair, the channel is turned ON automatically.
Releasing channel and requesting code…
––––-––––
On your phone:
Open WhatsApp → Settings → Linked Devices
Tap Link a Device → Link with phone number instead
Enter the code above. Hyphens are for readability — type the 8 letters/digits.
Waiting for WhatsApp to confirm pairing…
✓ Paired successfully as .
The native WhatsApp channel will reconnect within ~30 seconds.
Restart gateway
Use this when the WhatsApp listener has dropped (sends fail with
"No active WhatsApp Web listener") but credentials are still valid.
A restart re-attaches to the existing creds without wiping anything.