Troubleshooting
Soluções rápidas para os problemas mais comuns.
WhatsApp não envia mensagens
Veja a página dedicada em /docs/whatsapp/troubleshooting com diagnóstico completo (status da instância, last_sync_at, formato do número).
Regra criada não dispara
Confira em Regras → Auditoria se o evento está chegando. Causas comuns: regra desabilitada, escopo restritivo demais, prioridade menor que outra regra que terminou em 'block'.
Webhook retorna 401 mesmo com assinatura
Garanta que está usando o secret atual (não o anterior). Use timing-safe compare. Verifique se está assinando o body bruto (string), não o objeto serializado de novo.
Motorista não aparece no match
Cheque: status = ativo, CNH dentro da validade, categoria compatível com o veículo do frete. Para cargas perigosas, has_mopp deve ser true.
API retorna 422 ao mudar status
Você está tentando uma transição inválida (ex: aceito → rascunho). Veja o ciclo de vida do frete em /docs/concepts/freight-lifecycle.
Email de convite não chega
Peça para verificar spam. Confirme em Configurações → Usuários se o convite consta como 'pendente'. Reenvie se necessário; convites expiram em 7 dias.
Não resolveu?