Connect a WhatsApp number
Connect a WhatsApp Business number to OmniDimension with your WhatsApp Business account ID and a permanent Meta access token, then register it and pick the numbers to import.
Paste two values from Meta, pick your numbers, and they're connected.
Before you start
Have your WhatsApp Business account ID and a permanent Meta access token ready. Get your Meta credentials shows how.
Open the connect dialog
Go to WhatsApp Numbers
In the sidebar, open WhatsApp Numbers and click Add number (or pick an option straight away if none is connected yet).
Choose WhatsApp Business
Click WhatsApp Business (recommended). The Connect WhatsApp Business dialog opens.
Other options in Add number:
| Option | Use it when |
|---|---|
| Quick test with your phone | You want to try the agent in minutes. Expires after 48 hours. See Quick test. |
| Import from Twilio | Your number is on Twilio. Enter your Account SID and Auth Token. |
| Import from Interakt | Your number is on Interakt. Enter your API key, then paste the two webhook URLs it shows into Interakt. |
Some settings (welcome prompts, QR codes, blocked contacts, Receive messages) only work on WhatsApp Business numbers.
Connect with your Meta credentials
Paste the two values
Fill in WhatsApp Business account ID and Meta access token, then click Connect.
Choose the numbers to connect
If the account has more than one number, tick the ones you want and click Connect selected. Each shows a status:
| Status | Meaning |
|---|---|
| Ready to send | The number can send now. |
| Limited or Can't send | Meta is limiting or blocking this number. The reason is shown next to it. |
| Can't send · register after import | Connect it, then register it. |
| Migrate to Cloud API first | It's still in the WhatsApp Business app. Move it first. |
| Already connected | Connecting again updates its token. |
Read the result
You see Connected and a health check:
- This number is ready to send. Nothing else to do.
- A few things to fix before sending. Each issue is listed with its fix.
- We couldn't check this number's health right now. It's connected; check later from the number card.
Your approved templates are copied in automatically.
Set up Receive messages
Click Receive messages so customer messages reach your agent, or do it later. Then click Done. See Receive messages.
If it fails, you see Couldn't connect this account with the reason and how to fix it. See If your token is refused.
Register a number
A number that was verified but never registered can't send yet.
- Open the health check (the heart button on the number card).
- Enter a 6-digit PIN and click Register.
- You see Registered. This number can send now.
The PIN becomes the number's two-step verification PIN. If it already has one, enter that. Save it somewhere safe.
Move a number off the WhatsApp Business app
A number still in the WhatsApp Business app shows On Business app on its card. Click it, then Move to Cloud API:
- 1
Delete the WhatsApp account on the phone
In the WhatsApp Business app: Settings → Account → Delete account. This erases the app’s chat history for the number. - 2
Get a code
Choose Text message or Voice call. Meta sends a 6-digit code to the number. - 3
Enter the 6-digit code
Proves you own the number. - 4
Set a 6-digit PIN
The number’s new two-step verification PIN. - 5
All set
The number now sends and receives through OmniDimension.
Your step Done for you
If it fails with 2388001, the account on the phone still exists. Delete it, wait 3 minutes, and try again.
What the number card shows
- Activity line. Conversations and reply rate for the last 30 days. Click it for Insights. Needs attention means messages are failing.
- Not receiving messages · Set up. Shown until Receive messages is set up.
- On Business app. See Move a number off the WhatsApp Business app.
- Answered by. The agent that replies on this number. See Agent replies.
- Open chats. Opens the chat inbox for this number.
- Templates. Opens this number's templates.
- Status (heart icon). A live check with Meta: whether the number can send, and how to fix any issue.
- Settings (gear icon). Opens Number settings.
- More (three dots). Delete removes the number from OmniDimension; it stays in Meta.
Reconnect a number
If the token stops working, the card shows Reconnect number. Click it, paste a new permanent token, and click Reconnect.
Common errors
Token problems are covered in If your token is refused. Others:
| What you see | What to do |
|---|---|
| No phone numbers found on this WhatsApp Business Account | Add a number in Meta first (step 3). |
| The number is connected in another workspace | A number can only be in one workspace. Delete it there first. |
| Couldn't authorize this number | Meta no longer accepts the token. Generate a new one and reconnect. |
All codes: WhatsApp error codes.
Was this page helpful?