> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/klaviyo/user-guide.md).

# Guide utilisateur

Segmentez et activez les cas d’usage Wallet courants à partir des flux et campagnes Klaviyo.

Klaviyo reste la couche d'orchestration.

The Wallet Crew fournit deux éléments de base clés dans Klaviyo :

* des propriétés de profil pour cibler les clients en fonction de l'état du Wallet
* des liens de téléchargement de carte personnalisés avec `neostore.authenticationToken`

<details>

<summary><strong>Exemples concrets</strong></summary>

* Une campagne de rappel cible les clients qui n'ont pas installé la carte.
* Un flux post-installation accueille les clients avec un message spécifique au Wallet.
* Un flux post-installation déclenche une notification Wallet avec un message d'intégration.
* Une mise à jour de l'abonnement à une liste dans le formulaire d'inscription The Wallet Crew alimente les messages basés sur le consentement dans Klaviyo.

</details>

### Envoyer un e-mail aux clients qui n'ont pas de carte installée

Ce modèle cible les profils où le jeton existe, mais où l'état du Wallet indique « non installé ».

{% stepper %}
{% step %}

#### Construire le segment

Un segment dynamique peut être créé pour correspondre à :

* `neostore.authenticationToken` est défini
* et au moins un état de fournisseur de Wallet n'est pas installé

L'état du Wallet est généralement exposé sous forme de propriétés de profil similaires à :

* `neostore.wallet.loyaltyCard.Apple`
* `neostore.wallet.loyaltyCard.Google`

La logique de segment utilise souvent :

* l'état Apple n'est pas égal à `Installé`
* OU l'état Google n'est pas égal à `Installé`

{% hint style="info" %}
Les propriétés d'état du Wallet dépendent du type de carte et de la configuration du tenant.

La validation la plus sûre consiste à inspecter un profil synchronisé dans Klaviyo et à copier le chemin de la propriété.
{% endhint %}

{% hint style="info" %}
La validation peut commencer en prévisualisant quelques profils correspondants et en vérifiant leurs propriétés d'état du Wallet.
{% endhint %}
{% endstep %}

{% step %}

#### Créer la campagne

Une campagne peut ensuite cibler ce segment.

Cela permet de concentrer les messages sur les clients qui n'ont pas encore adopté Wallet.
{% endstep %}

{% step %}

#### Insérer un lien de téléchargement de carte

Les modèles Klaviyo peuvent insérer le jeton avec :

`{{person | lookup:'neostore.authenticationToken' }}`

Il existe deux destinations courantes.

* Téléchargement / inscription de carte

```
https://app.neostore.cloud/<tenantId>/mail?neo.authToken={{person | lookup:'neostore.authenticationToken' }}
```

* Page de Carte (confirmation)

```
https://app.neostore.cloud/<tenantId>/mail/confirm?neo.authToken={{person | lookup:'neostore.authenticationToken' }}
```

`<tenantId>` est l'identifiant du tenant.

{% hint style="info" %}
Le nom d'hôte peut différer lorsqu'un domaine personnalisé est configuré pour le tenant.

La validation peut commencer en mode aperçu de Klaviyo en vérifiant que l'URL rendue contient un `neo.authToken` non vide.
{% endhint %}
{% endstep %}
{% endstepper %}

### Envoyer un e-mail après l'installation de la carte

Ce modèle démarre un flux après l'enregistrement d'une métrique d'installation.

{% stepper %}
{% step %}

#### Confirmer que la métrique d'installation existe

La métrique apparaît dans Klaviyo dès la réception du premier événement d'installation.
{% endstep %}

{% step %}

#### Créer un flux déclenché par une métrique

1. Créer un nouveau flux.
2. Utilisez un **déclencheur de métrique**.
3. Sélectionnez la métrique d'installation du Wallet (exemple : « Wallet Installed »).
   {% endstep %}

{% step %}

#### Ajouter le contenu du message

Le modèle de lien vers la page de carte peut être réutilisé pour les messages post-installation. C'est utile pour les messages de « bienvenue » et d'« étape suivante ».

Dans de nombreux cas, l'URL de confirmation (`/mail/confirm`) est préférable ici parce que la carte existe déjà.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Le nom exact de la métrique dépend de la configuration du connecteur.

La métrique apparaît dans Klaviyo dès que le premier événement est reçu.

Voir [Événements et modèle de données](/connectors/fr/marketing-automation/klaviyo/events-and-data-model.md).
{% endhint %}

### Envoyer une notification Wallet

Les notifications Wallet peuvent être déclenchées depuis un flux Klaviyo à l'aide d'une action webhook appelant l'écouteur Klaviyo de The Wallet Crew.

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2F0qclenoWo3cs0lJkFUcy%2Fimage.png?alt=media&amp;token=788c00c0-5b3c-499e-8537-301beada28a8" alt="" width="262"><figcaption><p>Exemple de notification Wallet pour un anniversaire</p></figcaption></figure></div>

Ce modèle convient à tout moment à fort enjeu dans le parcours client. Les événements du cycle de vie Wallet, les commandes, les visites en magasin et les étapes clés peuvent devenir des déclencheurs. L'orchestration Klaviyo peut ensuite combiner la segmentation, le timing et les règles de fréquence pour garder les messages Wallet pertinents et opportuns.

{% columns %}
{% column %}

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FtZuMAkxfVPPRTogc62eC%2Fimage.png?alt=media&amp;token=15817f94-c3a2-43f4-a07f-3dbffc0d06db" alt="Klaviyo flow: webhook action configuration for a wallet notification" width="211"><figcaption><p>Flux webhook post-installation du Wallet.</p></figcaption></figure></div>
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FPSxQ7pWbGqh8k6Ra9Ul0%2Funknown.png?alt=media&amp;token=1bab184a-3fd4-4be6-9c03-858524e5583e" alt="Klaviyo flow: webhook payload example used to trigger a wallet notification" width="219"><figcaption><p>Flux webhook post-commande</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Le comportement des notifications diffère entre Apple Wallet et Google Wallet.

Détails : [Notifications push](/guides-animation/fr/engagement-and-animation/automatisation/push-notifications.md).
{% endhint %}

{% stepper %}
{% step %}

#### Créer le flux

Exemple de configuration :

* Nom du flux : `Après installation (tag neostore)`
* Déclencheur : « lorsqu'une personne a installé le Wallet »
  {% endstep %}

{% step %}

#### Ajouter une action webhook

Utilisez le point de terminaison de l'écouteur Klaviyo de The Wallet Crew :

`https://app.neostore.cloud/api/<tenantId>/webhooks/listeners/klaviyo/passes/pushUpdate`

Le webhook doit inclure le `X-API-KEY` en-tête avec une clé API The Wallet Crew qui inclut `tenant.klaviyo.listener` l'autorisation d'écriture.
{% endstep %}

{% step %}

#### Utilisez la charge utile JSON ci-dessous

La charge utile identifie la carte et ajoute un message de notification dans `additionalData`.

{% code title="Corps du webhook Klaviyo (JSON)" %}

```json
{
  "identifiers": {
    "id": "{{ person| lookup:'neostore.wallet.loyaltyCard.passId' }}"
  },
  "additionalData": {
    "message_body": "Bienvenue dans la famille, {{ person.first_name }} ! 🤗\nCumulez des points à chaque achat et débloquez des récompenses au fil du temps. Il est temps de profiter des avantages ! 💖"
  }
}
```

{% endcode %}

{% hint style="info" %}
La propriété utilisée pour résoudre l'identifiant de la carte peut différer selon le type de carte et la configuration du tenant.

La validation peut commencer en inspectant un profil Klaviyo et en confirmant quelle propriété stocke l'identifiant de la carte.
{% endhint %}
{% endstep %}
{% endstepper %}

### Comportement d'abonnement et de désabonnement

Les mises à jour d'abonnement aux listes peuvent être pilotées par les champs de consentement de The Wallet Crew.

Cela nécessite :

* une clé privée Klaviyo avec les autorisations Listes + Abonnements
* une seule liste `listId` configuré, ou une implémentation de script multi-listes

Détails de configuration : [Configuration du consentement et de l'abonnement aux listes](/connectors/fr/marketing-automation/klaviyo/setup.md#consent-and-list-subscription-configuration).

Lorsque le consentement est capturé pendant l'inscription, le connecteur peut abonner le profil à la liste configurée. Lorsque le consentement est retiré, le connecteur peut mettre à jour le statut d'abonnement en conséquence.

### Dépannage lors de la création de campagnes

#### Le lien s'affiche mais le jeton est vide

* Confirmer `neostore.authenticationToken` existe sur le profil.
* Confirmez que le profil est passé par le flux de synchronisation utilisé pour la rétroalimentation.
* Confirmez que le modèle utilise `lookup:'neostore.authenticationToken'`.
* Confirmez que le profil quitte le segment utilisé pour la rétroalimentation du jeton (exemple : `profils TWC non synchronisés`) après l'exécution du flux de synchronisation.
* Si le jeton manque sur de nombreux profils, revisitez [Configuration](/connectors/fr/marketing-automation/klaviyo/setup.md).

#### Les clients arrivent sur la mauvaise page

Il existe deux URL.

* `/mail` ouvre la page d'inscription.
* `/mail/confirm` ouvre la page de Carte.

#### La logique de segment pour l'état installé est incorrecte

* Confirmez que le segment vérifie les propriétés Apple et Google.
* Confirmez que la casse de la valeur stockée correspond à la condition du segment (exemple : `Installé`).

### FAQ

<details>

<summary><strong>Qui est généralement responsable des campagnes ?</strong></summary>

Les campagnes, segments et flux sont gérés dans Klaviyo.

The Wallet Crew gère l'exécution Wallet et les événements du cycle de vie du Wallet.

</details>

<details>

<summary><strong>Quel lien doit être utilisé : <code>/mail</code> ou <code>/mail/confirm</code>?</strong></summary>

`/mail` est généralement utilisé pour les parcours de téléchargement et d'inscription de carte.

`/mail/confirm` est généralement utilisé lorsqu'une carte existe déjà et que l'objectif est d'ouvrir directement la page de carte.

</details>

<details>

<summary><strong>Une notification Wallet peut-elle être envoyée si la carte n'est pas installée ?</strong></summary>

Non. Les notifications Wallet nécessitent au moins une installation active sur un appareil.

Une solution de secours courante consiste à utiliser d'abord l'e-mail ou le SMS pour distribuer un lien de téléchargement de carte, puis à déclencher des notifications Wallet après un événement d'installation.

</details>

<details>

<summary><strong>Comment valider que la personnalisation fonctionne avant d'envoyer une campagne ?</strong></summary>

La validation peut commencer en mode aperçu de Klaviyo en vérifiant que l'URL rendue contient un non vide `neo.authToken`.

La validation du profil peut se faire en confirmant `neostore.authenticationToken` existe sur quelques profils de test. Détails de configuration : [Configuration](/connectors/fr/marketing-automation/klaviyo/setup.md).

</details>

<details>

<summary><strong>Quelle est la manière la plus sûre de tester les notifications Wallet ?</strong></summary>

La plupart des équipes utilisent d'abord un environnement de test et conservent une petite liste de cartes de test internes installées sur de vrais appareils.

Le comportement et les limites des notifications dépendent des règles d'Apple Wallet et de Google Wallet. Référence : [Notifications push](/guides-animation/fr/engagement-and-animation/automatisation/push-notifications.md).

</details>

<details>

<summary><strong>Comment éviter d'envoyer trop de notifications Wallet ?</strong></summary>

Les notifications Wallet sont très visibles. Leur usage excessif peut entraîner des désabonnements et de la lassitude.

Klaviyo peut imposer des plafonds de fréquence et des segments d'éligibilité. Une protection courante cible uniquement les profils avec un statut de carte installée et une activité récente.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/marketing-automation/klaviyo/user-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.