Connect the WhatsApp Business API
Connect a number on Meta's official WhatsApp Business Platform (Cloud API) for chats, approved templates and broadcasts.
For owners and admins
On this page
The WhatsApp Business API is Meta's official way for businesses to use WhatsApp. It's the right choice for higher volume, marketing messages and broadcasts. Customers' chats arrive in the inbox and your replies go back from your business number.
Not sure which WhatsApp to use? The other option, WhatsApp via QR code, links the WhatsApp app on your phone. It's quicker to set up but unofficial, and the number can be banned. The Business API has no such risk.
Before you start
- You need permission to manage connected accounts and to use chat channels (workspace owners and managers have both), or be an organization owner or admin.
- You need a Meta business account. A new phone number must be able to receive an SMS or voice call for verification, and must not already be registered on WhatsApp.
- Each number uses one account slot of your plan.
Start connecting
- Open Connect a channel and click Connect on the WhatsApp Business (Cloud API) tile.
- You land on Connect a messaging channel with WhatsApp Business API selected.
Then choose how to connect.
Option 1: Connect with Facebook (recommended)
If you see Connect with Facebook, this is the easiest way. Webhooks are set up for you.
- Click Continue with Facebook and sign in with the Facebook account that manages your business.
- In Meta's window, choose your business portfolio and WhatsApp Business account, then add and verify the phone number.
- When the window closes, Luminobot finishes the setup. You land on the channel's page, ready for the inbox.
Keep using the WhatsApp Business app too. If you see the box "This number already uses the WhatsApp Business app and I want to keep using it on my phone too (coexistence)", tick it before you start. The number then works both in Luminobot and in the app. Keep the app installed and open it at least every 14 days, or Meta disconnects the number from the API.
If Connect with Facebook isn't there, your Luminobot administrator hasn't turned it on yet. Use option 2.
"Facebook couldn't load"? An ad or tracking blocker may be stopping it. Allow connect.facebook.net or use option 2.
Option 2: Use your own Meta app
Choose Use my own Meta app (or just fill in the form if there's no choice). You'll find these values in the Meta developer dashboard, under your app → WhatsApp → API setup.
- Fill in:
- Access token: use a permanent System User token. Temporary tokens expire after 24 hours.
- Phone number ID.
- WABA ID: your WhatsApp Business Account ID. It's needed for templates.
- App secret: in your app, App settings → Basic → App secret. It proves incoming messages really come from Meta.
- Click Connect channel.
- You land on the channel's page at Receive messages — webhook setup. Copy the Callback URL and Verify token.
- In the Meta developer dashboard, open your app → WhatsApp → Configuration. Under Webhook, click Edit, paste the callback URL and verify token, then Verify and save.
- Under Webhook fields, subscribe to
messages.
Each number has its own callback URL and token. Meta allows only one callback URL per app, so if several numbers use the same Meta app, set any one of their URLs. Messages for every number connected with the same app secret in your organization reach the right inbox.
The 24-hour window and templates
WhatsApp lets you send free-form messages for 24 hours after the customer's last message. After that, you can only send an approved template. Templates also let you start a conversation and send broadcasts.
Create them under WhatsApp Templates in the sidebar and submit them to Meta. Meta usually reviews templates within minutes, sometimes up to a day. Approved templates show up in broadcasts. Meta can pause a template whose quality drops; a paused template can't be sent until Meta unpauses it.
Your Broadcasts and Drip Campaigns pages in the sidebar can send from this number.
Good to know
- WhatsApp's API doesn't let apps import old chats or your contact list. Contacts appear as people message you.
- You can reply with images and files from the inbox.
- To change the access token, connect the same number again with the new token. Its callback URL and verify token stay the same, so your Meta webhook setup keeps working.
- To disconnect, open Chat channels in the sidebar and click Disconnect on the channel. Its history stays, and it no longer counts toward your plan.
Troubleshooting
"Access token, phone number ID and app secret are required." All three fields are needed. The WABA ID is optional but needed for templates.
"Could not connect: …" Meta refused the token or phone number ID. Check that the token is a permanent System User token with access to this number, and that the phone number ID (not the phone number itself) is correct.
No messages arrive. Open the channel from Chat channels and check Receive messages — webhook setup. Make sure the callback URL and verify token are saved in your Meta app and that messages is subscribed. If the page says "No app secret is saved for this channel", connect the channel again and enter your app secret.
A reply fails after a day. The 24-hour window has closed. Send a template instead.