Solução de Problemas

Antes de alterar dados ou repetir uma ação, registre a mensagem de erro, horário, tela, usuário e operação afetada.

A página não carrega

1. Confirme o endereço e o HTTPS.
2. Atualize a página e teste uma janela privada.
3. Verifique se o problema afeta outros usuários.
4. O administrador deve consultar o health check da Web/API e os logs do serviço correspondente.

Não consigo entrar

Confirme o e-mail, a senha e se o convite ainda é válido. Se houver recuperação de senha, use o fluxo da instalação. O administrador deve verificar a conta, o provedor de autenticação e o horário do servidor sem solicitar a senha do usuário.

Mensagens não chegam ou não são enviadas

Confira, nesta ordem:

• conexão e configuração do WhatsApp/Meta;
• webhook e assinatura recebida;
• conversa e contato corretos;
• estado da mensagem no inbox;
• fila e worker de envio;
• limites e erros retornados pela Meta.

Não repita múltiplos envios até confirmar se a primeira tentativa foi persistida.

Contatos, tarefas ou negócios não aparecem

Confirme filtros, conta, módulo habilitado e permissões. Se outros usuários também não visualizarem o registro, o administrador deve verificar API, banco e migrações.

Automações, fluxos ou agentes não executam

Verifique se estão ativos, se o gatilho foi satisfeito, se o módulo dependente está habilitado e se há uma execução ou erro registrado. A execução pode ser assíncrona e depender do worker.

Anexos e documentos falham

Confira tamanho/tipo do arquivo, armazenamento disponível e permissões do volume. Não envie documentos com credenciais ou dados além do necessário para reproduzir o problema.

Quando escalar

Envie ao administrador o caminho da tela, horário, identificador do registro e mensagem exata. Nunca envie senha, token, cookie, chave de API ou arquivo .env.