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

# Canais

> Listar os canais de WhatsApp, Instagram, Telegram, Messenger e Email conectados à sua organização.

# 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.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/channels
Authorization: Bearer <sua_api_key>
```

**Escopo necessário:** `channels:read`

***

## Resposta

```json theme={null}
{
  "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) |

> [!NOTE]
>
> 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](https://docs.chatnorris.ai/pt/guias/canales-whatsapp-instagram.md)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.