Connect a WhatsApp number
The full steps to connect your number through the official Cloud API, and what to do when connecting fails.
Two ways in — pick one before you start
The steps are the same either way. What differs is the number itself, and what comes across with it.
- Coexistence
- Your number is already on the WhatsApp Business app and you want to keep using it on your phone. Your team works the same number from the platform, and your contacts plus up to six months of chat history come with you.
- A fresh number
- A number not registered on WhatsApp or WhatsApp Business. If it was used before, delete that account first. No history comes across — you start from the first conversation after connecting.
Coexistence asks you once whether to share your contacts and chat history. Decline then and there is no importing afterwards, short of disconnecting the number and linking it again — so if you are unsure, share.
Connect your number through the Cloud API
The easiest path is the "Connect with Facebook" button (Embedded Signup) — it does everything in one window.
- Settings → Channels, choose WhatsApp Cloud API, then pick coexistence or a fresh number.
- Press "Connect with Facebook" and sign in with the company Facebook account.
- Select (or create) a WhatsApp Business account.
- Choose the number to connect.
- Confirm it with the verification code you receive.
- Add a payment method on your Meta account — messages are billed to it directly.
Manual Cloud API setup
If your Meta account is already configured and you prefer to enter the details yourself, you need three things from the Meta console:
- Phone Number ID
- From the number settings in WhatsApp Manager.
- WABA ID
- The WhatsApp Business account identifier.
- Access Token
- A permanent access token. We store it encrypted and never show it again after saving.
You also need to configure the webhook so inbound messages reach you. The URL and token are shown on the same screen.
Once you are connected
- Message your connected number from another phone and watch it land in the inbox.
- Reply from the platform and confirm the reply arrives.
- Prepare your first template before thinking about a campaign.
- Read the Acceptable Use page before any bulk sending — the most valuable ten minutes you will spend.