Gerenciamento de webhooks

Webhooks permitem que o Batida se integre com sistemas externos enviando ou recebendo requisicoes HTTP. O Batida suporta tanto webhooks de entrada (recebendo eventos de sistemas externos) quanto webhooks de saida (enviando eventos do Batida para endpoints externos).

Webhooks de entrada

O Batida recebe eventos externos atraves do endpoint Alert Webhooks. Ferramentas de monitoramento como Datadog e Grafana enviam alertas para:

POST /api/v1/webhooks/alerts
Authorization: Bearer <token>

Consulte Alert Webhooks para instrucoes completas de configuracao, fontes suportadas e mapeamento de campos.

Webhooks de saida

Webhooks de saida enviam eventos do Batida para sistemas externos quando acoes especificas ocorrem.

Criando um webhook de saida

1. Navegue ate Configuracoes > Webhooks.
2. Clique em Criar Webhook de Saida.
3. Insira um nome, URL de destino e os eventos que deseja assinar.
4. Configure as configuracoes de retry.
5. Salve o webhook.

Eventos suportados

Evento	Descricao
incidents.opened	Um novo incidente foi criado
incidents.status_changed	O status de um incidente foi atualizado
incidents.resolved	Um incidente foi resolvido

Formato do payload

Webhooks de saida enviam um payload JSON com detalhes do evento:

{
  "event": "incidents.opened",
  "timestamp": "2026-04-20T14:30:00Z",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Payment gateway retornando erros 500",
    "severity": "SEV2",
    "status": "investigating"
  }
}

Logs de entrega

Cada entrega de webhook e registrada em log. Visualize os logs de entrega para ver:

• Se a entrega teve sucesso ou falhou.
• O codigo de status HTTP retornado pelo destino.
• O payload da requisicao e o corpo da resposta.
• Timestamp de cada tentativa de entrega.

Politica de retry

Entregas de webhooks de saida que falham sao retentadas automaticamente:

Tentativa	Delay
1a	Imediata
2a	1 minuto
3a	5 minutos
4a	30 minutos
5a	2 horas

Se todas as retentivas falharem, a entrega e marcada como falha e registrada em log. Voce pode retentar manualmente pelo log de entrega.

TIP

Sempre verifique assinaturas de webhooks no lado que recebe para garantir que o payload e autentico. Veja a documentacao da API para detalhes de verificacao de assinatura.