Integración con Connectif
Esta guía te explicará cómo integrar Connectif con Omniwallet para poder potenciar la estrategia de loyalty de forma completa.
La integración permite:
- Capturar los importes de compra para que Omniwallet asigne los puntos correspondientes al cliente.
- Dar de alta clientes nuevos en el programa de fidelización
- Enviar la tarjeta wallet a través de Connectif
- Enviar a Connectif la cantidad de puntos que tiene cada cliente en tiempo real
Conectar Connectif con Omniwallet
Crear API key en Connectif
Dentro de tu cuenta de Connectif, debes crear una API key. Para ello dirígete a la pestaña de “Ajustes de tienda” – “ API Keys” y haz clic en Crear nueva API ke
Completa el campo Nombre con Omniwallet y activa todas las casillas vacías para habilitar los permisos.
Luego haz clic en Guardar.
En Acciones, copia el API Key creado.
Dentro de tu panel de administración de Omniwallet, dirígete a la pestaña Integraciones – CRM – Connectif.
Pega el API Key copiado anteriormente en el campo Token de autenticación.
En el campo URL API introduce https://api.connectif.cloud/
Crear campos de contacto personalizados
En Connectif tendrás que crear campos personalizados donde guardar las URL de descarga de las tarejtas wallet de los clientes. Para eso dirígete a “Contactos – Campos del contacto” y filtra por “Campos Personalizados”.
IMPORTANTE
Es obligatorio crear todos los campos personalizados indicados en esta guía. Si no se crean todos estos campos, no se realizará la integración de forma correcta.
Seleccióna la opción “Añadir nuevo campo personalizado” y añade los siguientes campos.
| Tarjeta Google Wallet |
- Nombre: omniwallet_download_google_wallet
- ID: omniwallet_download_google_wallet
- Tipo: Texto
- Es requerido: No
| Tarjeta Apple Wallet |
- Nombre: omniwallet_download_pkpass_ios
- ID: omniwallet_download_pkpass_ios
- Tipo: Texto
- Es requerido: No
| Tarjeta Android Wallet pkpass |
- Nombre:
omniwallet_download_pkpass_android
- ID:
omniwallet_download_pkpass_android
- Tipo: Texto
- Es requerido: No
| Omniwallet ID |
- Nombre: omniwallet_id
- ID: omniwallet_id
- Tipo: Texto
- Es requerido: No
| Omniwallet QR |
- Nombre: omniwallet_qr_ean
- ID: omniwallet_qr_ean
- Tipo: Texto
- Es requerido: No
Crear integración personalizada en Connectif
Dentro de tu cuenta de Connectif, debes crear una integración personalizada. Para ello dirígete a la pestaña de “Ajustes de tienda”
Haz clic en “Integraciones personalizadas” y luego “Crear nueva integración”.
En “Nombre de la integración” escribe Omniwallet. En “Descripción” escribe Integración Omniwallet. Asegurate de tener el check en “Habilitar enviar y recibir datos para esta integración”. Luego haz clic en “Guardar”.
¿Que eventos o acciones se pueden ejecutar desde Connectif hacia Omniwallet?
Crear eventos
Dentro de la integración ya creada. Dirígete a la pestaña superior “Enviar Datos” y haz clic en el botón “Crear nuevo evento de envío”.
Aquí podrás crear tres tipos de eventos
- Crear cliente en Omniwallet
- Enviar compra a Omniwallet
¿Como puedo crear un cliente en Omniwallet desde Connectif?
Crear evento “Nuevo Cliente”
Este evento envía los datos de un cliente de Connectif a Omniwallet.
Establece el nombre del evento en Nombre del evento de envío como Nuevo cliente Omniwallet y en Webhook URL donde enviar el mensaje https://api.omniwallet.cloud/cnf/contact-registered?ow_account=subdominio
*Donde dice subdominio debes colocar el subdominio de tu cuenta de Omniwallet.
Luego en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Accept
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Authorization
En Valor debes escribir Bearer API token
Aquí deberás crear un API token en Omniwallet o utilizar el API token ya creado. Si no sabes como crear un API token haz clic aquí.
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Content-Type
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Email
En Nombre del campo debes escribir email
En Identificador del campo debes escribir email
Marca la casilla de “Es obligatorio” y “Es clave primaria”.
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Texto
En Nombre del campo debes escribir name
En Identificador del campo debes escribir name
Marca la casilla de “Es obligatorio”.
Luego haz clic en Aceptar
Crear workflow
Luego tienes que crear un workflow para ejecutar este evento. A este workflow podemos llamarlo
¿Cómo enviar una compra desde Connectif a Omniwallet?
Crear evento “Compra”
Este evento envía los datos de una compra registrada desde Connectif a Omniwallet.
Establece el nombre del evento en Nombre del evento de envío como Compra Omniwallet y en Webhook URL donde enviar el mensaje
https://api.omniwallet.cloud/cnf/points-record-registered?ow_account=subdominio
*Donde dice subdominio, debes colocar el subdominio de tu cuenta de Omniwallet.
Luego en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Accept
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Authorization
En Valor debes escribir Bearer API token
Aquí deberás crear un API token en Omniwallet o utilizar el API token ya creado. Si no sabes como crear un API token haz clic aquí.
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Content-Type
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Email
En Nombre del campo debes escribir email
En Identificador del campo debes escribir email
Marca la casilla de “Es obligatorio” y “Es clave primaria”.
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Texto
En Nombre del campo debes escribir external_id
En Identificador del campo debes escribir external_id
Marca la casilla de “Es obligatorio”
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Número decimal
En Nombre del campo debes escribir amount
En Identificador del campo debes escribir amount
Marca la casilla de “Es obligatorio”
Luego haz clic en Aceptar
¿Cómo enviar un email de bienvenida desde Connectif?
Crear un workflow para el envío del email de bienvenida
En Connectif tendrás que crear un workflow para esta tarea. Para ello dirígete a Workflows – Crear nuevo workflow.
Selecciona los siguientes nodos
Inicio
Selecciona si quieres enviarlo a todos los clientes, o a solo un segmento específico, y si se enviará una única vez o quedará activo para futuros clientes que entren en el programa de fidelización.
Condición – “Tiene Campo”
Añade le nodo de condición “Tiene campo”, selecciona alguno de los campos en los que tienes guardada la URL de descarga de la tarjeta y condicionalo a que “No está vacío”. Esto nos garantizará que la tarjeta se enviará únicamente a los clientes que estén dados de alta y tengan la URL de descarga guardada en Connectif.
Acción – “Enviar email”
- Añade el nodo de envío de email para crear el diseño del correo y añadirle las variables correspondientes.
- En el correo electrónico deberás añadir dos botones, uno para Google Wallet y otro para Apple Wallet.
- En el botón o imagen de Google Wallet, añade como enlace la variable {{google-wallet}}.
- En el botón o imagen de Apple Wallet, añade como enlace la variable {{apple-wallet}}.
- Guarda el diseño del email.
6. Configura el asunto, remitente y ajustes generales del correo.
7. Añade los campos personalizados de contacto a las variables del email.
Resumen del workflow
Al finalizar la configuración del workflow te quedará un flujo como el siguiente. Recuerda hacer pruebas antes del lanzamiento del email.
¿Cómo añadir o quitar puntos por una acción específica desde Connectif?
Crear evento “Modificar puntos”
Este evento modifica los puntos de un cliente (suma o resta) desde Connectif a Omniwallet.
Dentro de tu cuenta de Connectif dirígete a “Ajustes de Tienda” – “Integraciones Personalizadas” – “Omniwallet” y haz clic en Editar.
Dentro de la configuración de la integración, dirígete a “Enviar Datos” y “Crear nuevo evento de envío”
Establece el nombre del evento en Nombre del evento de envío como Modificar Puntos Omniwallet y en Webhook URL donde enviar el mensaje
https://api.omniwallet.cloud/cnf/modify-points?ow_account=subdominio
*Donde dice subdominio, debes colocar el subdominio de tu cuenta de Omniwallet.
Luego en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Accept
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Authorization
En Valor debes escribir Bearer API token
Aquí deberás crear un API token en Omniwallet o utilizar el API token ya creado. Si no sabes como crear un API token haz clic aquí.
Luego haz clic en Aceptar
Luego debes añadir otra cabecera en Configurar cabeceras HTTP que llevará el mensaje, haz clic en “Añadir nueva cabecera”.
En Nombre de la cabecera debes escribir Content-Type
En Valor debes escribir application/json
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Email
En Nombre del campo debes escribir email
En Identificador del campo debes escribir email
Marca la casilla de “Es obligatorio” y “Es clave primaria”.
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Número entero
En Nombre del campo debes escribir amount
En Identificador del campo debes escribir amount
Marca la casilla de “Es obligatorio”
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Texto
En Nombre del campo debes escribir action
En Identificador del campo debes escribir action
Marca la casilla de “Es obligatorio”
Luego haz clic en Aceptar
Luego en Configurar el conjunto de datos asociado al evento, haz clic en “Añadir nuevo campo”.
En Tipo de campo debes elegir Texto
En Nombre del campo debes escribir type
En Identificador del campo debes escribir type
Marca la casilla de “Es obligatorio”
Luego haz clic en Aceptar
Crear un workflow: utilizaremos como ejemplo, el dar puntos por completar un formulario, pero puede ser cualquier otro escenario.
En Connectif tendrás que crear un workflow para esta tarea. Para ello dirígete a Workflows – Crear nuevo workflow.
Selecciona los siguientes nodos
Inicio
Selecciona si quieres aplicar la suma a todos los clientes, o a solo un segmento específico, y si se utilizará una única vez o quedará activo para futuros clientes que entren en el workflow.
Condición – “Ha enviado un formulario web”
Añade le nodo de condición “Tiene campo”, selecciona alguno de los campos en los que tienes guardada la URL de descarga de la tarjeta y condicionalo a que “No está vacío”. Esto nos garantizará que la tarjeta se enviará únicamente a los clientes que estén dados de alta y tengan la URL de descarga guardada en Connectif.
Acción – “Modificar puntos Omniwallet”
Completa los campos que solicita el nodo de la siguiente forma:
email: arrastra el campo “Email” del usuario
amount: arrastra el campo “Literal” y añade la cantidad de puntos a sumar o restar.
action: arrastra el campo “Literal” y completa con el valor add para sumar puntos o subtract para restar puntos.
type: arrasta el campor “Literal” y añade la descripción o razón de la suma o resta de puntos.
Finalmente, el workflow completado queda de la siguiente manera.
¿Te resultó útil este artículo?