Iubenda logo
Genera tus documentos

Documentación

Tabla de contenidos

Integración de Webhooks con servicios de terceros

Gestionar el consentimiento en varias herramientas puede suponer todo un desafío, pero no tiene por qué serlo. Con 2-Way Sync de iubenda, parte de la Consent Database, sincronizar sus consentimientos de marketing a través de plataformas es fluido, en tiempo real y totalmente conforme.

Esta guía te lleva a través de cómo integrar la Consent Database de iubenda con plataformas de terceros utilizando webhooks salientes, incluyendo herramientas como Zapier, Make y N8N. También cubriremos temas avanzados, como manejar intentos fallidos, reintentos y entender la estructura de la carga útil del webhook.

Cómo integrar un webhook saliente con Zapier

1. Crea un Zap:

  1. Inicia sesión en Zapier, crea un nuevo Zap y elige Webhooks by Zapier.
  2. webhooks de zapier
  3. Selecciona Catch Hook como el evento desencadenante y copia la URL del webhook que proporciona Zapier.
webhooks de zapier 2

2. Configura el Webhook en iubenda:

  • En iubenda, ve a la sección Webhooks salientes. (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”.

    webhooks de zapier 2
  • Crea un nuevo webhook saliente, pega la URL de Zapier y selecciona la preferencia que deseas actualizar (por ejemplo, suscripción al boletín).
  • webhooks de zapier 2
  • Guarda el webhook.

3. Probar y Publicar:

  • Disparar un evento (por ejemplo, una actualización de suscripción) y probar el disparador en Zapier.
  • webhooks de zapier 2
  • [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.
  • webhooks de zapier 2
  • Una vez que todo funcione, publica el Zap.
webhooks de zapier 2

💡 Consejo: Utiliza Zap history para asegurarte de que todo esté funcionando sin problemas.

webhooks de zapier 2

Cómo integrar un webhook saliente con Make

1. Crea un escenario:

  • Inicia sesión en Make y crea un nuevo escenario con Webhooks. Elige Webhook personalizado y copia la URL.
webhooks de zapier 2

2. Configura el Webhook en iubenda:

  • En iubenda, ve a la sección Webhooks salientes. (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”.

    webhooks de zapier 2
  • Crea un nuevo webhook saliente, pega la URL de Make y selecciona la preferencia que deseas rastrear (por ejemplo, actualizaciones del boletín).
  • webhooks de zapier 2
  • 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) y deja que Make lo detecte.
  • Ahora puedes vincular el webhook a un servicio como Mailchimp 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.
webhooks de zapier 2

💡 Consejo: Revisa el Hacer dashboard para monitorear la integración.

webhooks de zapier 2

Cómo integrar un webhook saliente con N8N

1. Crear un flujo de trabajo:

  • En N8N, crea un nuevo flujo de trabajo y añade un Webhook nodo. Establezca el método a POST y copie la URL del webhook.
webhooks de zapier 2

2. Configura el Webhook en iubenda:

  • En iubenda, ve a la sección Webhooks salientes. (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”.

    webhooks de zapier 2
  • Crea un nuevo webhook saliente, pega la URL de N8N y selecciona la preferencia que deseas rastrear.
  • webhooks de zapier 2
  • 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.
    • webhooks de zapier 2
    • 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.

💡 Consejo: Utiliza la pestaña de Ejecución en N8N para asegurarte de que todo esté funcionando correctamente.

webhooks de zapier 2

Avanzado: Qué hacer si un webhook falla

Si un webhook falla porque el servidor de destino no está respondiendo, iubenda reintenta la solicitud varias veces:

  • Intenta de nuevo 10 veces, comenzando 2 minutos después del primer fallo y aumentando el tiempo de espera después de cada intento. 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.