Skip to content
Tadhkir
▾
Guides

WhatsApp Setup

Connect your own WhatsApp Business number, step by step

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):


Step 1 — Get your WABA ID and Phone number ID

  1. Go to developers.facebook.com → My Apps → [your app] → WhatsApp → API Setup.
  2. 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.

  1. Go to business.facebook.com → Business Settings (the gear icon).
  2. Users → System Users → Add.
  3. Name it something like Template Bot, set role to Admin, and click Create.

Step 3 — Give the System User access to your WhatsApp Account

  1. With your new System User selected, click Assign assets.
  2. Choose WhatsApp Accounts, tick your WABA, and enable Full control.
  3. 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

  1. Still on the System User, click Generate new token.
  2. Select your app.
  3. Tick exactly these two permissions:
    • whatsapp_business_management
    • whatsapp_business_messaging
  4. Click Generate token, then copy it immediately — Meta won't show it again.

Step 5 — Paste into your dashboard

  1. Back in [Product], open Settings → Connect WhatsApp.
  2. Paste the WABA ID, Phone number ID, and Access token, then click Connect.
  3. 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.