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
Related: 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).