Saltar para o conteúdo principal

​
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

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
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.
  3. Se o limite não foi ultrapassado, tente em outro navegador ou dispositivo para descartar problemas de cache.
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

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

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.”
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.”
Especifique o idioma no prompt do sistema: “Responda sempre em espanhol, independentemente do idioma em que escreverem para você.”
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 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.