Setup guide · about 10 minutes
Connect your WhatsApp Business number to WAtelly
You'll create a small app in your own Meta account and give WAtelly a permanent key to it. Your number, templates and chats stay yours, and you can disconnect at any time.
Before you start
- You're an admin of your business in Meta Business Suite (business.facebook.com).
- Your business has a WhatsApp Business account, or you'll create one in step 2.
- If your number is with another WhatsApp provider, disconnect it there first.
- Do this on a computer, not a phone.
- 1
Create a Meta app
Where: developers.facebook.com/apps ↗
- Click Create app.
- Use case: Other → app type: Business.
- Name it, e.g. “Your business WhatsApp”, choose your business portfolio and click Create app.
No Meta developer account yet? Meta asks you to register (your phone and email) the first time. It's free.
- 2
Add WhatsApp to the app
Where: Your app's dashboard
- Find WhatsApp in “Add products to your app” and click Set up.
- Choose your WhatsApp Business account. If your number isn't in it yet, add it there (Meta sends a code by SMS or call).
Is your number with another WhatsApp provider (e.g. AiSensy, Wati, Interakt)? Disconnect it there first, otherwise both systems receive your messages.
- 3
Switch the app to Live
Where: App settings → Basic
- Fill in Privacy Policy URL (your website's privacy page) and Category, then Save changes.
- At the top, switch App mode from Development to Live.
This matters: apps left in Development mode don't receive real customer messages.
- 4
Create a system user
Where: business.facebook.com/settings → Users → System users ↗
- Click Add.
- Name: WAtelly · Role: Admin → Create system user.
A system user is a “robot” login that never expires. It lets WAtelly send messages without anyone's personal Facebook account.
- 5
Give it access to the app and your WhatsApp account
Where: The system user → Assign assets
- Apps → select your new app → turn on Manage app (Full control) → Assign assets.
- Again with WhatsApp accounts → select your account → Full control → Assign assets.
- 6
Generate a permanent access token
Where: The system user → Generate new token
- Choose your app. Token expiration: Never.
- Tick whatsapp_business_management and whatsapp_business_messaging → Generate token.
- Copy the token now: Meta shows it only once. It starts with
EAA.
Treat the token like a password. Don't email it or post it in a group chat. Paste it straight into WAtelly (step 8).
- 7
Copy the App ID and App secret
Where: Your app → App settings → Basic
- Copy the App ID (a long number).
- Next to App secret, click Show, confirm your password, and copy it (32 letters and numbers).
The App secret proves to WAtelly that incoming messages really come from Meta. It's stored encrypted.
- 8
Connect it in WAtelly
Where: WAtelly → Settings → WhatsApp numbers
- Click Connect with an access token.
- Paste the access token, App ID and App secret → Connect.
- In a few seconds your number shows as connected, with your existing templates imported.
Template charges from WhatsApp go to the payment method on your WhatsApp account (WhatsApp Manager → Payment settings). Add a card there if you haven't.
If something goes wrong
- “Meta didn't accept the App ID and App secret together”
- Copy both again from App settings → Basic. The secret must be from the same app as the ID.
- “The token is missing: whatsapp_business_…”
- Generate a new token and tick both WhatsApp permissions (step 6).
- “The token can't reach any WhatsApp account”
- Assign the WhatsApp account to the system user with Full control (step 5), then generate the token again.
- “This token was made for a different app”
- When generating the token, choose the same app whose App ID you entered.
- Connected, but customer messages don't arrive
- The app is probably still in Development mode. Switch it to Live (step 3). Also check your number isn't still connected to another provider.
- How do I disconnect later?
- Remove the number in WAtelly, or in Business settings delete the system user's token. Either one stops access immediately.
Screens are simplified drawings of Meta's pages; button names match what you'll see, but the layout may differ a little.
No account yet?
Create your free WAtelly workspace first, then connect your number.