Connect a personal or business WhatsApp number by scanning a QR code — no Meta Business approval required for personal use.
Connect a WhatsApp account
Step 1 — Create a session
POST /v1/channels/whatsapp/session
Authorization: Bearer eyJ...
Content-Type: application/json
{
"name": "Main WhatsApp"
}
Response
{
"sessionId": "sess_01j...",
"status": "pending"
}
Step 2 — Get QR code
Poll this endpoint until status is ready, then display the QR to the user:
GET /v1/channels/whatsapp/session/:sessionId/qr
Authorization: Bearer eyJ...
{
"qr": "data:image/png;base64,...",
"status": "ready"
}
Step 3 — Scan with WhatsApp
Open WhatsApp on your phone → Linked Devices → Link a Device → scan the QR.
After scanning, the account status transitions to connected and the session becomes a permanent channel account.
Sending WhatsApp messages
See Send Text → and Send Media → using channel = whatsapp.
Phone number format
Use international format including the country code: +905551234567, +12125551234.
Limitations
- One QR scan = one linked device slot in WhatsApp
- Personal numbers have WhatsApp's own rate limits (~1000 msgs/day for non-API)
- Media file must be publicly reachable via HTTPS