Introduction
Once your Connectif account is connected to Loyoly, you need to create the Loyoly events you want to use in Connectif, then build your workflows by mapping the variables. This guide walks you through it step by step.
💡 You must first have connected Loyoly to Connectif via API key. If you haven't yet, see the guide Integrating Loyoly with Connectif.
1. Create the integration in Connectif
In Connectif, go to Ajustes generales → Integraciones → Integraciones Personalizadas (General settings → Integrations → Custom integrations) and click Crear nueva integración (Create new integration). Name it, for example "Integration Loyoly".
2. Create the reception events
Open your integration, then the Recibir datos (Receive data) tab and click Crear nuevo evento de recepción (Create new reception event). Create one event for each Loyoly event you want to use.
💡 Examples of events already configured on the Loyoly side (Recibir datos tab): points_earned, post_purchase, reward_redeemed. Each event shows its identifier, name, alias, type (Webhook), creation date and number of fields.
When creating an event, a "Crear nuevo evento de recepción" (Create new reception event) window asks you to choose the connection type:
Third-Party Platform (Webhook) — receives events automatically from an external platform. This is the option used for Loyoly.
Select Third-Party Platform (Webhook) then click Ir al editor (Go to editor).
In the editor (Configuración básica / Basic configuration tab), fill in:
Nombre del evento de recepción (Event name) — e.g.
reward_redeemed.Alias del evento de recepción (Alias) — e.g.
reward_redeemed. The alias lets you send the event without using the generated ID.The identifier is provided automatically once the event is created.
(Optional) an icon for the event.
The email field: the key that links the event to the right customer
Every event you create must contain an email field. It is the most important part of the configuration, so take the time to understand it.
What is it for? When Loyoly sends an event to Connectif (for example "a reward has just been redeemed"), Connectif needs to know which contact to attach the event to. The email address plays this unique-identifier role: Connectif matches the received email against your contact database and links the event to the right person. This is called the primary key (clave primaria) because it is the data used as the matching point.
How to configure it? Click Añadir un nuevo campo (Add a new field), then enter exactly:
Tipo de campo (Field type) = Email
Nombre del campo (Field name) =
emailIdentificador del campo (Field identifier) =
emailCheck Es obligatorio (Required): the event will not be accepted if it arrives without an email.
Check Es clave primaria (Primary key): this designates the email as the matching identifier.
🚨 Do this for every event. If you forget the email field, or if the Required and Primary key boxes are not checked, Connectif won't know which contact to attach the event to: the data (points, reward, etc.) won't appear in the email, or the event will be ignored. Check these two boxes every time you create an event.
Once the email field is in place, add all the other fields of the event (one per Loyoly variable to receive). For each field: set the Tipo de campo (e.g. Texto / Text), the Nombre del campo (Field name) and the Identificador del campo (Field identifier, e.g. reward_name). Unlike the email, these fields are neither required nor primary keys.
Click Guardar (Save) once all fields are added.
3. Create the workflow
In Connectif, go to Workflows and create a new workflow. Build the following structure: a start node Inicio (Start), the trigger node "Déclencheur [event name]" (Trigger, e.g. Déclencheur reward_redeemed), then a "Enviar email" (Send email) node.
In the Enviar email node, create or select your email. Insert variables in the text with the double-brace syntax: {{variable_name}}.
Example email body:
Congrats, there is your reward:
Your reward: {{reward_name}}
Your code: {{reward_code}}
Minimum purchase: {{reward_condition}}
Finally, in the Enviar email node configuration (Variables step), map each email variable to the matching data from the trigger event. For each line, the source is "Déclencheur [event] | [field]" (e.g. Déclencheur reward_redeemed | reward_name) and the target is the email variable (e.g. {{reward_name}}), via the Asignar (Assign) action.
💡 The email variables must match the fields declared in the event. If a variable stays empty in the email, check its mapping (Asignar) in the Variables step of the Enviar email node.
Click Aplicar (Apply), then save and start the workflow.
If the issue persists, contact our support team via chat.