Webhooks

Webhooks que no pierden eventos

Payloads firmados con HMAC-SHA256, reintentos con backoff exponencial, replay desde cualquier punto y un botón de test-fire en cada endpoint.

Configurar webhooks Leer la spec

8 tipos de evento

Suscríbete a lo que importa

Cada endpoint puede suscribirse a uno o varios eventos. Los esquemas de payload tienen versiones y están documentados en OpenAPI.

site.created

Nuevo site aprovisionado

site.provisioned

Aprovisionamiento terminado

site.suspended

Site auto-suspendido

site.cancelled

El cliente ha cancelado

plugin.installed

Plugin adjuntado a un site

plugin.uninstalled

Plugin desvinculado

invoice.issued

Nueva factura generada

invoice.paid

Factura pagada

Payloads firmados

Cada petición incluye un header X-RadCMS-Signature que puedes verificar con el signing secret de tu endpoint. Rechaza cualquier petición que no pase la verificación — así evitas la falsificación.

HMAC-SHA256 sobre el cuerpo bruto de la petición.
El signing secret se muestra una sola vez al crearlo, nunca más.
Soporte de rotación — la clave antigua y la nueva son válidas durante 7 días.
Protección anti-replay vía X-RadCMS-Timestamp + ventana de 5 minutos.

// PHP — verificar un webhook de 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);
// procesa $event …

Hecho para sobrevivir a tu downtime

Que tu endpoint tenga un mal día no debería suponer perder eventos. Así lo gestionamos.

Backoff exponencial

Reintentos a 1s, 10s, 1m, 10m, 1h, 1d. Tras 6 intentos fallidos el endpoint queda auto-suspendido a la espera de acción del operador.

Replay desde cualquier punto

Cada entrega queda registrada con payload + respuesta completos. Replay de eventos individuales o de un rango de fechas con un clic desde el panel.

Test por endpoint

Pulsa Test en el panel para enviar un payload de muestra a tu endpoint. Verás el código de respuesta, el body y el tiempo en línea.

Log de entregas en vivo

Últimos 7 días de entregas por endpoint, con código HTTP, latencia y la petición/respuesta exactas.

Auto-deshabilitar tras N fallos

6 fallos seguidos pausan el endpoint y avisan a tu equipo por email. Lo reactivas desde el panel cuando lo arregles.

IP allowlist (Enterprise)

Todo el tráfico saliente de webhooks de radcms procede de un conjunto documentado de IPs. Los clientes Enterprise pueden fijar un allowlist más estricto.

¿Listo para conectar tu stack?

Crea una cuenta y añade tu primer endpoint en menos de un minuto.

Empezar — es gratis