Vous pouvez déclencher des notifications push Wallet depuis n’importe quel flux Klaviyo en ajoutant une action webhook qui appelle l’API d’envoi de notifications push JeriCommerce.

Configurer l’action webhook

1

Ajouter une action webhook

Dans votre flux Klaviyo, cliquez sur Add Action et choisissez Webhook. Une requête HTTP est alors envoyée chaque fois qu’un client arrive à cette étape du flux.

2

Définir l’URL de destination

Collez l’URL du point de terminaison d’envoi de notifications push dans le champ Destination URL. Remplacez le paramètre fictif par le slug de votre programme. Vous le trouverez dans le tableau de bord JeriCommerce sous Settings > Technical > Program Information.

https://api.jericommerce.com/v1/programs/{program_slug}/integrations/api/send-push
3

Ajouter l’en-tête de clé API

Dans la section Headers, ajoutez un nouvel en-tête :

  • Key : api-key
  • Value : votre clé API, disponible sous Settings > Technical > API Keys.

Si vous n’en avez pas encore, créez une clé dans cette section et copiez sa valeur : vous ne pourrez la consulter qu’une seule fois.

4

Rédiger le corps JSON

Le corps est un tableau JSON contenant un objet par notification. Chaque objet comporte les champs suivants :

Champ Obligatoire Description
email Oui Adresse e-mail du client. Utilisez la variable de profil Klaviyo {{ person.email|default:'' }}
header Oui Titre de la notification affiché sur le pass Wallet
body Oui Texte du message de notification
link Non URL ou lien profond ouvert lorsque le client touche la notification

Exemple de corps :

[
  {
    "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"
  }
]

Le corps doit être un tableau JSON (encadré par [ ]), même pour une seule notification.

Configuration du webhook dans Klaviyo Flows
Exemple de configuration d’un webhook dans Klaviyo Flows

Utiliser des variables

Klaviyo et JeriCommerce prennent tous deux en charge les variables de modèle, mais ils utilisent la même syntaxe {{ }}, ce qui peut créer des conflits. Pour les éviter, JeriCommerce prend également en charge une syntaxe alternative pour ses variables :

Système Syntaxe Exemple
Klaviyo {{ variable }} {{ person.first_name }}
JeriCommerce <% variable %> <% first_name %>
Appareil (Wallet) %%variable%% %%balance%%

Utilisez la syntaxe Klaviyo {{ }} pour les données de profil (e-mail, nom) et la syntaxe JeriCommerce <% %> pour les données de fidélité (solde, niveau). Consultez les stratégies de diffusion des notifications pour la liste complète des variables disponibles.

Webhook Builder

Utilisez le Webhook Builder pour générer l’URL de destination, les en-têtes et le corps JSON, prêts à être collés dans Klaviyo.

Ouvrir le Webhook Builder

Renseignez le slug du programme et le contenu de la notification, puis copiez directement les valeurs dans l’action webhook de votre flux Klaviyo.