Webhooks

Los webhooks le permiten recibir eventos de consentimiento como solicitudes HTTP POST a su propio endpoint. Use webhooks para sincronizar el estado del 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 la verificación de firmas)
5. Guarde

Eventos

Evento	Activador
consent.created	El usuario otorga consentimiento por primera vez
consent.updated	El usuario cambia sus opciones de consentimiento
consent.expired	El consentimiento almacenado alcanza la fecha de expiración
consent.reset	Se aplicó un 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 ver ejemplos de código.

Probar webhooks

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

Ver el historial de entregas

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