Integración de Webhooks con servicios de terceros

Gestionar el consentimiento en varias plataformas es un reto habitual para las empresas, aunque no tiene por qué serlo. La herramienta 2-Way Sync de iubenda, que forma parte de la Consent Database, te permite mantener los estados de consentimiento actualizados en tiempo real en todas tus herramientas de terceros. Esta herramienta te ayuda a garantizar el cumplimiento, a mejorar la precisión y a simplificar el proceso de gestión de las preferencias de los usuarios.

En esta guía te enseñamos a configurar 2-Way Sync con herramientas de la Consent Database de iubenda como Zapier, Make y N8N. También aprenderás a gestionar problemas habituales como reintentos e intentos fallidos, y todo lo explicamos con una estructura sencilla y fácil de seguir.

Cómo integrar un webhook saliente con Zapier

1. Crea un Zap:

• Inicia sesión en Zapier, crea un nuevo Zap y selecciona Webhooks by Zapier como aplicación.



• SeleccionaCatch Hook como el evento desencadenante y copia la URL del webhook que proporciona Zapier.

2. Configura el Webhook en iubenda:

• En iubenda, accede a la sección de webhooks de la Consent Database. (Desde el dashboard de iubenda, selecciona el proyecto y haz clic en el icono de configuración, Abre la Consent Database Webhooks: En el menú lateral, haz clic en “Webhooks de la Consent Database“)



Si no sabes cómo acceder a la sección de webhooks, consulta aquí ⬇️



• Crea un nuevowebhook saliente, pega la URL de Zapier y selecciona la preferencia que deseas actualizar (por ejemplo, suscripción al boletín).



• Guarda el webhook.

3. Probar y Publicar:

• Activa un evento en iubenda (por ejemplo, la actualización de una suscripción).
• Prueba el webhook en Zapier y conéctalo al servicio de terceros que quieras sincronizar (por ejemplo, Mailchimp).



• [Opcional] Definir Filtros o Rutas:
  • Si envías múltiples valores a través de webhooks (por ejemplo, todas las preferencias del boletín), configura filtros o rutas en Zapier para proceder solo con valores específicos, como solo cuando la preferencia esté configurada en “verdadero”.
  • Agrega el servicio que deseas conectar (por ejemplo, Mailchimp) y especifica los cambios que deseas aplicar, como actualizar el estado del suscriptor basado en el campo de correo electrónico en el webhook.



• Una vez que todo funcione, publica el Zap.

Cómo integrar un webhook saliente con Make

1. Crea un escenario:

• Inicia sesión en Make y crea un nuevo escenario.
• Selecciona Webhooks, elige el webhook personalizado y copia la URL proporcionada.

2. Configura el Webhook en iubenda:

• En iubenda, accede a la sección de webhooks de la Consent Database. (Desde el dashboard de iubenda, selecciona el proyecto y haz clic en el icono de configuración, Abre la Consent Database Webhooks: En el menú lateral, haz clic en “Webhooks de la Consent Database“)



Si no sabes cómo acceder a la sección de webhooks, consulta aquí ⬇️



• Crea un nuevo webhook saliente, pega la URL de Make y selecciona la preferencia que deseas rastrear (por ejemplo, actualizaciones del boletín).



• Guarda el webhook.

3. Ejecutar y Automatizar:

• En Make, haz clic en Redeterminar estructura de datos y activa un evento en iubenda (por ejemplo, una actualización de suscripción a boletines).
• Deja que Make detecte la estructura de datos y conecta el webhook a una herramienta de terceros (por ejemplo, HubSpot).
• Ahora puedes vincular el webhook a un servicio como Mailchimp o HubSpot y aplicar las actualizaciones, como gestionar suscriptores según su correo electrónico.
• Una vez confirmado, el sistema se ejecutará automáticamente.
• [Opcional] Agregar Filtros:
  • Si envías múltiples valores, establece filtros en Make para que se activen solo cuando se envíen valores específicos.

Cómo integrar un webhook saliente con N8N

1. Crear un flujo de trabajo:

• Abre N8N y crea un nuevo flujo de trabajo.
• Añade un nodo de webhook, establece el método a POST y copia la URL del webhook.

2. Configura el Webhook en iubenda:

• En iubenda, accede a la sección de webhooks de la Consent Database. (Desde el dashboard de iubenda, selecciona el proyecto y haz clic en el icono de configuración, Abre la Consent Database Webhooks: En el menú lateral, haz clic en “Webhooks de la Consent Database“)



Si no sabes cómo acceder a la sección de webhooks, consulta aquí ⬇️



• Crea un nuevo webhook saliente, pega la URL de N8N y selecciona la preferencia que deseas rastrear.



• Guarda el webhook.

3. Prueba y Publica

• En N8N, escucha el evento de prueba (por ejemplo, una actualización de suscripción), y deja que N8N confirme la estructura de datos.
• [Opcional] Agregar Filtros o Rutas
  • Si envía múltiples valores, puede configurar filtros para procesar solo ciertos valores o crear diferentes rutas para varios resultados.
  • Ahora, conecta el webhook a una aplicación como Mailchimp y aplica cualquier cambio, como crear un nuevo contacto.

  

  • Guarda tu flujo de trabajo y actívalo. A partir de ahora, cada vez que se añada un suscriptor a la Consent Database, se sincronizará automáticamente con Mailchimp.

Avanzado: Qué hacer si un webhook falla

A veces, un webhook puede fallar por problemas con el servidor de destino. Cuando esto sucede, iubenda reintenta la solicitud automáticamente hasta 10 veces, siguiendo esta pauta:

1. 2 minutos después del primer intento fallido.
2. Intervalos en aumento (5 minutos, 10 minutos, hasta 3 horas)..
3. Después de 10 intentos fallidos, el webhook se marca como fallido y deshabilitado.

Aquí está el horario de reintentos:

• Primer intento Después de 2 minutos
• Segundo intento Después de 5 minutos más
• tercer intento Después de 10 minutos más
• Cuarta tentativa Después de 20 minutos más
• Quinta tentativa Después de 45 minutos más
• Intento sexto: Después de 1 hora
• Séptimo intento Después de 1.5 horas
• Octava tentativa Después de 2 horas
• Novena tentativa Después de 2.5 horas
• Décima tentativa Después de 3 horas

• Después de 10 intentos fallidos, el webhook se marca como fallido y no se volverá a intentar.

Interruptor de circuito:

Si un webhook falla 10 veces seguidas, se desactivará automáticamente disabled. Recibirás un correo electrónico, y estará marcado como deshabilitado en la configuración de tu webhook.

Ejemplo de carga útil de Webhook

Aquí hay un ejemplo de los datos que iubenda envía en un webhook:

{
"subject": {
"id": "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"
},
"consent_preferences": {
"newsletter": "false"
},
"changes": {
"newsletter": "false"
}
}

• subject: La ID y el correo electrónico del usuario.
• consent_preferences: Las preferencias de consentimiento actualizadas, como suscribirse o darse de baja de un boletín.
• changes: Cualquier cambio en el registro de consentimiento anterior.