Agent Channels

Register channel

Register a new external messaging channel (Telegram, WhatsApp, Discord) for an agent. Human-only. Returns the channel with its webhook URL.

post/v1/agents/{agent_id}/channels

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/channels
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Request body

channel_type'telegram' | 'whatsapp' | 'discord' required
channel_namestring
configobject required

Platform-specific config. Telegram: { bot_token }. WhatsApp: { phone_number_id, access_token, verify_token }. Discord: { bot_token, application_id }.

slash_commands_enabledboolean

Enable Hermes-compatible slash commands on this channel. When true, messages starting with / are handled before the LLM. Commands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry, /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.

voice_transcription_enabledboolean

Enable voice message transcription

sender_allowliststring[]

List of allowed sender IDs

auto_respond_enabledboolean

Enable auto-respond

Response

Channel created

idstring uuid
org_idstring uuid
agent_idstring uuid
channel_type'telegram' | 'whatsapp' | 'discord'
channel_namestring
webhook_pathstring
webhook_urlstring
is_activeboolean
configobject nullable

Channel-specific configuration JSON. May include:

  • sender_allowlist (array of strings): restrict which external senders can trigger the agent
  • auto_respond_enabled (boolean): whether the agent auto-responds to inbound messages
slash_commands_enabledboolean

Whether Hermes-compatible slash commands are enabled for this channel. Commands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry, /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.

voice_transcription_enabledboolean

Whether voice message transcription is enabled

unified_conversation_idstring uuid nullable

ID linking this channel to a unified cross-platform conversation

is_home_platformboolean

Whether this is the agent's home platform channel

sender_allowliststring[] nullable

List of allowed sender IDs for auto-respond

auto_respond_enabledboolean

Whether auto-respond is enabled for this channel

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.