Webhooks

Webhooks que não perdem eventos

Payloads assinados com HMAC-SHA256, retries com exponential backoff, replay a partir de qualquer ponto e um botão de test-fire em cada endpoint.

Configurar webhooks Ler a spec

8 tipos de evento

Subscreve o que te interessa

Cada endpoint pode optar por um ou vários eventos. Os schemas dos payloads são versionados e documentados em OpenAPI.

site.created

Novo site provisionado

site.provisioned

Provisionamento concluído

site.suspended

Site auto-suspenso

site.cancelled

Cliente cancelou

plugin.installed

Plugin ligado a um site

plugin.uninstalled

Plugin desligado

invoice.issued

Nova fatura gerada

invoice.paid

Fatura liquidada

Payloads assinados

Cada pedido inclui um header X-RadCMS-Signature que podes verificar contra o signing secret do teu endpoint. Rejeita qualquer pedido que falhe a verificação — é assim que prevines falsificações.

HMAC-SHA256 sobre o request body em bruto.
Signing secret revelado uma vez na criação, nunca mais.
Rotação suportada — chave antiga + nova válidas em paralelo durante 7 dias.
Proteção contra replay via X-RadCMS-Timestamp + janela de 5 minutos.

// PHP — verificar um webhook do radcms
$secret    = env('RADCMS_WEBHOOK_SECRET');
$payload   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_RADCMS_SIGNATURE'];

$expected = 'sha256=' .
  hash_hmac('sha256', $payload, $secret);

if (! hash_equals($expected, $signature)) {
  http_response_code(401);
  exit('Invalid signature');
}

$event = json_decode($payload, true);
// processar o $event …

Feito para sobreviver ao teu downtime

Se o teu endpoint estiver com um mau dia, não deves perder eventos. Eis como o tratamos.

Exponential backoff

Retries a 1s, 10s, 1m, 10m, 1h, 1d. Após 6 tentativas falhadas, o endpoint é auto-suspenso à espera de ação do operador.

Replay a partir de qualquer ponto

Cada entrega é registada com payload + resposta completos. Faz replay de eventos individuais ou de um intervalo de datas com um clique a partir do painel.

Teste por endpoint

Carrega num botão Test no painel para disparar um payload de exemplo ao teu endpoint. Vê o código de resposta, o body e o timing inline.

Log de entregas em direto

Últimos 7 dias de entregas por endpoint, com código HTTP, latência e o request/response exatos.

Auto-desativação após N falhas

6 falhas consecutivas pausam o endpoint e enviam email à tua equipa. Volta a ativar a partir do painel quando corrigires.

Allowlist de IP (Enterprise)

Todo o tráfego outbound de webhooks do radcms parte de um conjunto documentado de IPs. Os clientes Enterprise podem fixar um allowlist mais restrito.

Pronto para ligar o teu stack?

Cria uma conta e adiciona o teu primeiro endpoint em menos de um minuto.

Começar — é grátis