GET https://app.chatnorris.ai/api/v2/channels
Authorization: Bearer <your_api_key>

GET https://app.chatnorris.ai/api/v2/channels
Authorization: Bearer <your_api_key>

Channels

Returns the organization’s connected channels (WhatsApp, Instagram, Telegram, Facebook Messenger and Email), from newest to oldest. Access tokens aren’t exposed — only safe identification data. The web widget isn’t included in this list: it isn’t a connected channel.

GET https://app.chatnorris.ai/api/v2/channels
Authorization: Bearer <your_api_key>

Required scope: channels:read

Response

{
  "status": "success",
  "data": {
    "channels": [
      {
        "id": "ch_abc123",
        "type": "whatsapp",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "display_phone_number": "+54 9 11 1234-5678",
          "verified_name": "Acme Corp"
        },
        "created_at": "2025-05-10T12:00:00.000Z"
      },
      {
        "id": "ch_def456",
        "type": "instagram",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "ig_username": "acmecorp",
          "page_name": "Acme Corp Official"
        },
        "created_at": "2025-08-20T09:00:00.000Z"
      },
      {
        "id": "ch_ghi789",
        "type": "telegram",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "bot_username": "acmecorp_bot",
          "bot_name": "Acme Corp"
        },
        "created_at": "2026-07-15T09:00:00.000Z"
      },
      {
        "id": "ch_jkl012",
        "type": "email",
        "status": "active",
        "chatbot_id": "bot_xyz789",
        "config_display": {
          "mailbox_address": "soporte@acme.com",
          "inbound_address": "a1b2c3d4e5@inbound.chatnorris.ai",
          "signature_text": "Acme support team"
        },
        "created_at": "2026-09-01T09:00:00.000Z"
      }
    ]
  }
}

Response fields

Field	Type	Description
`id`	string	Unique ID of the channel
`type`	string	Type: `whatsapp`, `instagram`, `telegram`, `messenger` or `email`
`status`	string	Status: `active` or `inactive`
`chatbot_id`	string	ID of the agent assigned to the channel
`config_display`	object	Public channel data (no tokens). Fields without a value are omitted
`config_display.display_phone_number`	string	Phone number (WhatsApp only)
`config_display.verified_name`	string	Verified name in Meta (WhatsApp only)
`config_display.ig_username`	string	Instagram username (Instagram only)
`config_display.page_name`	string	Facebook page name (Messenger, and Instagram channels connected with a Facebook page)
`config_display.bot_username`	string	Telegram bot username (Telegram only)
`config_display.bot_name`	string	Telegram bot name (Telegram only)
`config_display.mailbox_address`	string	Mailbox the agent handles; replies carry this address as Reply-To (Email only)
`config_display.inbound_address`	string	ChatNorris inbound address you forward the mailbox’s emails to (Email only). Treat it as private data
`config_display.signature_text`	string	Signature text added to replies (Email only)
`config_display.signature_logo_url`	string	Signature logo URL (Email only)
`created_at`	string	Connection date (ISO 8601)

Available channels depend on the plan: Telegram on all plans, WhatsApp, Instagram and Messenger from Standard, and Email on Premium only (see Connect messaging channels).