> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# im_channels

> Inbound/outbound instant-messaging channels (Telegram, WhatsApp, Discord, …) the agent is connected to.

# `im_channels` — IM channels

Inbound/outbound instant-messaging channels (Telegram, WhatsApp, Discord, …) the agent is connected to.

**Section key** `im_channels` · **Shape** object · **Tier** All plans\
**Edit in the dashboard:** [IM channels page](/sidebar-menu/im-channels)\
**Related:** [Human handoff](/sidebar-menu/human-handoff)

## Fields

| Field      | Required | Type            | Allowed values / constraints | Default | Description                                             |
| ---------- | -------- | --------------- | ---------------------------- | ------- | ------------------------------------------------------- |
| `channels` | no       | array of object | —                            | —       | Ordered list of IM channel bindings. Item fields below. |

### `channels` items

Ordered list of IM channel bindings.

| Field               | Required | Type    | Allowed values / constraints                                                                | Default | Description                                                                                    |
| ------------------- | -------- | ------- | ------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------- |
| `id`                | no       | integer | —                                                                                           | —       | Auto-assigned channel ID (read-only).                                                          |
| `channel_kind`      | **yes**  | enum    | one of `telegram`, `whatsapp`, `discord`, `slack`, `facebook`, `instagram`, `line`, `viber` | —       | The messaging platform this channel connects to.                                               |
| `label`             | no       | string  | —                                                                                           | —       | Optional human-readable name for this binding (alphanumeric, \_ and - only, max 100 chars).    |
| `enabled`           | no       | boolean | —                                                                                           | —       | Whether this channel is actively routing messages.                                             |
| `allowlist_enabled` | no       | boolean | —                                                                                           | —       | If true, only senders in the allowlist can message the agent.                                  |
| `allowlist`         | no       | string  | —                                                                                           | —       | Newline-separated list of allowed sender IDs/usernames (used when allowlist\_enabled is true). |
| `context`           | no       | string  | —                                                                                           | —       | Optional extra context injected into the system prompt for conversations from this channel.    |
| `notes`             | no       | string  | —                                                                                           | —       | Private notes about this channel (not shown to power users).                                   |