Puoi attivare notifiche push al wallet da qualsiasi Klaviyo Flow aggiungendo un'azione webhook che chiama l'API di invio push JeriCommerce.
Configura l'azione webhook ¶
Aggiungi un'azione webhook
Nel Klaviyo Flow, fai clic su Add Action e scegli Webhook. In questo modo viene inviata una richiesta HTTP ogni volta che un cliente raggiunge questo passaggio del flusso.
Imposta l'URL di destinazione
Incolla l'URL dell'endpoint di invio push nel campo Destination URL. Sostituisci il segnaposto con lo slug del programma, disponibile nella dashboard JeriCommerce in Settings > Technical > Program Information.
https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api/send-push
Aggiungi l'header della chiave API
Nella sezione Headers, aggiungi un nuovo header:
- Key:
api-key - Value: la chiave API, disponibile in Settings > Technical > API Keys
Se non hai ancora una chiave, creane una in quella sezione e copiane il valore: puoi visualizzarlo una sola volta.
Componi il corpo JSON
Il corpo è un array JSON con un oggetto per ogni notifica. Ogni oggetto include questi campi:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
email |
Sì | Email del cliente. Usa la variabile profilo Klaviyo {{ person.email|default:'' }} |
header |
Sì | Titolo della notifica mostrato sul wallet pass |
body |
Sì | Testo del messaggio |
link |
No | URL o link diretto che si apre quando il cliente tocca la notifica |
Esempio di corpo:
[
{
"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"
}
]
Il corpo deve essere un array JSON (racchiuso tra [ ]), anche se invii una sola notifica.
Usa le variabili ¶
Klaviyo e JeriCommerce supportano entrambi variabili modello, ma usano la stessa sintassi {{ }}, che può creare conflitti. Per evitarli, JeriCommerce supporta una sintassi alternativa per le proprie variabili:
| Sistema | Sintassi | Esempio |
|---|---|---|
| Klaviyo | {{ variable }} |
{{ person.first_name }} |
| JeriCommerce | <% variable %> |
<% first_name %> |
| Sul dispositivo (wallet) | %%variable%% |
%%balance%% |
Usa la sintassi {{ }} di Klaviyo per i dati del profilo (email, nome) e quella <% %> di JeriCommerce per i dati fedeltà (saldo, livello). Consulta le strategie di consegna delle notifiche per l'elenco completo delle variabili disponibili.
Webhook Builder ¶
Usa il Webhook Builder per generare l'URL di destinazione, gli header e il corpo JSON, pronti da incollare in Klaviyo.