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
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 key.
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 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”.
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”.
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://subdomain.omniwallet.net/cnf/contact-registered
*Donde dice subdomain, 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 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://subdomain.omniwallet.net/cnf/points-record-registered
*Donde dice subdomain, 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
