Logs de Webhook
A seção Logs registra todas as chamadas de webhook realizadas pela instância — tanto recebimentos (eventos do WhatsApp enviados ao seu servidor) quanto disparos do Agente de IA, formulários e ações automáticas.Acessar os Logs
Vá em Developers → Webhooks → Logs.Informações por Registro
Cores do Status
Filtros
Detalhes do Log
Clique em qualquer registro para abrir o painel lateral com:Metadados
- URL completa
- Método HTTP
- Número da tentativa
- Data e hora exata
Payload (Request Body)
Corpo completo da requisição enviada, formatado como JSON.Resposta (Response Body)
Corpo da resposta recebida do servidor externo.Mensagem de erro
Se a chamada falhou, a mensagem de erro é exibida aqui para facilitar a depuração.Tipos de Webhook
Política de Retentativas
Quando uma chamada falha (status ≥ 400 ou timeout > 10s), o Brainchat realiza até 3 tentativas automáticas:
Após 3 falhas consecutivas, o evento é descartado. Os logs registram cada tentativa individualmente.
Depurando Erros Comuns
Status 404 — URL não encontrada
Status 404 — URL não encontrada
Verifique se a URL do webhook está correta e se o endpoint existe no seu servidor. Acesse Developers → Webhooks → Endpoints e confirme a URL cadastrada.
Status 401/403 — Não autorizado
Status 401/403 — Não autorizado
Seu servidor está rejeitando a requisição por falta de autenticação. Verifique se o header de autenticação está configurado corretamente nas configurações do endpoint.
Timeout — Sem resposta
Timeout — Sem resposta
Seu servidor demorou mais de 10 segundos para responder. Responda com
200 OK imediatamente e processe a lógica de forma assíncrona (fila, background job).Status 500 — Erro interno
Status 500 — Erro interno
Erro no seu servidor. Verifique os logs da sua aplicação para entender a causa. O payload recebido está disponível nos detalhes do log para reproduzir o erro.