Connecting a number is a two-way handshake. You give Customer Pro four values from Meta so it can send; you give Meta a callback URL so it can deliver inbound messages back to you. Miss the second half and you will be able to send but never receive.
Getting the four credentials from Meta #
-
Open your app in Meta for Developers
Go to developers.facebook.com, open your app, and pick WhatsApp → API Setup. -
Copy the phone number ID and WABA ID
Both are shown on the API Setup screen. The phone number ID identifies the sending number; the WABA ID identifies the business account that owns it. They are different numbers — swapping them is the single most common cause of a connection that validates but never sends. -
Create a system user token
In Meta Business Settings → Users → System Users, add a system user with admin access to your WABA, then generate a token with thewhatsapp_business_messagingandwhatsapp_business_managementpermissions. Choose a token that does not expire, or plan to rotate it. -
Note the display phone number
The number in international format, e.g.+91 93590 23913. This is cosmetic — routing uses the phone number ID.
Connecting it here #
-
Open Settings → WhatsApp Accounts
Fill in the four values in the Connect a number card and press Connect. -
Press Validate
This calls Meta with your token and reports back whether it is accepted. A token showing valid means sending will work. -
Copy the callback URL and verify token
Both appear on the connected account's card, under Webhook setup. Each connected number gets its own verify token. -
Paste them into Meta
In your Meta app, go to WhatsApp → Configuration → Webhook, paste the callback URL and verify token, and click Verify and Save. Then subscribe to themessagesfield — without that subscription Meta never sends you anything. -
Send yourself a message
Message the number from your own phone. It should appear in the Inbox within a second or two.
Field reference #
| Field | What it does |
|---|---|
| Phone number required | The sending number in international format. Display only. |
| Display name required | What your team sees in account pickers. Not shown to customers — Meta controls the name customers see. |
| WABA ID required | Your WhatsApp Business Account ID. Used for template sync and management calls. |
| Phone number ID required | Meta's ID for this specific number. Every outbound message is sent through it. |
| System user access token required | The credential used to authenticate to Meta. Stored encrypted and never shown again in full. |
| Catalog ID | Only needed if you sell through the product catalog. Can be added later. |
| Default account | The number used when a send does not name one. With several numbers connected, set this deliberately. |
Where to go next #
Send your first message
The 24-hour window, why the first message must be a template, and how to test end to end.
WhatsApp accounts
Every connected number, its token health, its webhook, and which one is the default sender.
Inbox
Every WhatsApp conversation in one list, with search, case-type filters and an archive.
Outbound webhooks
Signed event POSTs to your endpoint whenever something happens in your workspace.