Biblioteca de ayuda - Integración con Connectif
Encuentra la documentación completa y detallada de todas las funcionalidades de Omniwallet.
Integración de Omniwallet 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”.
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
| 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 purchase_id
En Identificador del campo debes escribir purchase_id
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.
