Consola: webhooks
Endpoints, eventos, registro de entregas y reenvío.
Los webhooks dejan que el resto de tu stack reaccione en el momento en que alguien cambia de opinión: suprime un contacto en tu ESP en cuanto retira el consentimiento, sincroniza una etiqueta en el CRM o dispara un trabajo de re-personalización, sin necesidad de sondear la API.
Registra un endpoint con una URL https://, un entorno y una lista de eventos. El secreto de firma se muestra una sola vez. En desarrollo local, expón tu receptor con un túnel HTTPS (ngrok, cloudflared…).
Eventos
Un endpoint puede suscribirse a cualquiera de estas familias de eventos. La lista completa, con cuándo se emite cada uno y qué lleva en data, está en Webhooks: cuerpos y firma.
- Consentimiento:
consent.granted·consent.updated·consent.withdrawn·consent.expired - Reconsentimiento:
reconsent.required - Preferencias:
preference.updatedy los eventos del doble opt-in (preference.confirmation_requested,preference.confirmed,preference.confirmation_email_sent,preference.confirmation_email_failed) - Sujetos:
subject.merged·subject.erased - Cookies:
cookie.scan_completed - Solicitudes de datos: los eventos
dsar.*de verificación de identidad y de documento de identidad
reconsent.required solo se emite cuando caduca un consentimiento (una política de caducidad que pasa una concesión a EXPIRED). Publicar una versión de un propósito como Requires re-consent no lo emite: consulta needsReconsent al leer el estado del sujeto o lanza una campaña de reconsentimiento.Entregas
Cada entrega se firma con HMAC-SHA256 (cabecera x-croombit-signature: t=…,v1=…) con protección anti-repetición por marca de tiempo. Los fallos se reintentan 8 veces durante unos 3 días (de 1 min a 24 h). Desde el registro de entregas puedes reenviar cualquiera. Consulta Webhooks: cuerpos y firma para ver un receptor completo y los pasos de verificación.
El botón Test de un endpoint envía un evento sintético test.ping, firmado igual que uno real, para que compruebes que tu URL y tu secreto funcionan de punta a punta. No es un evento al que se pueda suscribir.
El secreto de firma
El secreto whsec_… se muestra una sola vez, al crear el endpoint: cópialo entonces a tu gestor de secretos. Para cambiarlo usa Rotate secret en el endpoint: elige cuánto tiempo sigue valiendo el secreto antiguo (desde «Revoke now» hasta 72 horas) y el nuevo se muestra una sola vez. Las suscripciones y el registro de entregas se conservan.