Problemas Comuns
A Dani não está respondendo
Siga este checklist em ordem:
O agente está ativo? Acesse Agentes IA, verifique se o card do agente tem o badge verde "Ativo". Se mostrar "Inativo", abra o agente, ative o toggle na aba Identidade e salve.
A fila está vinculada ao agente? Acesse Filas, edite a fila que recebe os tickets e verifique se o campo "Agente IA / Dani" está preenchido com o agente correto.
O plano tem IA habilitada? Se ao acessar o menu "Agentes IA" aparecer mensagem de sem permissão, o plano não tem IA. Entre em contato com o suporte.
A chave de API está configurada? Acesse Configurações → Integrações → IA e verifique se a chave de API está preenchida e válida.
O ticket chegou antes do agente ser vinculado? Tickets existentes não são retroativamente processados. Crie um novo ticket de teste para verificar.
A Dani demora para responder
O delay de resposta pode ter diversas causas:
| Causa | Como verificar | Solução |
|---|---|---|
| Delay configurado intencionalmente | Aba Avançado → campo "Delay de resposta" | Reduza o valor (mínimo 0) |
| Modelo lento | Aba Identidade → campo "Modelo de IA" | Troque para GPT-4o Mini ou Claude Haiku |
| Base de conhecimento muito grande | Aba Base de conhecimento | Desative itens desnecessários |
| Max tokens alto | Aba Avançado → Max tokens | Reduza para 1.000 se as respostas não precisam ser longas |
| API do provedor sobrecarregada | Nenhuma forma direta de verificar | Aguarde ou troque o modelo |
| Ferramenta HTTP com timeout alto | Aba Ferramentas → config do tool | Reduza timeoutMs ou otimize a API externa |
| Buffer de mensagens ativo | Aba Qualificação SDR → Buffer de mensagens | Reduza ou zere o valor |
TIP
Para atendimentos em volume alto onde velocidade importa, use GPT-4.1 Nano ou GPT-4o Mini com Max tokens de 800 a 1.200. A resposta chega em 1-3 segundos na maioria dos casos.
A Dani está respondendo errado ou inventando informações
Sintoma: A Dani diz coisas que não estão no prompt nem na base de conhecimento, ou mistura informações.
Causas e soluções:
Prompt muito vago ou curto: Adicione mais contexto e restrições no campo Personalidade. Inclua exemplos do que é correto e do que é incorreto.
Temperatura muito alta: Reduza a temperatura na aba Avançado (tente 0,5 a 0,7).
Base de conhecimento com dados conflitantes: Revise os itens e desative os desatualizados.
Max mensagens alto demais: Se o histórico tem conversas antigas com informações erradas, reduza o "Max mensagens" para 5 ou menos.
Prompt não está salvo: Certifique-se de clicar em "Salvar" após editar. A Dani usa sempre a versão salva.
A Dani ignora a base de conhecimento
- Verifique se os itens da base estão com o toggle ativo (sem opacidade reduzida)
- Verifique se o agente foi salvo após os itens serem adicionados (a base é associada ao agente salvo)
- Adicione no prompt principal uma instrução explícita: "Consulte sempre a base de conhecimento antes de responder perguntas sobre preços, produtos ou políticas."
- Se o item for uma URL, verifique se a URL é acessível publicamente (sem login)
A transferência para humano não está funcionando
A Dani diz que vai transferir mas o ticket continua com a IA: O modelo escreveu a mensagem mas não invocou a ferramenta de transferência. Adicione no prompt:
Ao decidir transferir, use SEMPRE a ferramenta transferir_humano.
Não envie nenhuma mensagem antes de acionar a ferramenta.As palavras-chave não acionam a transferência: Verifique se as palavras estão exatamente como cadastradas (sem espaços extras) e tente expandir a lista com variações.
O ticket transferido não aparece para os atendentes: A fila de destino não tem atendentes atribuídos ou os atendentes estão offline. Verifique em Usuários quais atendentes estão vinculados à fila.
O agente está respondendo em outro idioma
- Na aba Identidade, verifique se o chip do idioma correto está selecionado (destaque em azul)
- Adicione no prompt: "Responda sempre em português brasileiro, independente do idioma da pergunta."
- Se usar o chip "Auto", o agente vai detectar o idioma do cliente — remova se quiser forçar português
A Dani não agenda corretamente
- Verifique se o agendamento está ativo na aba Agendamento (toggle "Ativar agendamento")
- Confirme se há tipos de serviço cadastrados em Agenda → Serviços
- Verifique se os serviços estão selecionados no campo "Serviços que este agente pode marcar"
- Adicione no prompt instruções explícitas sobre quando usar a ferramenta
agendar - Teste com a ferramenta de chat na aba Testar antes de colocar em produção
O upload de arquivo na base de conhecimento falhou
- Verifique se o arquivo está dentro dos formatos aceitos:
.pdf,.doc,.docx,.txt,.mp3,.wav,.mp4,.avi,.mov - Arquivos corrompidos ou protegidos por senha não são processados
- Aguarde alguns segundos e recarregue a aba — o processamento pode ser assíncrono
- Para PDFs com muitas imagens e pouco texto, o conteúdo extraído pode ser mínimo. Prefira versões em texto ou adicione manualmente o conteúdo relevante como "Texto"
Erros que aparecem na tela
| Mensagem | Causa | Solução |
|---|---|---|
| "Setor obrigatório" ao salvar | Toggle de transferência ativo sem fila selecionada | Selecione uma fila na aba Comportamento ou desative o toggle |
| "Preencha nome e conteúdo" na base de conhecimento | Campos obrigatórios vazios | Preencha nome e conteúdo do item |
| "Nome é obrigatório" na ferramenta | Campo nome vazio | Preencha o nome em snake_case |
| "URL é obrigatória para tools HTTP" | URL não preenchida | Informe a URL completa da API |
| "JSON inválido" em headers/paramsSchema | Erro de sintaxe no JSON | Use um validador online de JSON para verificar a estrutura |
| "Salve o prompt primeiro" | Tentou criar ferramenta ou base de conhecimento antes de salvar o agente | Salve o agente primeiro |