WhatsApp integration
Connect a WhatsApp Business number via Meta Embedded Signup. Capture phone/WABA IDs, subscribe webhooks, register the number, and manage disconnects.
- Facebook App configured with WhatsApp access.
- WhatsApp Embedded Signup config ID set in env.
- Meta requires a payment method on the WhatsApp Business account for production messaging.
- Open a bot workspace → WhatsApp tab.
- Click Launch Embedded Signup.
- Meta popup: choose Business Account and phone number (or create one).
- Stay in the popup and click “View your setup guide” so Meta returns the verification code.
- Raian captures phone_number_id, waba_id, subscribes webhook, registers the phone, and stores the PIN.
- Status card shows phone_number_id, business_account_id, display number, webhook subscription, and registration timestamps.
- Two-step PIN is stored; keep it safe if you need to re-verify in WhatsApp Manager.
- If a PIN already exists, we reuse it and warn you after registration.
- Use Disconnect WhatsApp to deregister the phone and unsubscribe the webhook.
- We clear stored credentials; warnings appear if Meta can’t deregister automatically.
- Popup blocked: allow popups and retry.
- Token expired: reconnect to refresh access token.
- Meta errors: verify business permissions and billing setup in WhatsApp Manager.
Next up
Monitor logs and jobs to debug messages and imports.