Introducción
Una vez que tu cuenta de Connectif esté conectada con Loyoly, debes crear en Connectif los eventos de Loyoly que quieras utilizar y, a continuación, construir tus workflows asignando las variables. Esta guía te acompaña paso a paso.
💡 Primero debes haber conectado Loyoly con Connectif mediante clave API. Si aún no lo has hecho, consulta la guía Integración de Loyoly con Connectif.
1. Crear la integración en Connectif
En Connectif, ve a Ajustes generales → Integraciones → Integraciones Personalizadas y haz clic en Crear nueva integración. Ponle un nombre, por ejemplo «Integration Loyoly».
2. Crear los eventos de recepción
Abre tu integración, luego la pestaña Recibir datos y haz clic en Crear nuevo evento de recepción. Crea un evento para cada evento de Loyoly que quieras utilizar.
💡 Ejemplos de eventos ya configurados del lado de Loyoly (pestaña Recibir datos): points_earned, post_purchase, reward_redeemed. Cada evento muestra su identificador, nombre, alias, tipo (Webhook), fecha de creación y número de campos.
Al crear un evento, una ventana «Crear nuevo evento de recepción» te pide elegir el tipo de conexión:
Third-Party Platform (Webhook) — recibe los eventos automáticamente desde una plataforma externa. Es la opción utilizada para Loyoly.
Selecciona Third-Party Platform (Webhook) y haz clic en Ir al editor.
En el editor (pestaña Configuración básica), rellena:
Nombre del evento de recepción — p. ej.
reward_redeemed.Alias del evento de recepción — p. ej.
reward_redeemed. El alias permite enviar el evento sin usar el ID generado.El identificador se proporciona automáticamente una vez creado el evento.
(Opcional) un icono para el evento.
El campo email: la clave que vincula el evento con el cliente correcto
Cada evento que crees debe contener obligatoriamente un campo email. Es la parte más importante de la configuración, así que tómate tu tiempo para entenderla.
¿Para qué sirve? Cuando Loyoly envía un evento a Connectif (por ejemplo «se acaba de canjear una recompensa»), Connectif necesita saber a qué contacto asociar ese evento. La dirección de email cumple ese papel de identificador único: Connectif compara el email recibido con los de tu base de contactos y asocia el evento a la persona correcta. Se llama clave primaria (clave primaria) porque es el dato que sirve de punto de correspondencia.
¿Cómo configurarlo? Haz clic en Añadir un nuevo campo e introduce exactamente:
Tipo de campo = Email
Nombre del campo =
emailIdentificador del campo =
emailMarca Es obligatorio: el evento no se aceptará si llega sin email.
Marca Es clave primaria: esto designa el email como identificador de correspondencia.
🚨 Hazlo en cada evento. Si olvidas el campo email, o si las casillas Es obligatorio y Es clave primaria no están marcadas, Connectif no sabrá a qué contacto asociar el evento: los datos (puntos, recompensa, etc.) no aparecerán en el email, o el evento se ignorará. Verifica estas dos casillas cada vez que crees un evento.
Una vez que el campo email esté en su sitio, añade todos los demás campos del evento (uno por cada variable de Loyoly a recibir). Para cada campo: define el Tipo de campo (p. ej. Texto), el Nombre del campo y el Identificador del campo (p. ej. reward_name). A diferencia del email, estos campos no son obligatorios ni claves primarias.
Haz clic en Guardar una vez añadidos todos los campos.
3. Crear el workflow
En Connectif, ve a Workflows y crea un nuevo workflow. Construye la siguiente estructura: un nodo de inicio Inicio, el nodo desencadenante «Déclencheur [nombre del evento]» (p. ej. Déclencheur reward_redeemed) y, después, un nodo «Enviar email».
En el nodo Enviar email, crea o selecciona tu email. Inserta las variables en el texto con la sintaxis de doble llave: {{nombre_variable}}.
Ejemplo de cuerpo del email:
Congrats, there is your reward:
Your reward: {{reward_name}}
Your code: {{reward_code}}
Minimum purchase: {{reward_condition}}
Por último, en la configuración del nodo Enviar email (paso Variables), asigna cada variable del email al dato correspondiente del evento desencadenante. En cada línea, el origen es «Déclencheur [evento] | [campo]» (p. ej. Déclencheur reward_redeemed | reward_name) y el destino es la variable del email (p. ej. {{reward_name}}), mediante la acción Asignar.
💡 Las variables del email deben coincidir con los campos declarados en el evento. Si una variable queda vacía en el email, verifica su asignación (Asignar) en el paso Variables del nodo Enviar email.
Haz clic en Aplicar y, después, guarda e inicia el workflow.
Si el problema persiste, contacta con nuestro equipo de soporte a través del chat.