Setting Up WhatsApp

A step-by-step guide to connecting a WhatsApp number to Notifo.

Prerequisites

• A Notifo account (free trial or paid plan)
• A smartphone with WhatsApp installed

Step 1 — Open Channels in the dashboard

Log in to app.notifo.cloud and click Channels in the left sidebar.

Step 2 — Create a new session

Click Connect WhatsApp and enter a name for this account (e.g. "Support", "Marketing").

Notifo calls POST /v1/channels/whatsapp/session and returns a sessionId.

Step 3 — Scan the QR code

The dashboard polls GET /v1/channels/whatsapp/session/:sessionId/qr and displays the QR once ready.

On your phone:

1. Open WhatsApp
2. Tap the three-dot menu (Android) or Settings (iOS)
3. Tap Linked Devices → Link a Device
4. Point your camera at the QR code

Step 4 — Confirm connection

After scanning, the status transitions to connected. The channel account is now ready.

Step 5 — Send a test message

In the dashboard, click the channel → Send test message. Or via API:

curl -X POST https://api.notifo.cloud/v1/channels/accounts/ACC_ID/test \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"to": "+905551234567", "text": "Connection test"}'

Troubleshooting

Problem	Solution
QR not loading	Refresh the page and generate a new session
Status stuck at pending	QR codes expire after ~60s; generate a new one
Status shows disconnected	Re-scan the QR; WhatsApp sessions expire if inactive
Messages fail to send	Check account status; re-connect if disconnected or error