Complete guide: how to integrate Omniwallet with SALESmanago

Requisitos previos

Antes de empezar, asegúrate de disponer de:

• Cuenta activa en Omniwallet

• Cuenta activa en SALESmanago

• Acceso a la configuración de API de SALESmanago

Paso 1. Configurar SALESmanago en Omniwallet

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

2. Ve a:
   Integraciones → CRM → SALESmanago

3. Rellena los campos requeridos.

Esta información se obtiene en SALESmanago en:
Integraciones → API

Importante: Endpoint

En el campo Endpoint, debes añadir /api/ justo después de .pl.

Ejemplo:

https://app.salesmanago.pl/api/

Guarda los cambios.

Paso 2. Endpoints disponibles para la integración

Los endpoints se utilizan dentro de automatismos de SALESmanago, mediante la acción:

“Enviar información sobre regla ejecutada”

2.1 Registro de usuario en Omniwallet

https://api.omniwallet.cloud/sm/contact-registered?ow_account=nombre_de_la_cuenta_omniwallet

• ow_account: subdominio de la cuenta de Omniwallet.

2.2 Registro de compra (asignación de puntos)

https://api.omniwallet.cloud/sm/points-record-registereed?ow_account=nombre_de_la_cuenta_omniwallet

Omniwallet procesa la compra y asigna los puntos correspondientes.

2.3 Añadir o restar puntos manualmente

https://api.omniwallet.cloud/sm/modify-points?ow_account=nombre_de_la_cuenta_omniwallet&action=add&qty=100&type=premio

Parámetros:

• action: add / subtract

• qty: cantidad de puntos

• type: motivo de la acción

Autenticación

En los campos “Iniciar sesión” y “Contraseña” del automatismo de SALESmanago, debes introducir las credenciales de acceso a la cuenta de Omniwallet.

Paso 3. Crear un cliente en Omniwallet desde SALESmanago

Automatismo recomendado

• Evento: El contacto se ha añadido al sistema

• Condición: (opcional)

• Acción: Enviar información sobre regla ejecutada

  • Endpoint: contact-registered

Datos que Omniwallet devuelve a SALESmanago

Tras el alta, Omniwallet envía y guarda como custom details:

• custom.omniwallet_download_pkpass_wallet

• custom.omniwallet_download_pkpass_android

• custom.omniwallet_download_pkpass_ios

• custom.omniwallet_id

• custom.omniwallet_points

• custom.omniwallet_ean

Paso 4. Enviar email de bienvenida desde SALESmanago

1. Deshabilita el email de bienvenida en Omniwallet.

2. Crea el email en SALESmanago.

3. Incluye:

   • Enlaces de descarga Apple Wallet y Google Wallet

   • Acceso al portal de Omniwallet

   • Información de puntos

Los datos se insertan mediante placeholders estándar:

$cst.custom.omniwallet_points$

Paso 5. Enviar compras desde SALESmanago a Omniwallet

Automatismo recomendado

• Evento: Ocurrió un nuevo evento externo (purchase u otro)

• Acción: Enviar información sobre regla ejecutada

  • Endpoint: points-record-registereed

Omniwallet:

• Lee la compra

• Asigna los puntos

• Actualiza automáticamente custom.omniwallet_points en SALESmanago

Canjeo de puntos

Cuando un cliente canjea puntos:

• Omniwallet envía un evento a SALESmanago.

• Se registra la transacción.

• Se actualiza el saldo de puntos del contacto.

Otras acciones avanzadas desde SALESmanago

Añadir puntos por campañas específicas

Ideal para promociones, fechas concretas o productos determinados.

Endpoint:

https://nombre_tienda.omniwallet.net/sm/modify-points&action=add&qty=100&type=premio

Recordar al cliente sus puntos

• Emails periódicos con:

$cst.custom.omniwallet_points$

Comunicación tras modificación de puntos

• Evento: Detalle de un contacto modificado

• Permite enviar emails automáticos cuando el cliente alcanza nuevos umbrales de canje.

Resultado final

Con esta integración:

• SALESmanago se convierte en el orquestador del marketing.

• Omniwallet gestiona la lógica de fidelización.

• El cliente recibe una experiencia coherente, personalizada y automatizada.