Connect your WhatsApp number — manual setup
Who this is for: you're bringing your own WhatsApp Business Account (WABA) so we can submit and track message templates on it. One-time setup, ~10 minutes.
What you'll paste into us (3 values)
| Value | Looks like |
|---|---|
| WhatsApp Business Account ID (WABA ID) | a long number, e.g. 1029384756... |
| Phone number ID | a long number (≠ your actual phone number) |
| Access token (permanent) | a long string starting EAA... |
Before you start
You'll need these already set up (you have them if you already send on WhatsApp):
- A Meta Business Portfolio (Business Manager) — business.facebook.com
- A WhatsApp Business Account with at least one verified phone number added
- A Meta app with the WhatsApp product added — developers.facebook.com
Step 1 — Get your WABA ID and Phone number ID
- Go to developers.facebook.com → My Apps → [your app] → WhatsApp → API Setup.
- On that page, copy the Phone number ID (shown under the "From" number) and the WhatsApp Business Account ID.
The Phone number ID is not your phone number — it's a numeric ID beneath it.
Step 2 — Create a System User (for a token that never expires)
Personal tokens die after ~24 hours. A System User token stays valid until you revoke it — use this.
- Go to business.facebook.com → Business Settings (the gear icon).
- Users → System Users → Add.
- Name it something like
Template Bot, set role to Admin, and click Create.
Step 3 — Give the System User access to your WhatsApp Account
- With your new System User selected, click Assign assets.
- Choose WhatsApp Accounts, tick your WABA, and enable Full control.
- Save changes.
Skipping this is the #1 cause of a "permissions" error later — the token works but can't see your WABA.
Step 4 — Generate the token
- Still on the System User, click Generate new token.
- Select your app.
- Tick exactly these two permissions:
whatsapp_business_managementwhatsapp_business_messaging
- Click Generate token, then copy it immediately — Meta won't show it again.
Step 5 — Paste into your dashboard
- Back in [Product], open Settings → Connect WhatsApp.
- Paste the WABA ID, Phone number ID, and Access token, then click Connect.
- We instantly verify it — a green "Connected — N templates found" means you're done.
Troubleshooting
| Message | Fix |
|---|---|
| Invalid token / error 190 | Token expired or mistyped — regenerate a System User token (Step 4), not a personal one. |
| (#200) permission error | The two scopes weren't ticked (Step 4), or the WABA isn't assigned to the System User (Step 3). |
| Object does not exist / wrong ID | You likely swapped WABA ID and Phone number ID — they're different numbers. |
| Token vanished before I copied it | Normal — regenerate and copy immediately. |
Your token, your control
Your access token is encrypted at rest and used only to submit and track templates on your WABA. You can revoke it anytime in Business Settings → System Users → [your user] → remove token.