Integración de Omniwallet con Klaviyo

Conecta tu programa de fidelización de Omniwallet con Klaviyo para sincronizar contactos, reflejar los niveles de tus clientes como segmentos, automatizar comunicaciones por email y recompensar acciones como canjes y reseñas con puntos. Esta guía explica qué hace la integración, cómo funciona y cómo configurarla paso a paso.

¿Qué hace la integración?

La integración entre Omniwallet y Klaviyo conecta tu programa de fidelización con tu plataforma de marketing y mensajería:

• Sincroniza los contactos de Omniwallet a Klaviyo. La creación del cliente se hace siempre primero en Omniwallet: cuando un cliente se da de alta en el programa de fidelización, se crea y se sincroniza en Klaviyo. La integración no crea clientes en sentido inverso (de Klaviyo a Omniwallet).
• Refleja los niveles como segmentos. Cada nivel de fidelización de Omniwallet se traduce en un segmento de Klaviyo, lo que permite filtrar y comunicar a cada grupo de clientes según su nivel.
• Automatiza comunicaciones. Puedes lanzar flujos de email en Klaviyo cuando un cliente cambia de nivel, canjea un premio o realiza otras acciones del programa.
• Recompensa acciones con puntos. Eventos como un canje completado o la publicación de una reseña pueden enviar puntos al cliente en Omniwallet.

¿Cómo funciona?

Cuando la conexión se establece correctamente, Omniwallet crea automáticamente en Klaviyo métricas, una lista y los segmentos necesarios para cubrir los niveles que tengas implementados en tu programa.

Métricas que Omniwallet envía a Klaviyo

Una vez conectada la integración, Omniwallet envía una serie de métricas (eventos) a Klaviyo. Estas métricas son las que puedes usar como activador al crear un flujo: en la pantalla Selecciona un activador, ve a la pestaña Tus métricas y, dentro de Omniwallet Loyalty & CDP, encontrarás las siguientes:

Cada una de estas métricas puede usarse como punto de entrada de un flujo para enviar comunicaciones (email, SMS, etc.) o para encadenar acciones en Klaviyo según el comportamiento del cliente en el programa de fidelización.

Propiedades de perfil que crea la integración

Al confirmar la conexión de cuentas, la integración crea y mantiene en cada perfil de Klaviyo una serie de propiedades personalizadas con los datos del cliente en Omniwallet. Las encuentras en la ficha del perfil, dentro de Detalles → Propiedades personalizadas, y puedes usarlas en tus emails y flujos mediante Liquid con el prefijo person.:

Los enlaces de wallet apuntan a https://wallet.omniwallet.cloud/loyalty/download/..., con la ruta ios para Apple Wallet y google para Google Wallet, e incluyen el identificador de tu cuenta (ow_account).

Configuración

Parte 1 — Conectar Klaviyo con Omniwallet (OAuth)

Novedad: la conexión entre cuentas ahora se realiza mediante OAuth. Ya no es necesario crear una API key manualmente ni configurar scopes: basta con autorizar la aplicación desde Klaviyo.

1. En Omniwallet, ve a Integraciones → CRM y haz clic en Klaviyo.
2. En la ventana de configuración de Klaviyo, pulsa Conectar con Klaviyo.
3. Se abrirá la ventana de autorización de Klaviyo. La primera pantalla avisa de que "La aplicación no se ha revisado" (es normal, ya que la app de Omniwallet aún no figura en el catálogo público de socios de Klaviyo). Pulsa Continuar.
4. A continuación, Klaviyo muestra la pantalla "Permite que Omniwallet Loyalty & CDP acceda a la información de tu cuenta", con el detalle de los permisos que se conceden:

   Permiso	Acceso
   Cuentas	Consulta los detalles de la cuenta
   Eventos	Crear, editar y eliminar eventos
   Lista	Crea, edita y elimina listas y miembros
   Perfiles	Crear, ver, editar y eliminar perfiles
   Segmentos	Crea, edita y elimina segmentos y membresías
   Suscripciones	Crea, edita y elimina el consentimiento y las suscripciones

   Revisa los permisos y autoriza la aplicación para completar la conexión.
5. Volverás automáticamente a Omniwallet con la cuenta ya conectada. Ahora:
   • Activa el interruptor Habilitado.
   • Configura Puntos por reseña si quieres recompensar con puntos las reseñas de tus clientes (puedes dejarlo en 0 y ajustarlo más adelante).
   • La opción Eliminar configuración al desactivar borra la configuración de la integración si la desactivas; déjala desmarcada si quieres conservar los ajustes.
   • Pulsa Guardar.

Si la conexión es correcta, Omniwallet creará en Klaviyo la métrica, la lista y los segmentos correspondientes a tus niveles.

Parte 2 — Sincronización de contactos (Omniwallet → Klaviyo)

La creación del cliente se realiza siempre primero en Omniwallet. Cuando un cliente se da de alta en el programa de fidelización, la integración lo crea automáticamente en Klaviyo y lo añade a la lista de Omniwallet, donde queda disponible para los segmentos y flujos. No es necesario crear ningún flujo para esta sincronización: ocurre de forma automática una vez la integración está conectada y habilitada (Parte 1).

La integración no crea contactos en sentido inverso. Los contactos no se envían de Klaviyo a Omniwallet; el alta siempre parte de Omniwallet.

Parte 3 — Email de bienvenida con la tarjeta (Apple Wallet y Google Wallet)

Crea un flujo que envíe un email de bienvenida al cliente en cuanto se da de alta, incluyendo los enlaces para descargar su tarjeta de fidelización tanto en Google Wallet como en Apple Wallet.

1. Crea un flujo y, como activador, en la pestaña Tus métricas selecciona Cliente Creado. Así, cada vez que se crea un cliente en Omniwallet (y se sincroniza a Klaviyo), entrará en este flujo.
2. Añade un paso de Email y diseña la plantilla de bienvenida.
3. Inserta dos botones o enlaces, uno para cada wallet, usando las propiedades de perfil con los enlaces de descarga. Por ejemplo:
   
   Hola, {{ person.first_name }}, ¡bienvenido/a a nuestro programa!
   Añade tu tarjeta a tu móvil:
   - Apple Wallet: {{ person.apple_wallet }}
   - Google Wallet: {{ person.google_wallet }}

Los enlaces apple_wallet y google_wallet son propiedades del perfil del contacto (no del evento), por lo que se acceden con {{ person.apple_wallet }} y {{ person.google_wallet }}. Consulta la lista completa de propiedades en la sección Propiedades de perfil que crea la integración.

Parte 4 — Flujos para los segmentos (niveles)

Para tener el filtrado por nivel en Klaviyo se usan los segmentos: por cada nivel que tengas en Omniwallet se crea un segmento en Klaviyo. Estos segmentos tienen la condición de actualizarse cuando cambia el campo level del contacto.

Para enviar un mensaje a los contactos que cambian de nivel, crea un flujo:

1. En Flujos, dentro de los recomendados, busca Añadido a segmento y haz clic.
2. Escoge el nivel (segmento) deseado.
3. Añade un paso de Email.

   Por defecto, Klaviyo activa la opción "Saltar perfiles a los que se ha enviado recientemente un correo electrónico", que evita enviar emails a contactos que ya han recibido alguno en las últimas 16 horas. Tenlo en cuenta al diseñar el flujo.

4. Crea una plantilla de correo o usa una predeterminada. Para acceder a los datos del contacto usa Liquid, por ejemplo:
   
   Hola, {{ person.first_name }}
   
   

Alternativa: en lugar del activador Añadido a segmento, puedes disparar el flujo directamente con las métricas de cambio de nivel Nivel Mejorado (subida) o Nivel Inferior (bajada) desde la pestaña Tus métricas. Úsalo cuando quieras reaccionar específicamente a la subida o bajada de nivel en lugar de a la entrada en un segmento concreto.

Parte 5 — Flujo para canjes en Omniwallet

Crea un flujo para reaccionar a los canjes realizados en Omniwallet:

1. Crea un flujo y, como activador, en la pestaña Tus métricas selecciona Pedido de Omniwallet Completado (el evento Omniwallet Order Completed).
2. Diseña el flujo (email, etiquetado, etc.) usando los campos Liquid disponibles para ese evento (ver referencia más abajo).

Parte 6 — Reseñas: configuración en Klaviyo y puntos en Omniwallet

6.1 Conectar las reseñas en Klaviyo

1. En Klaviyo, ve a la sección de Reseñas.
2. Conecta tu tienda (Shopify, WooCommerce, etc.).
3. En la configuración, indica la URL de tu tienda. Puedes sincronizar los contactos de la tienda a una lista específica, como la de Omniwallet.

   Si dejas la configuración por defecto, la sincronización será bidireccional.

4. Haz clic en Conectar. Te redirigirá a tu tienda para instalar la aplicación Klaviyo Reviews.
5. Una vez instalada, vuelve a Reseñas en Klaviyo y pulsa Primeros pasos. Te pedirá instalar Klaviyo Reviews; si todo va bien, aparecerá la pantalla para configurar el color de las reseñas.

Si el proceso se completó correctamente, en la sección de Métricas se crearán métricas nuevas de tu tienda y de reseñas.

6.2 Webhook para ganar puntos por reseña

1. Ve a Flujos y elige el activador Submitted Review.
2. Añade un paso de Webhook con tu header y la URL de tu tenant de Omniwallet.
3. Envía estos datos por Liquid en el cuerpo:

   {
     "event_name": "{{ event_name }}",
     "timestamp": "{{ event.time }}",
     "review_id": "{{ event.review_id }}",
     "review_email": "{{ event.review_email }}",
     "review_author": "{{ event.review_author }}",
     "review_content": "{{ event.review_content }}",
     "review_rating": "{{ event.review_rating }}",
     "review_verified": "{{ event.review_verified }}",
     "review_status": "{{ event.review_status }}",
     "review_title": "{{ event.review_title }}",
     "review_link": "{{ event.review_link }}",
     "review_has_media": "{{ event.review_has_media }}",
     "has_content": "{{ event.has_content }}",
     "is_store_review": "{{ event.is_store_review }}",
     "review_images": "{{ event.review_images }}",
     "product_external_id": "{{ event.product_external_id }}",
     "product": {
       "id": "{{ event.product.id }}",
       "handle": "{{ event.product.handle }}",
       "title": "{{ event.product.title }}",
       "vendor": "{{ event.product.vendor }}",
       "status": "{{ event.product.status }}",
       "images": "{{ event.product.images }}"
     },
     "structured_product": {
       "id": "{{ event.structured_product.id }}",
       "skus": "{{ event.structured_product.skus }}",
       "handle": "{{ event.structured_product.handle }}",
       "product_name": "{{ event.structured_product.product_name }}",
       "url": "{{ event.structured_product.url }}",
       "title": "{{ event.structured_product.title }}",
       "image_url": "{{ event.structured_product.image_url }}"
     },
     "store_url": "{{ event.store_url }}"
   }

Recuerda configurar el campo Puntos por reseña en la ventana de la integración de Klaviyo en Omniwallet (Parte 1) para definir cuántos puntos recibe el cliente por cada reseña.

Referencia: campos Liquid del evento Order Completed

Variables de nivel superior (datos de la orden)

Se acceden directamente desde el objeto event:

Variables para los ítems (iteración)

Como items es una lista, debes iterar sobre ella para acceder a los detalles de cada producto:

Ejemplo de bucle completo

{% for item in event.items %}
  Producto: {{ item.product_name }} ({{ item.sku }})
  Cantidad: {{ item.quantity }}
{% endfor %}

Resumen de requisitos

• Cuenta de Klaviyo con permisos de administrador para autorizar la aplicación.
• Conexión establecida por OAuth desde Integraciones → CRM → Klaviyo en Omniwallet (botón Conectar con Klaviyo), con la integración Habilitada y guardada.
• Flujos creados en Klaviyo según las acciones que quieras cubrir: comunicaciones por nivel, canjes (Omniwallet Order Completed) y reseñas (Submitted Review). La sincronización de contactos (Omniwallet → Klaviyo) es automática y no requiere flujo.
• Para reseñas: tienda conectada en Klaviyo (Shopify, WooCommerce, etc.) con Klaviyo Reviews instalado, y Puntos por reseña configurados en Omniwallet.