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

# Um canal não conecta

> Soluções para problemas ao conectar WhatsApp, Instagram, Messenger, Telegram ou Email ao seu agente do ChatNorris.

# Um canal não conecta

Os canais são conectados em **Meus agentes → \[seu agente] → Publicar**. Procure o canal em **Disponíveis** e clique em **Conectar**. Se algo falhar, estas são as causas mais frequentes e como resolvê-las.

> [!NOTE]
>
> Antes de continuar, verifique se o canal está incluído no seu plano. O Telegram está disponível a partir do plano Free; WhatsApp, Instagram e Messenger a partir do Standard; e o Email no Premium. Os canais que o seu plano não inclui aparecem em Publicar em **Não incluídos no seu plano**.

## Problemas gerais

> [accordion] A janela de autorização fecha sem concluir a conexão
>
> **Possíveis causas:**
>
> * O navegador bloqueou a janela pop-up.
> * Você cancelou a autorização ou a sessão expirou no meio do processo.
>
> Se você vir a mensagem *"Autorização cancelada. Se o pop-up foi bloqueado pelo navegador, habilite os pop-ups para este site e tente novamente."* (*«Autorización cancelada. Si el popup fue bloqueado por el navegador, habilita los popups para este sitio e intenta de nuevo.»*):
>
> 1. Permita as janelas pop-up para `app.chatnorris.ai` nas configurações do seu navegador.
> 2. Abra **Publicar** de novo, escolha o canal e clique em **Conectar** novamente.
> 3. Confira se você entrou no Facebook ou no Instagram com a conta certa antes de começar.

> [accordion] Erro: 'Esta conta já está conectada'
>
> A mensagem "Esta conta já está conectada" («Esta cuenta ya está conectada») indica que esse número, conta, Página ou bot já está conectado a um agente do ChatNorris (seu ou de outra organização). Cada conta só pode estar conectada a um agente por vez. Se quiser movê-la para outro agente, primeiro desconecte-a na aba **Publicar** do agente que a tem.

> [accordion] O canal aparece como 'Pausado'
>
> O canal está desligado em **Publicar**: ele não recebe nem responde mensagens até você ativá-lo de novo. Ative a chave **Ativo** do canal. Pausar um canal mantém a conexão intacta.

## WhatsApp

O WhatsApp é conectado com o botão **Conectar com Facebook**. A Meta orienta você, na mesma janela, a criar ou escolher sua conta do WhatsApp Business e seu número. Ao terminar, o ChatNorris pede um **PIN de 6 dígitos** para a verificação em duas etapas do número e você clica em **Concluir conexão**.

> [accordion] Nenhuma conta do WhatsApp Business foi encontrada
>
> Se você vir *"Nenhuma conta do WhatsApp Business vinculada a esta autorização foi encontrada"* (*«No se encontró ninguna cuenta de WhatsApp Business vinculada a esta autorización»*) ou *"A conta do WhatsApp Business ainda não tem nenhum número associado"* (*«La cuenta de WhatsApp Business no tiene ningún número asociado todavía»*), o processo da Meta não terminou de criar ou selecionar a conta e o número.
>
> 1. Clique de novo em **Conectar com Facebook** e conclua todas as etapas da janela da Meta até o fim, incluindo o número de telefone.
> 2. Verifique se a conta do Facebook com que você entra é administradora da conta do WhatsApp Business na Meta.

> [accordion] Qual PIN devo usar?
>
> Pode ser qualquer PIN novo de 6 dígitos: ele não precisa coincidir com nenhum anterior. Guarde-o, porque você vai precisar dele se algum dia tiver que registrar o número de novo.

> [accordion] Prefiro conectar com minhas próprias credenciais
>
> Se você já tem os dados do seu número no portal para desenvolvedores da Meta, clique em **Você tem o Phone Number ID e o token do portal da Meta?** → **Conectar manualmente** e informe o **Phone Number ID**, o **Access Token**, o **Número de telefone**, o **WABA ID (opcional)** e o **Nome verificado**. Você os encontra em Meta Developer Portal → Configuração da API.

## Instagram

O Instagram é conectado com o botão **Conectar com Instagram**: você entra diretamente em instagram.com e autoriza o acesso. Não é preciso vincular uma Página do Facebook.

> [accordion] O Instagram não me deixa autorizar ou a conexão falha
>
> **Possíveis causas:**
>
> * Sua conta do Instagram é **pessoal**. O ChatNorris só funciona com contas profissionais (de empresa ou de criador).
> * Você entrou com uma conta que não administra a conta do Instagram Business.
> * Você não aceitou todas as permissões.
>
> **Solução:**
>
> 1. Converta sua conta em profissional no app do Instagram (Configurações → Conta → Mudar para conta profissional).
> 2. Em instagram.com, entre com a conta que você quer conectar antes de clicar em **Conectar com Instagram**.
> 3. Na tela de autorização, aceite todas as permissões, principalmente a de gerenciar mensagens (`instagram_business_manage_messages`). Sem essa permissão, o agente não consegue ler nem responder mensagens diretas.

## Messenger

O Messenger é conectado com **Conectar com Facebook** e funciona com uma Página do Facebook.

> [accordion] Nenhuma Página do Facebook foi encontrada
>
> A mensagem *"Nenhuma Página do Facebook associada a esta conta foi encontrada"* (*«No se encontraron páginas de Facebook asociadas a esta cuenta»*) significa que a conta do Facebook com que você entrou não administra nenhuma Página, ou que você não deu acesso ao ChatNorris.
>
> 1. Verifique se a sua conta do Facebook é administradora da Página.
> 2. Conecte de novo e, quando o Facebook perguntar, selecione a Página que você quer conectar.
> 3. Se você tiver várias Páginas, escolha a certa na lista de contas encontradas e clique em **Conectar conta selecionada**.

## Telegram

O Telegram é conectado com o token de um bot. Crie um bot com o [@BotFather](https://t.me/BotFather), copie o token que ele fornece e cole em **Bot token**. Depois, clique em **Conectar Telegram**.

> [accordion] Erro: 'O token não pertence a um bot' ou 'Token ou agente inválido'
>
> As mensagens "O token não pertence a um bot" («El token no pertenece a un bot») ou "Token ou agente inválido" («Token o agente inválido») indicam que você copiou o token errado ou que ele não é o token de um bot. Volte ao @BotFather, copie o token completo (ele tem o formato `123456789:ABC...`) e cole sem espaços.

> [accordion] O bot foi validado, mas o Telegram não conseguiu registrar o webhook
>
> O canal ficou inativo porque o Telegram não aceitou a configuração. Abra o canal em **Publicar** → **Configurar** e confira o **Status do webhook**:
>
> * **Operacional** — tudo funciona.
> * **Com erros**, **Não registrado** ou **Atualizações pendentes** — clique em **Reparar** para registrar o webhook de novo e depois em **Verificar**.
>
> Se continuar falhando, desconecte o canal e conecte-o de novo com o token.

> [accordion] O bot não responde
>
> No Telegram, a pessoa precisa iniciar a conversa com o bot (por exemplo, tocando em **Iniciar**) antes que o agente possa responder. Confira também o **Status do webhook**, como explicado acima.

## Email

O canal Email não lê sua caixa de entrada do Gmail nem do Outlook: o ChatNorris fornece um **Endereço de entrada** único e você encaminha para ele os emails da **Caixa que você atende** (por exemplo, [suporte@suaempresa.com](mailto:suporte@suaempresa.com)). O assistente de conexão tem três etapas: **Caixa**, **Encaminhamento** e **Verificação**.

> [accordion] A verificação fica em 'Aguardando um email…'
>
> O ChatNorris ainda não recebeu nenhum email encaminhado. Verifique:
>
> 1. Se o filtro ou a regra encaminha para o **Endereço de entrada** exato (copie-o com o botão **Copiar**).
> 2. Se você envia o email de teste para a sua caixa **a partir de outra conta**, e não da própria caixa.
> 3. Se o email de teste está endereçado à sua caixa (no campo Para ou Cc). O ChatNorris ignora os emails que não vão para a caixa configurada.
>
> Você pode clicar em **Terminar depois** e verificar de novo na página do canal Email em Publicar, que mostra quando chegou o último email.

> [accordion] Gmail: como encaminhar apenas os emails de uma caixa
>
> Não use "Encaminhar uma cópia dos emails recebidos". Em vez disso:
>
> 1. Abra o Gmail → Configurações → Ver todas as configurações → **Encaminhamento e POP/IMAP**.
> 2. Adicione um endereço de encaminhamento com o endereço de entrada do ChatNorris (o Gmail pode pedir que você entre de novo).
> 3. Deixe **Desativar encaminhamento** selecionado.
> 4. Vá em **Filtros e endereços bloqueados** → **Criar um novo filtro** → **Para:** sua caixa (por exemplo, suporte@…) → **Criar filtro** → **Encaminhar para** o endereço do ChatNorris.

> [accordion] Outlook: use redirecionamento, não encaminhamento
>
> Crie uma regra de caixa de entrada que **redirecione** as mensagens para o endereço de entrada. Não use "encaminhar": o encaminhamento muda o remetente e quebra a conversa; o redirecionamento mantém o remetente original.

> [accordion] O agente responde spam ou newsletters
>
> Você está encaminhando a caixa inteira. Altere o encaminhamento para que ele envie apenas os emails endereçados à sua caixa (filtro no Gmail ou regra no Outlook, como explicado acima). O ChatNorris também ignora devoluções, respostas automáticas e emails de endereços "noreply".

Para mais detalhes, veja [Canal Email](https://docs.chatnorris.ai/pt/guias/canal-email.md).

## O canal parou de funcionar

> [accordion] O canal estava funcionando, mas parou de responder
>
> **Possíveis causas:**
>
> * O acesso da Meta ou do Instagram expirou ou foi revogado (por exemplo, alguém removeu o acesso do ChatNorris nas configurações da Meta ou do Instagram).
> * O canal está pausado em **Publicar**.
>
> **Solução:**
>
> 1. Vá em **Canais** no menu lateral. Se uma conexão mostrar *"A conexão parou de funcionar"* (*«La conexión dejó de funcionar»*), as credenciais expiraram ou foram revogadas.
> 2. Reconecte a conta na aba **Publicar** do agente: desconecte o canal e conecte-o de novo.
> 3. Se o canal aparecer como pausado, ative-o com a chave **Ativo**.

## Ainda não consegue conectar?

Se nenhuma das soluções acima funcionar, escreva para **[hola@chatnorris.ai](mailto:hola@chatnorris.ai)** informando:

* O canal (WhatsApp, Instagram, Messenger, Telegram ou Email).
* O erro exato que você vê (com captura de tela, se possível).
* O nome do agente e da conta que você está tentando conectar.


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