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

# O agente não responde

> O que fazer quando o agente não está respondendo ou dá respostas incorretas.

# O agente não responde

Se o seu agente não está respondendo aos visitantes ou está dando respostas incorretas, siga estes passos para diagnosticar o problema.

## O bot não responde no widget

> [accordion] O widget não aparece no meu site
>
> **Possíveis causas:**
>
> * O agente está com o status **Rascunho** (o widget não está publicado).
> * O snippet não está instalado corretamente no HTML, ou está no lugar errado.
> * A visibilidade do widget o oculta: ele está em **Privado**, fora do **Horário de visibilidade**, ou a página está em **Ocultar em páginas específicas**.
> * O seu domínio não está na lista de domínios permitidos do agente.
>
> **Solução:**
>
> 1. Vá para `Agentes → [seu agente] → Publicar` e verifique se o widget (Site) está publicado. O cabeçalho do agente mostra **Publicado** ou **Rascunho**.
> 2. Verifique se o snippet está colado **antes do fechamento de `</body>`** no seu HTML.
> 3. Revise `Personalizar → Visibilidade` (status **Público**, horário e páginas ocultas) e `Configurações → Segurança` (domínios permitidos).
> 4. Limpe o cache do seu navegador e recarregue a página.
>
> ![TODO: captura do detalhe do agente mostrando o selo de status Publicado](https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-chatbot-estado-publicado.png)

> [accordion] O widget aparece, mas não responde ao enviar mensagens
>
> **Possíveis causas:**
>
> * A sua organização atingiu o limite de créditos de IA do mês.
> * **Apenas no WhatsApp:** a Meta parou de entregar as respostas porque a conta do WhatsApp Business não tem uma forma de pagamento e as 1.000 respostas gratuitas do mês foram ultrapassadas. O agente responde, mas a mensagem não chega.
> * O agente atingiu o próprio limite mensal de créditos (`Configurações → Limites` do agente).
> * O agente não tem base de conhecimento (ele pode responder mesmo assim, mas verifique se está configurado corretamente).
>
> **Solução:**
>
> 1. Vá para **Faturamento e uso → Uso** e verifique se você atingiu o limite de créditos de IA do mês. Revise também `Configurações → Limites` do agente.
> 2. Se você ultrapassou o limite, aguarde o início do próximo mês, adicione o add-on de créditos extras ou mude para um plano superior — veja [Limite de créditos atingido](https://docs.chatnorris.ai/pt/solucion-de-problemas/limite-mensajes-alcanzado.md).
> 3. Se o limite não foi ultrapassado, tente em outro navegador ou dispositivo para descartar problemas de cache.

> [accordion] O bot responde, mas diz que não tem informações
>
> Isso é normal quando a base de conhecimento não tem conteúdo sobre o tema perguntado.
>
> **Solução:**
>
> 1. Vá para a **Base de conhecimento** do agente.
> 2. Adicione conteúdo relevante sobre o tema da pergunta (uma página web, um documento, texto ou perguntas frequentes).
> 3. Aguarde o status mudar para **Pronto**.
> 4. Teste a mesma pergunta no **Playground** do agente.

## O bot não responde no WhatsApp, Instagram ou outro canal

> [accordion] O canal está ativo, mas o bot não responde
>
> **Possíveis causas:**
>
> * O canal foi pausado.
> * A conexão parou de funcionar (por exemplo, o acesso à Meta expirou ou foi revogado).
> * A conversa está sendo atendida por uma pessoa (modo **Aguardando agente** ou **Humano**): nesse caso, o bot não responde.
> * A sua organização atingiu o limite de créditos de IA do mês.
>
> **Solução:**
>
> 1. Vá para **Canais** no menu lateral: o canal não deve aparecer como **Pausado** nem **Requer atenção**. Para reativá-lo, ligue o interruptor **Ativo** em `Agentes → [seu agente] → Publicar`.
> 2. Verifique em **Conversas** se a conversa está aguardando uma pessoa ou se alguém da equipe a está atendendo.
> 3. Se o canal estiver com **Requer atenção**, desconecte-o e conecte-o novamente em `Agentes → [seu agente] → Publicar`.
> 4. No Telegram, lembre-se de que a pessoa precisa iniciar a conversa com o bot.
> 5. No WhatsApp, verifique a coluna **Não entregues** do card **WhatsApp (cobranças da Meta)** em **Faturamento e uso → Uso**. Se o motivo for **Falta forma de pagamento na Meta** («Falta método de pago en Meta»), adicione uma no Meta Business Suite → Faturamento. Veja [Custos da Meta no WhatsApp](https://docs.chatnorris.ai/pt/guias/canales-whatsapp-instagram.md#custos-da-meta-no-whatsapp).

> [accordion] O bot não aparece como contato no WhatsApp
>
> O bot não é um contato da sua lista — é o número do WhatsApp Business que você conectou. Quando alguém escreve para esse número, o bot responde automaticamente.
>
> Verifique se você está escrevendo para o número exato que aparece na seção **Canais** do portal ou em Publicar do agente.

## As respostas do bot são incorretas ou imprecisas

> [accordion] O bot inventa informações que não estão na minha base de conhecimento
>
> Isso pode acontecer se o prompt do sistema não especificar claramente que o bot deve se limitar ao conteúdo da base de conhecimento.
>
> **Solução:** Em `Agentes → [seu agente] → Configurações → IA`, ative **Limitar respostas à base de conhecimento**. Você também pode reforçar isso no prompt do sistema com uma instrução como: *"Responda apenas com as informações da sua base de conhecimento. Se você não tiver a resposta, diga isso claramente e sugira entrar em contato com o suporte."*

> [accordion] O bot dá respostas muito longas ou muito curtas
>
> Ajuste o parâmetro **Max tokens** em `Configurações → IA` do agente:
>
> * Para respostas mais curtas e diretas: reduza os tokens (ex.: 256).
> * Para respostas mais completas: aumente os tokens (ex.: 1024).
>
> Você também pode indicar isso no prompt: *"Responda de forma concisa, em no máximo 3 frases."*

> [accordion] O bot não responde no idioma correto
>
> Especifique o idioma no prompt do sistema: *"Responda sempre em espanhol, independentemente do idioma em que escreverem para você."*

> [accordion] O bot não usa o tom de voz que eu quero
>
> O tom é definido no prompt do sistema. Seja específico:
>
> * *"Use um tom formal e profissional."*
> * *"Seja amigável e trate o cliente por você."*
> * *"Responda de forma direta e sem rodeios."*

## Ainda não consigo resolver o problema

Se nenhuma das soluções anteriores funcionou, escreva para **[hola@chatnorris.ai](mailto:hola@chatnorris.ai)** com os seguintes dados:

* Nome do agente.
* Descrição do problema.
* Canal onde ocorre (web, WhatsApp, Instagram, Telegram, Messenger ou Email).
* Capturas de tela, se você tiver.


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