Implantação/Ajuda
Solução de Problemas
Causas comuns e soluções quando o WhatsApp desconecta, a IA fica em silêncio, as conversas não chegam aos agentes ou o widget não aparece.
Use esta página quando algo não estiver funcionando como esperado. Encontre o sintoma e siga as verificações em ordem.
O que ela faz
Resume os problemas mais comuns, junto com os locais das configurações para verificá-los.
Benefícios
- Resolva problemas comuns por conta própria, sem esperar por ajuda.
- Descubra se a causa é uma configuração, o plano ou a conexão.
Passo a passo
- WhatsApp desconectado. Abra Configurações → Número de WhatsApp e veja o status no card do número. Se estiver Desconectado ou Aguardando leitura, leia o QR novamente em ⋮ / Configurações → Dispositivos conectados → Conectar dispositivo. Se estiver Pausado — acima do limite do plano, a quantidade de números excede o limite do seu plano; faça upgrade do plano ou remova outros números. Abra o aplicativo WhatsApp no celular regularmente para manter a sessão saudável.
- O QR não aparece. Aguarde alguns segundos até que "Preparando conexão" termine e depois recarregue a página (o assistente tem um link Não apareceu? Recarregar). Confirme que o número não está Pausado. Se continuar em branco, clique em Desconectar e tente novamente.
- A IA não responde. Verifique em ordem:
- AI desativada. Verifique AI Agent → Modelo de AI (status da IA) e depois o Modo de AI no card do número em Configurações → Número de WhatsApp. O modo Desativado — tudo para agentes envia todas as conversas aos agentes, enquanto Somente respostas de blast faz a IA responder apenas às respostas de blasts.
- Crédito ou limite de custo esgotado. O limite diário de custo de IA ou a cota mensal de IA pode ter sido atingido, e a IA para até o próximo período ou até que o limite seja aumentado em Configurações → Billing. Durante o teste, há um limite diário e um crédito de teste.
- Fatura em atraso ou teste encerrado. A IA fica bloqueada e os recursos pagos ficam restritos até que a fatura seja paga ou um plano seja escolhido em Configurações → Billing. O Inbox ainda pode ser usado manualmente.
- A conversa já foi assumida por um agente. Se um agente responde, ou você responde pelo celular com Pausar a AI quando responder pelo celular ativado, a IA para nessa conversa. Em AI Agent → Transferir para um agente você pode definir Devolver à AI se o agente ficar inativo (minutos).
- Contato bloqueado. As mensagens de contatos bloqueados são ignoradas.
- Modelo não definido. Confirme que um provedor e um modelo estão selecionados em AI Agent → Modelo de AI.
- As conversas não chegam aos agentes. Sem regras de roteamento, as conversas transferidas pela IA vão para "Não atribuído". Crie uma regra em Configurações → Roteamento (por exemplo, Transferência → agente online). Confirme que o agente tem o acesso a números correto em Configurações → Equipe e agentes e é membro do inbox de equipe de destino. Sem a permissão "Ver todas as conversas", os agentes veem apenas as conversas que são deles.
- O widget não aparece. Verifique Configurações → Chat widget → Comportamento → Restringir ao domínio: o domínio do site deve estar na lista (ou deixe vazio). Confirme que Ocultar no celular está desativado se você estiver testando em um celular, que o código foi colado antes de
</body>e que o ID do widget não foi gerado novamente (o código antigo deixa de funcionar). - Esqueceu de escolher uma empresa ou entrou na errada. Saia, entre novamente e escolha a empresa certa na tela Escolha uma empresa. Veja Entrar e escolher uma empresa.
- O código de verificação do e-mail não chega. Verifique o spam e depois clique em Reenviar código, ou em Trocar e-mail se você digitou errado.
- Menu não visível. Se um menu ou aba de Configurações não aparece, a sua função pode não ter acesso, ou o recurso não está incluído no seu plano. Fale com o seu Administrador para alterar a função em Equipe e agentes.

Dicas
Dica
Ao falar com o suporte, informe o nome do número ou do widget, o horário em que ocorreu e uma captura de tela da mensagem de erro. Isso acelera a investigação.
