Guía de integración de Connectif con Omniwallet

¿Qué permite esta integración?

La integración entre Connectif y Omniwallet permite:

• Capturar los importes de compra para que Omniwallet asigne automáticamente los puntos correspondientes.

• Dar de alta nuevos clientes en el programa de fidelización.

• Enviar la tarjeta wallet digital a través de Connectif.

• Enviar a Connectif el saldo de puntos de cada cliente en tiempo real.

• Conectar el ecosistema de automatización de Connectif con la lógica de fidelización de Omniwallet.

Conectar Connectif con Omniwallet

1. Crear una API Key en Connectif

1. Accede a tu cuenta de Connectif.

2. Dirígete a Ajustes de tienda → API Keys.

3. Haz clic en Crear nueva API Key.
   
   

Configuración de la API Key

• Nombre: Omniwallet

• Activa todas las casillas de permisos disponibles.

• Haz clic en Guardar.

• Copia el API Key generado (lo necesitarás más adelante).

2. Configurar Connectif en Omniwallet

1. Accede al panel de administración de Omniwallet.

2. Dirígete a Integraciones → CRM → Connectif.

3. Completa los campos:

   • Token de autenticación: pega el API Key copiado desde Connectif.

   • URL API:

     https://api.connectif.cloud/
     

4. Guarda la configuración.
   
   

Crear campos de contacto personalizados en Connectif

Para que la integración funcione correctamente, es obligatorio crear los siguientes campos personalizados donde se almacenará la información de Omniwallet.

⚠️ IMPORTANTE
Si no se crean todos los campos indicados a continuación, la integración no funcionará correctamente.

Acceso a los campos personalizados

1. En Connectif, ve a Contactos → Campos del contacto.

2. Filtra por Campos personalizados.

3. Haz clic en Añadir nuevo campo personalizado.

Campos obligatorios

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 la integración personalizada en Connectif

1. Ve a Ajustes de tienda → Integraciones personalizadas.

2. Haz clic en Crear nueva integración.

Configuración

• Nombre de la integración: Omniwallet

• Descripción: Integración Omniwallet

• Activa la opción “Habilitar enviar y recibir datos para esta integración”

• Haz clic en Guardar.
  
  

Eventos que se pueden ejecutar desde Connectif hacia Omniwallet

Dentro de la integración creada, ve a la pestaña Enviar datos y haz clic en Crear nuevo evento de envío.

Se pueden crear los siguientes eventos:

• Crear cliente en Omniwallet

• Enviar compra a Omniwallet

• Modificar puntos (sumar o restar)

Crear cliente en Omniwallet desde Connectif

Evento: “Nuevo cliente Omniwallet”

• Webhook URL:

https://api.omniwallet.cloud/cnf/contact-registered?ow_account=SUBDOMINIO

(Sustituye SUBDOMINIO por el subdominio de tu cuenta Omniwallet)

Cabeceras HTTP

Añade las siguientes cabeceras:

• Accept → application/json

• Authorization → Bearer API_TOKEN

• Content-Type → application/json

(API_TOKEN es el token generado en Omniwallet)

Conjunto de datos

• Email

  • Tipo: Email

  • Identificador: email

  • Obligatorio y clave primaria

• Name

  • Tipo: Texto

  • Identificador: name

  • Obligatorio

Workflow

Crea un workflow en Connectif para ejecutar este evento cuando:

• Se cree un nuevo contacto

• O el contacto entre en el programa de fidelización

Enviar una compra desde Connectif a Omniwallet

Evento: “Compra Omniwallet”

• Webhook URL:

https://api.omniwallet.cloud/cnf/points-record-registered?ow_account=SUBDOMINIO

Cabeceras HTTP

• Accept: application/json

• Authorization: Bearer API_TOKEN

• Content-Type: application/json

Conjunto de datos

• Email (Email – obligatorio, clave primaria)

• external_id (Texto – obligatorio)

• amount (Número decimal – obligatorio)

Crea un workflow que dispare este evento cuando se registre una compra.

Enviar email de bienvenida desde Connectif

Crear workflow de bienvenida

1. Ve a Workflows → Crear nuevo workflow.

2. Nodo Inicio:

   • Define si se envía a todos los clientes o a un segmento.

   • Decide si se ejecuta una vez o de forma recurrente.

3. Nodo Condición – “Tiene campo”:

   • Selecciona uno de los campos con la URL de descarga de la tarjeta.

   • Condición: No está vacío.

4. Nodo Acción – “Enviar email”:

   • Diseña el email.

   • Añade dos botones:

     • Google Wallet → {{google-wallet}}

     • Apple Wallet → {{apple-wallet}}

   • Configura asunto, remitente y ajustes generales.

   • Añade los campos personalizados como variables.

Realiza pruebas antes de activar el workflow en producción.

Añadir o quitar puntos desde Connectif

Evento: “Modificar puntos Omniwallet”

• Webhook URL:

https://api.omniwallet.cloud/cnf/modify-points?ow_account=SUBDOMINIO

Cabeceras HTTP

• Accept: application/json

• Authorization: Bearer API_TOKEN

• Content-Type: application/json

Conjunto de datos

• email (Email – obligatorio, clave primaria)

• amount (Número entero – obligatorio)

• action (Texto – obligatorio: add o subtract)

• type (Texto – obligatorio, motivo de la acción)

Workflow de ejemplo: dar puntos por completar un formulario

1. Inicio

   • Define alcance y recurrencia.
     
     

2. Condición – “Ha enviado un formulario web”
   
   

3. Acción – “Modificar puntos Omniwallet”

   • email → Email del usuario

   • amount → Literal (cantidad de puntos)

   • action → Literal (add o subtract)

   • type → Literal (descripción del motivo)

El workflow final permitirá sumar o restar puntos automáticamente según el comportamiento del usuario.