Connect WhatsApp Business
View as Markdown
The **WhatsApp** channel (`/{slug}/channels/whatsapp`) connects **WhatsApp Business Cloud API** (WABA) phone numbers to your workspace for unified Inbox messaging and AI Bot automation.
:::note[Required permissions]
- **View connected WhatsApp numbers**: **`nick:read:all`** (navigation item is visible with `nick:read:all`, `nick:connect`, or `nick:operate`).
- **Connect a WhatsApp number**: **`nick:connect`**.
- **Update channel settings**: **`nick:operate`**.
- **Disconnect a WhatsApp number**: **`nick:delete`**.
- **Send manual replies in Inbox**: **`inbox:reply`**.
- **Assign AI Bot & toggle AI**: **`workspace:manage`**.
:::
## Prerequisites
- A **Meta Business / WhatsApp Business Account (WABA)** with at least one registered phone number on the WhatsApp Cloud API.
- Browser **popups** enabled for the Meta OAuth sign-in window.
## Connect a WhatsApp Business Number
1. Go to **Channels → WhatsApp** (or **All Channels**), click **Add Channel**, and choose **WhatsApp**.
2. Verify the **Meta App ID** at the bottom of the dialog (loaded automatically from system config; click the App ID if you need to override it with a custom Meta App).
3. Click **Connect Now** to open the **Meta OAuth (v21.0)** popup and grant:
- `whatsapp_business_management`
- `whatsapp_business_messaging`
4. After authorization, OmnyBot retrieves the phone numbers associated with your WABA (showing the display phone number, verified name, and Phone Number ID).
5. Select the desired phone number and click **Confirm Connection**.
:::tip[Manual authorization code fallback]
If the popup cannot send the callback back to the app automatically, paste the callback URL (containing `code=...`) or the raw `code` into the manual input field in the dialog to fetch your phone numbers.
:::
## Managing WhatsApp Channels
- **Assign AI Bot & Toggle AI**: Manage directly from the channels table (`workspace:manage`).
- **Open Channel Inbox**: Click the WhatsApp channel name to open its dedicated conversation view.
- **Disconnect WhatsApp**: Open the **`⋮`** menu at the end of the row and select **Disconnect** (`nick:delete`).
:::caution[Disconnecting a WhatsApp number]
Disconnecting stops the workspace from sending and receiving messages through that WhatsApp Business number until you connect it again.
:::
## Related Guides
- [Channels Overview](/channels/overview/)
- [Connect Facebook Messenger](/channels/facebook/)
The WhatsApp channel (/{slug}/channels/whatsapp) connects WhatsApp Business Cloud API (WABA) phone numbers to your workspace for unified Inbox messaging and AI Bot automation.
Prerequisites
Section titled “Prerequisites”- A Meta Business / WhatsApp Business Account (WABA) with at least one registered phone number on the WhatsApp Cloud API.
- Browser popups enabled for the Meta OAuth sign-in window.
Connect a WhatsApp Business Number
Section titled “Connect a WhatsApp Business Number”- Go to Channels → WhatsApp (or All Channels), click Add Channel, and choose WhatsApp.
- Verify the Meta App ID at the bottom of the dialog (loaded automatically from system config; click the App ID if you need to override it with a custom Meta App).
- Click Connect Now to open the Meta OAuth (v21.0) popup and grant:
whatsapp_business_managementwhatsapp_business_messaging
- After authorization, OmnyBot retrieves the phone numbers associated with your WABA (showing the display phone number, verified name, and Phone Number ID).
- Select the desired phone number and click Confirm Connection.
Managing WhatsApp Channels
Section titled “Managing WhatsApp Channels”- Assign AI Bot & Toggle AI: Manage directly from the channels table (
workspace:manage). - Open Channel Inbox: Click the WhatsApp channel name to open its dedicated conversation view.
- Disconnect WhatsApp: Open the
⋮menu at the end of the row and select Disconnect (nick:delete).