Webhooks

Los webhooks le permiten recibir eventos de consentimiento como solicitudes HTTP POST a su propio endpoint. Use webhooks para sincronizar el estado de consentimiento con su backend, CRM o almacén de datos.

Configurar un webhook

1. Vaya a Panel → Propiedad → Webhooks → Añadir endpoint
2. Ingrese la URL de su endpoint (debe ser HTTPS)
3. Seleccione qué eventos enviar
4. Copie su secreto de webhook (usado para verificación de firma)
5. Guarde

Eventos

Evento	Disparador
consent.created	El usuario da consentimiento por primera vez
consent.updated	El usuario cambia sus opciones de consentimiento
consent.expired	El consentimiento almacenado alcanza la fecha de caducidad
consent.reset	Se aplica restablecimiento de consentimiento a nivel de propiedad

Formato del payload

{
  "event": "consent.created",
  "delivery_id": "del_abc123",
  "timestamp": "2026-03-09T12:00:00Z",
  "property_id": "prop_xyz",
  "data": {
    "receipt_id": "rec_def456",
    "policy_id": "pol_ghi789",
    "policy_version": 3,
    "choices": {
      "necessary": true,
      "analytics": true,
      "marketing": false,
      "functional": true
    },
    "region": "DE",
    "user_agent_hash": "sha256:abc...",
    "ip_hash": "sha256:def..."
  }
}

Verificar firmas

Siempre verifique el encabezado X-ConsentForge-Signature antes de procesar. Consulte Seguridad de webhooks para ejemplos de código.

Probar webhooks

Use el botón Probar en la configuración de webhooks del Panel para enviar un payload de muestra a su endpoint. También puede usar webhook.site para pruebas locales.

Ver historial de entregas

Panel → Propiedad → Webhooks → Registro de entregas muestra todos los intentos de entrega con códigos de estado y cuerpos de respuesta.