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

Webhooks de entrada permitem que sistemas externos disparem acoes no Batida enviando requisicoes HTTP POST para uma URL unica.

Criando um webhook de entrada

1. Navegue ate Configuracoes > Webhooks.
2. Clique em Criar Webhook de Entrada.
3. Insira um nome e descricao.
4. O Batida gera uma URL unica.
5. Opcionalmente defina um secret para verificacao de payload.
6. Salve o webhook.

Recebendo eventos

Sistemas externos enviam eventos postando payloads JSON na URL do webhook:

POST https://app.batida.io/webhooks/inbound/whk_abc123
Content-Type: application/json
X-Batida-Signature: sha256=<assinatura>

{
  "event": "alert_fired",
  "monitor": "api-latency",
  "message": "Latencia de API acima de 500ms"
}

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
incident.created	Um novo incidente foi criado
incident.status_changed	O status de um incidente foi atualizado
incident.resolved	Um incidente foi resolvido
postmortem.published	Um postmortem foi publicado
action_item.completed	Um item de acao foi marcado como concluido

Formato do payload

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

{
  "event": "incident.created",
  "timestamp": "2026-04-20T14:30:00Z",
  "data": {
    "id": "inc_xyz789",
    "title": "Payment gateway retornando erros 500",
    "severity": "P2",
    "status": "investigating",
    "url": "https://app.batida.io/incidents/inc_xyz789"
  }
}

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.