Puedes activar notificaciones push de Wallet desde cualquier Klaviyo Flow añadiendo una acción webhook que llame a la API de envío de notificaciones push de JeriCommerce.
Configurar la acción webhook ¶
Añadir una acción webhook
En Klaviyo Flow, haz clic en Add Action y elige Webhook. Esto envía una solicitud HTTP cada vez que un cliente llega a ese paso del flujo.
Definir la URL de destino
Pega la URL del endpoint de envío de notificaciones push en el campo Destination URL. Sustituye el marcador por el slug del programa, que encontrarás en el panel de JeriCommerce, en Settings > Technical > Program Information.
https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api/send-push
Añadir el encabezado API key
En la sección Headers, añade un encabezado:
- Key:
api-key - Value: tu clave API, disponible en Settings > Technical > API Keys.
Si aún no tienes una, crea una nueva clave en esa sección y copia el valor. Solo podrás verlo una vez.
Crear el cuerpo JSON
El cuerpo es una matriz JSON con un objeto por notificación. Cada objeto contiene estos campos:
| Campo | Obligatorio | Descripción |
|---|---|---|
email |
Sí | Correo del cliente. Usa la variable de perfil de Klaviyo {{ person.email|default:'' }}. |
header |
Sí | Título de la notificación que aparece en el Wallet Pass. |
body |
Sí | Contenido del mensaje de notificación. |
link |
No | URL o enlace profundo que se abre cuando el cliente pulsa la notificación. |
Ejemplo de cuerpo:
[
{
"email": "{{ person.email|default:'' }}",
"header": "Your reward is ready!",
"body": "You've unlocked a 10% discount. Tap to claim it.",
"link": "https://yourstore.com/rewards"
}
]
El cuerpo debe ser una matriz JSON, entre corchetes [ ], incluso si solo envías una notificación.
Usar variables ¶
Klaviyo y JeriCommerce admiten variables de plantilla, pero usan la misma sintaxis {{ }}, lo que puede causar conflictos. Para evitarlo, JeriCommerce ofrece una sintaxis alternativa para sus variables:
| Sistema | Sintaxis | Ejemplo |
|---|---|---|
| Klaviyo | {{ variable }} |
{{ person.first_name }} |
| JeriCommerce | <% variable %> |
<% first_name %> |
| En el dispositivo (Wallet) | %%variable%% |
%%balance%% |
Usa la sintaxis {{ }} de Klaviyo para los datos del perfil, como el correo o el nombre, y la sintaxis <% %> de JeriCommerce para los datos de fidelización, como el saldo o el nivel. Consulta estrategias de envío de notificaciones para ver la lista completa de variables disponibles.
Generador de webhooks ¶
Usa el Webhook Builder para generar la URL de destino, los encabezados y el cuerpo JSON listos para pegar en Klaviyo.