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

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

Canais

Retorna os canais conectados (WhatsApp, Instagram, Telegram, Facebook Messenger e Email) da organização, do mais recente ao mais antigo. Os tokens de acesso não são expostos — apenas dados de identificação seguros. O widget web não aparece nesta lista: ele não é um canal conectado.

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

Escopo necessário: channels:read

Resposta

{
  "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 Oficial"
        },
        "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": "suporte@acme.com",
          "inbound_address": "a1b2c3d4e5@inbound.chatnorris.ai",
          "signature_text": "Equipe de suporte da Acme"
        },
        "created_at": "2026-09-01T09:00:00.000Z"
      }
    ]
  }
}

Campos da resposta

Campo	Tipo	Descrição
`id`	string	ID único do canal
`type`	string	Tipo: `whatsapp`, `instagram`, `telegram`, `messenger` ou `email`
`status`	string	Status: `active` ou `inactive`
`chatbot_id`	string	ID do agente atribuído ao canal
`config_display`	object	Dados públicos do canal (sem tokens). Os campos sem valor são omitidos
`config_display.display_phone_number`	string	Número de telefone (apenas WhatsApp)
`config_display.verified_name`	string	Nome verificado na Meta (apenas WhatsApp)
`config_display.ig_username`	string	Usuário do Instagram (apenas Instagram)
`config_display.page_name`	string	Nome da página do Facebook (Messenger e canais de Instagram conectados com uma página do Facebook)
`config_display.bot_username`	string	Usuário do bot do Telegram (apenas Telegram)
`config_display.bot_name`	string	Nome do bot do Telegram (apenas Telegram)
`config_display.mailbox_address`	string	Caixa de entrada que o agente atende; as respostas levam este endereço como Reply-To (apenas Email)
`config_display.inbound_address`	string	Endereço de entrada do ChatNorris para o qual você reencaminha os emails da caixa de entrada (apenas Email). Trate-o como um dado privado
`config_display.signature_text`	string	Texto da assinatura adicionada às respostas (apenas Email)
`config_display.signature_logo_url`	string	URL do logo da assinatura (apenas Email)
`created_at`	string	Data da conexão (ISO 8601)

Os canais disponíveis dependem do plano: Telegram em todos os planos; WhatsApp, Instagram e Messenger a partir do Standard; e Email apenas no Premium (veja Conectar canais de mensagens).