Channel Deployment
View as Markdown
Once your bot's guidance, knowledge base, and configuration are ready, assign it to one or more messaging channels so it can assist real customers.
:::note[Required permissions]
- Connecting or disconnecting channels on a bot requires **`ai:manage`** or **`workspace:manage`**.
- Viewing and updating per-channel AI configuration requires **`nick:operate`**.
- Toggling AI on or off for an individual conversation in the Inbox requires **`inbox:reply`**.
:::
## Supported Channels
You can deploy an AI Bot to connected workspace channels, including:
- **Zalo** accounts
- **Facebook Fanpages** (Messenger)
- **WhatsApp Business** accounts
- **Website Live Chat** (connected Webchat Widgets)
:::caution[One bot per channel]
Each channel can only run one bot at a time. Assigning a channel that is already connected to another bot moves it to the current bot and automatically enables AI (`aiEnabled`) on that channel.
:::
## Method 1: Connect Channels Inside Bot Details
1. Open **My Bots → select a bot → Channels** (`/ai-bots/{botId}/channels`).
2. Click **Connect channels** (or **Connect channels now** if none are assigned yet).
3. In the **Connect channels to Bot** dialog, search by account or Fanpage name, select the channels to attach, or use **Select all** / **Deselect all**.
- Channels already assigned to another bot display a badge indicating which bot they currently run.
4. Click **Save** to apply.
## Method 2: Quick Channel Picker in My Bots
1. On **My Bots** (`/ai-bots`), locate the bot row.
2. Click the cell in the **Channels** column to open the quick picker.
3. Toggle channels on or off to connect or disconnect them immediately.
## Filter and Manage Connected Channels
The **Channels** tab displays assigned channels as cards. When at least one channel is connected, the top toolbar lets you:
- **Search** by account name.
- **Filter by status**: **Active** (`CONNECTED`), **Disconnected** (`DISCONNECTED`), **Dead** (`DIED`), and **Locked** (`LOCKED`).
To disconnect a channel, reopen **Connect channels**, uncheck the channel, and save (or uncheck it directly from the quick picker in [AI Bots Overview](/ai-bots/overview/)).
Once your bot’s guidance, knowledge base, and configuration are ready, assign it to one or more messaging channels so it can assist real customers.
Supported Channels
Section titled “Supported Channels”You can deploy an AI Bot to connected workspace channels, including:
- Zalo accounts
- Facebook Fanpages (Messenger)
- WhatsApp Business accounts
- Website Live Chat (connected Webchat Widgets)
Method 1: Connect Channels Inside Bot Details
Section titled “Method 1: Connect Channels Inside Bot Details”- Open My Bots → select a bot → Channels (
/ai-bots/{botId}/channels). - Click Connect channels (or Connect channels now if none are assigned yet).
- In the Connect channels to Bot dialog, search by account or Fanpage name, select the channels to attach, or use Select all / Deselect all.
- Channels already assigned to another bot display a badge indicating which bot they currently run.
- Click Save to apply.
Method 2: Quick Channel Picker in My Bots
Section titled “Method 2: Quick Channel Picker in My Bots”- On My Bots (
/ai-bots), locate the bot row. - Click the cell in the Channels column to open the quick picker.
- Toggle channels on or off to connect or disconnect them immediately.
Filter and Manage Connected Channels
Section titled “Filter and Manage Connected Channels”The Channels tab displays assigned channels as cards. When at least one channel is connected, the top toolbar lets you:
- Search by account name.
- Filter by status: Active (
CONNECTED), Disconnected (DISCONNECTED), Dead (DIED), and Locked (LOCKED).
To disconnect a channel, reopen Connect channels, uncheck the channel, and save (or uncheck it directly from the quick picker in AI Bots Overview).