Runbook: Webhook Fora do Ar

Sintoma

Mensagens do WhatsApp não estão chegando no n8n. Leads mandam mensagem e o agente não responde.

Diagnóstico

1. Verificar n8n:
2. Acessar o painel do n8n
3. Ir em Executions → verificar se há execuções recentes

4. Se não há execuções → webhook não está recebendo

5. Verificar UaZapi:

6. Acessar painel do UaZapi
7. Verificar se o webhook está apontando para a URL correta do n8n

8. Verificar se a instância do WhatsApp está conectada (QR code)

9. Verificar conectividade:

10. Testar o endpoint com curl:

    curl -X POST https://SEU-N8N/webhook/harmonizapro \
      -H "Content-Type: application/json" \
      -d '{"test": true}'
    

11. Se retornar 404 → workflow não está ativo
12. Se retornar 500 → erro interno no workflow

Resolução

Causa	Solução
Workflow desativado	Ativar o workflow no n8n
URL do webhook mudou	Atualizar URL no UaZapi
WhatsApp desconectado	Reconectar escaneando QR code
n8n caiu/reiniciou	Verificar se o serviço está rodando
Rate limit UaZapi	Aguardar e verificar logs

Prevenção

• Configurar alerta se agente parar de funcionar (monitoramento)
• Verificar diariamente se há execuções recentes