Biblioteca de ayuda - Integración con SALESmanago
Encuentra la documentación completa y detallada de todas las funcionalidades de SALESmanago.
Integración de Omniwallet con SALESmanago
Esta guía te explicará cómo integrar SALESmanago con Omniwallet para poder potenciar la estrategia de loyalty de forma completa.
La integración permite:
- Dar de alta clientes nuevos en el programa de fidelización
- Enviar la tarjeta wallet a través de SALESmanago
- Registrar las compras y enviarlas a Omniwallet para que asigne los puntos correspondientes al valor de las compras
- Enviar a SALESmanago la cantidad de puntos que tiene cada cliente en tiempo real
- Informar a SALESmanago a través de eventos cuando se suman y restan puntos del contacto
- Mandar a Omniwallet una acción para añadir puntos, por ejemplo en campañas concretas
Conectar Connectif con SALESmanago
En Omniwallet tienes que acceder a Integraciones > CRM > SALESmanago. Ahí debes rellenar los campos requeridos.
Esta información la encontrarás dentro de Sales Manago, en el apartado Integraciones > API
El único cambio necesario a la hora de traspasar esta información en Omniwallet es en el campo Endpoint, donde después de .pl hay que añadir /api/.
Endpoints para enviar información desde SALESmanago a Omniwallet
Para informar a Omniwallet desde SALESmanago del registro de un usuario o de un evento, como una compra, es necesario utilizar endpoints. Estos endpoints se añaden siempre dentro de un automatismo de SALESmanago a través de la acción “Enviar información sobre regla ejecutada”.
Los endpoints se configuran de la siguiente forma:
- Registro de usuario a Omniwallet: https://api.omniwallet.cloud/sm/contact-registered?ow_account=nombre_de_la_cuenta_omniwallet
- El parámetro ow_account es el subdominio de la cuenta de Omniwallet
- Registro de compra para que Omniwallet añada puntos: https://api.omniwallet.cloud/sm/points-record-registereed?ow_account=nombre_de_la_cuenta_omniwallet
- El parámetro ow_account es el subdominio de la cuenta de Omniwallet
- Acción para añadir o restar unos puntos determinados: https://api.omniwallet.cloud/sm/modify-points?ow_account=nombre_de_la_cuenta_omniwallet&action=add&qty=100&type=premio
- El parámetro ow_account es el subdominio de la cuenta de Omniwallet
- En qty añadimos los puntos que queremos dar y en type el motivo
Así se ve la acción en el automatimso de SALESmanago:
En los campos “Iniciar sesión” y “Contraseña” hay que añadir los datos de acceso a la cuenat de Omniwallet.
¿Cómo puedo crear un cliente en Omniwallet desde SALESmanago?
- Evento: El contacto se ha añadido al sistema
- Condición (opcional)
- Acción: Enviar información sobre regla ejecutada (llamada a un endpoint para registrar el usuario en Omniwallet: https://api.omniwallet.cloud/sm/contact-registered?ow_account=nombre_de_la_cuenta_omniwallet
Tras ese registro en Omniwallet, Omniwallet envía a SALESmanago estos datos del usuario y los añade 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
¿Cómo enviar un email de bienvenida desde SALESmanago?
Primero es necesario deshabilitar el envío del email de bienvenida desde Omniwallet
Una vez Omniwallet ha mandado los custom details con la información del usuario a SALESmanago, ya se puede mandar el email.
El email debe contener los enlaces de descarga de la tarjeta en Android, Iphone. También es necesario incluir el acceso al portal de Omniwallet del usuario donde podrá ver los puntos que tiene y canjearlos por los regalos del catálogo.
Todos estos campos son detalles estándar de SALESmanago que se añaden al correo como placeholders: $cst.nombre_del_detalle$
¿Cómo enviar una compra desde SALESmanago a Omniwallet?
Para informar a Omniwallet que se ha producido una compra y que debe añadir puntos, es necesario crear el siguiente automatismo:
- Evento: Ocurrió un nuevo evento externo (definir si es una purchase u otro evento)
- Condición (opcional)
- Acción: Enviar información sobre regla ejecutada (llamada a un endpoint para registrar el usuario en Omniwallet: https://api.omniwallet.cloud/sm/points-record-registereed?ow_account=nombre_de_la_cuenta_omniwallet
Omniwallet lee la información sobre esa compra y le otorga los puntos que sean pertinentes.
Después actualiza en SALESmanago los valores del custom detail omniwallet.points.
Cuando un usuario canjea sus puntos, Omniwallet envía una transacción al usuario en SALESmanago con la información de ese canjeo y le actualiza el campo puntos.
Otras acciones que se pueden implementar desde SALESmanago
Añadir unos puntos determinados
Si quieres premiar a tus clientes por haber hecho alguna acción en tu web, por ejemplo haber comprado durante unas fechas determinadas o unos productos determinados, puedes ejecutar una acción a través de un automatismo de SALESmanago que ordene a Omniwallet añadir los puntos que quieras.
En la acción del automatismo, haremos esta llamada a un endpoint, que puede ser por ejemplo https://nombre_tienda.omniwallet.net/sm/modify-points&action=add&qty=100&type=premio
Recordar a un cliente los puntos que tiene
Puedes enviar periódicamente un email recordando a un cliente los puntos que tiene. Recuerda que los puntos se añaden en el email mediante el siguiente placeholder: $cst.custom.omniwallet_points$
También puedes mandar un email a un cliente cada vez que se le modifiquen los puntos, por ejemplo para listar en un email los regalos que ya puede canjear con sus puntos. Esto lo haremos seleccionando el evento “Detalle de un contacto modificado”, en la acción del automatismo.
