arrow_backAll guides
settingsOpen WhatsApp Cloud API SetupWhatsApp Cloud API
Connect Meta WhatsApp Business for chat, templates, and campaigns.
Credentials to collect
- keyPhone Number ID
- keyWhatsApp Business Account (WABA) ID
- keyAccess Token (System User / permanent preferred)
- keyWebhook Verify Token (you choose)
- keyGraph API version (e.g. v21.0)
How to get API access
- 1Create or open an app at Meta for Developers (developers.facebook.com).
- 2Add the WhatsApp product and open API Setup.
- 3Copy Phone Number ID and create a System User token in Meta Business Manager for production.
- 4Copy your WhatsApp Business Account ID from Business Settings → Accounts → WhatsApp Accounts.
- 5In CRM, open Settings → WhatsApp Cloud API and paste Phone Number ID, WABA ID, and Access Token.
- 6Set a Verify Token in CRM, then configure Meta webhook Callback URL to https://YOUR_API_HOST/v1/whatsapp/webhook with the same verify token.
- 7Subscribe the webhook to messages. For local testing, use accessToken starting with test_ and Simulate inbound.
Frontend checklist
- check_box_outline_blankPhone Number ID + Access Token saved
- check_box_outline_blankVerify token matches Meta webhook
- check_box_outline_blankLive token does not start with test_
- check_box_outline_blankSimulate inbound works → reply in WhatsApp Chat
Frontend only needs these IDs/tokens in the settings form. Webhook URL points at the API, not the Next.js site.
Official documentationopen_in_newRelated guides