# Connect WhatsApp Business

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