Skip to main content

​
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

CampoDescrição
URLEndpoint que recebeu ou enviou a chamada
OrigemFonte do disparo: agente, ação, formulário ou sistema
MétodoHTTP method usado (GET, POST, etc.)
StatusCódigo HTTP de resposta (200, 400, 500, etc.)
TentativaNúmero da tentativa (#1, #2, #3)
HorárioTempo relativo (ex: “há 5 minutos”)
TipoCategoria: receive, send, agent_action, form_submission

​
Cores do Status

CorSignificado
VerdeSucesso (2xx)
VermelhoErro (4xx ou 5xx)
CinzaPendente ou sem resposta

​
Filtros

FiltroOpções
StatusSucesso, erro, pendente
PeríodoÚltima hora, últimas 24h, última semana
OrigemPor agente, ação específica ou formulário

​
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. 
{
  "phone": "5511999999999",
  "contact_name": "João Silva",
  "nome": "João",
  "email": "joao@empresa.com",
  "_conversation_id": "abc-123",
  "_agent_id": "def-456"
}

​
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

TipoDescrição
receiveEvento do WhatsApp recebido e encaminhado ao seu servidor
sendConfirmação de mensagem enviada
agent_actionAção disparada pelo Agente de IA (webhook, HTTP request)
form_submissionSubmissão de formulário encaminhada ao webhook do formulário

​
Política de Retentativas

Quando uma chamada falha (status ≥ 400 ou timeout > 10s), o Brainchat realiza até 3 tentativas automáticas:
TentativaIntervalo
#1Imediata
#2Após 30 segundos
#3Após 2 minutos
Após 3 falhas consecutivas, o evento é descartado. Os logs registram cada tentativa individualmente.

​
Depurando Erros Comuns

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.
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.
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).
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.
Use os logs para validar o formato do payload antes de integrar com sistemas externos. O painel mostra o JSON exato que foi enviado em cada chamada.