Os agentes de IA da ZapiCRM foram desenvolvidos para proporcionar conversas mais eficientes e agradáveis com seus clientes. No entanto, podem ocorrer falhas — e este guia ajuda a resolver os problemas mais frequentes.
O agente de IA não responde às mensagens
Siga este passo a passo para identificar e corrigir o problema:
Verifique as configurações do agente #
- Vá em Recursos VIP → Agentes de IA.
- Clique nos três pontinhos do agente desejado → Editar.
- Confirme se há um modelo da OpenAI configurado corretamente, encontre Configurações LLM. (é o “motor” do agente)
👉 Sem essa configuração, o agente não funcionará.
Verifique a conexão com a caixa de entrada #
Ainda no agente selecionado:
- Encontre a sessão Caixas de Entrada.
- Verifique se o agente está vinculado a uma caixa de entrada.
- Caso não esteja:
- Clique em Adicionar Caixa de Entrada.
- Selecione:
- A caixa de entrada desejada.
- O agente humano responsável. (caso o cliente peça atendimento humano)
- Desça a página até o final e clique em Atualizar e depois em Sim, ativar.
Teste o funcionamento #
Faça um novo teste para verificar se o agente já está respondendo.
Se ainda não funcionar:
- Vá em Configurações → Caixas de Entrada.
- Clique na engrenagem da caixa.
- Acesse a aba Agentes.
- Desmarque a opção Habilitar atribuição automática.
Verifique os créditos da OpenAI #
O problema pode estar relacionado à falta de saldo:
- Acesse: platform.openai.com → Billing.
- Verifique se há créditos disponíveis.
- Caso não haja:
- Adicione saldo. (Add to credit balance)
- Ou ative a recarga automática. (Enable auto recharge)
Verifique o WhatsApp Business #
Se o erro persistir:
- Acesse o Facebook Business.
- Vá em Configurações → Contas do WhatsApp e selecione sua conta.
- Verifique se há uma forma de pagamento válida.
- Caso não haja:
- Clique em Configurações de Pagamento para adicionar um método.
- Verifique se o nome de exibição está aprovado:
- Clique em Gerenciador do WhatsApp, para abrir as configurações detalhadas.
⚠️ Nomes reprovados há mais de 20 dias impedem o funcionamento da conta. Caso haja reprovação, atualize seu nome conforme as diretrizes para nomes de exibição.
Conclusão #
Seguindo esses passos, é possível resolver a maioria dos problemas que impedem o funcionamento do agente de IA na ZapiCRM.
Caso o erro continue, o ideal é entrar em contato com o suporte técnico para uma análise mais detalhada.
