> 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/setup.md).

# Configuration

Connecter The Wallet Crew et Klaviyo en toute sécurité, puis valider que les événements Wallet et les propriétés de profil se synchronisent correctement entre les deux plateformes.

Cette configuration relie **Klaviyo** (segmentation, flux, campagnes) à **The Wallet Crew** (l'exécution du Wallet et les signaux du cycle de vie).

Klaviyo a besoin de deux choses :

* des identifiants pour que The Wallet Crew puisse envoyer des événements et mettre à jour les propriétés de profil Klaviyo
* un flux de webhook afin que Klaviyo puisse demander une rétro-alimentation de `neostore.authenticationToken` pour les profils existants

## Prérequis

L'accès est requis des deux côtés.

* **The Wallet Crew**: accès à la console d'administration et aux fichiers de configuration avancés.
* **Klaviyo**: accès pour créer des clés API, des segments, des flux et des webhooks. Klaviyo nécessite un **conforme à la 2FA** compte pour activer les webhooks.
* Un profil de test existe dans Klaviyo avec un e-mail et/ou un numéro de téléphone connus.
* L'environnement cible est identifié (staging ou production).

## Configuration de The Wallet Crew

The Wallet Crew utilise le connecteur Klaviyo pour envoyer des événements du cycle de vie du Wallet dans Klaviyo, maintenir les propriétés du profil et, en option, gérer les abonnements aux listes en fonction du consentement collecté dans les parcours d'inscription.

### Configurez le connecteur dans The Wallet Crew

Ouvrez les paramètres d'intégration Klaviyo dans la console d'administration The Wallet Crew (**Données et intégrations → Connecteurs → Automatisation marketing → Klaviyo**).

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/integrations/klaviyo" class="button secondary" data-icon="chevrons-right">Ouvrir les paramètres du connecteur Klaviyo</a></p>

Les paramètres généraux stockent l'ID du site Klaviyo et la clé API privée Klaviyo.

**Valeurs Klaviyo requises**

Les valeurs Klaviyo sont disponibles à `https://www.klaviyo.com/settings/account/api-keys`.

* **ID du site** (`siteId`) correspond à **Clé API publique / ID du site** dans Klaviyo.
* **Clé API privée** (`privateApiKey`) est une **nouvelle** clé privée créée pour The Wallet Crew.

**Autorisations requises sur la clé privée Klaviyo**

Les autorisations minimales dépendent des fonctionnalités activées.

* Toujours requis
  * Événements : **Accès complet**
* Requis lorsque la synchronisation des abonnements aux listes est activée
  * Listes : **Accès complet**
  * Profils : **Accès complet**
  * Abonnements : **Accès complet**

<div data-with-frame="true"><figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FWxpWTaMCS0r5wb3KjNiE%2Fdocumentation-klaviyo-todo-alt-image-58-png.png?alt=media&#x26;token=a2184c95-4faa-4dd5-994f-e9f53c1d87e1" alt="Klaviyo API keys screen showing permissions for a private key"><figcaption><p>Assurez-vous que les autorisations de la clé privée correspondent aux capacités attendues.</p></figcaption></figure></div>

{% hint style="warning" %}
Si les événements n'apparaissent pas dans Klaviyo, la première vérification concerne les autorisations de la clé privée Klaviyo.
{% endhint %}

### Activez l'étape Klaviyo dans `/server/flows.yml`

Le `klaviyo` L'étape envoie l'événement d'inscription lorsqu'un client s'inscrit via le flux. Les événements d'installation et de désinstallation n'ont pas besoin d'une étape de flux : ils sont envoyés à chaque Carte dès que le connecteur Klaviyo est configuré.

{% hint style="info" %}
Le `klaviyo` L'étape peut être ajoutée à n'importe quel flux d'inscription. Dans l'exemple, `shopify` est l'étape du connecteur Shopify de ce locataire d'exemple ; elle n'est pas requise par Klaviyo. Les autres étapes dépendent du flux.
{% endhint %}

{% code title="/server/flows.yml" %}

```yaml
flux :
  - type: userRegistration
    nom : utilisateur
    étapes :
      - type: shopify
      - type: Carte
        passType: user
      - type : klaviyo
      - type: mail
        mailTemplate: downloadCarte
```

{% endcode %}

### Configuration du consentement et des abonnements aux listes

Le consentement collecté dans le formulaire d'inscription peut piloter les abonnements aux listes : définissez **Identifiant de liste Klaviyo** et **Activer la prise en charge des SMS** sur la **Général** onglet, comme décrit dans [Abonnements aux listes](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/klaviyo/reference.md#list-subscriptions).

## configuration Klaviyo

`neostore.authenticationToken` est la pierre angulaire de l'identité pour les liens authentifiés.

Lorsque cette propriété existe sur un profil Klaviyo, les e-mails et les SMS peuvent inclure des liens qui ouvrent la page de Wallet correcte pour ce client.

### Créer le segment « TWC unsynced profiles »

Ce segment cible les profils auxquels le jeton manque.

1. Allez dans `https://www.klaviyo.com/lists/create` et sélectionnez **Segment**.
2. Nom : `TWC unsynced profiles`.
3. Définition :
   * **Propriétés concernant une personne**
   * `neostore.authenticationToken`
   * `n'est pas défini`

{% hint style="warning" %}
Une faute de frappe dans cette règle empêche la rétro-alimentation. C'est l'erreur de configuration la plus courante.
{% endhint %}

### Créer le flux de synchronisation des profils

Ce flux appelle le webhook The Wallet Crew pour synchroniser le jeton des profils entrant dans le segment.

{% stepper %}
{% step %}

#### Créer un flux

* Allez dans `https://www.klaviyo.com/flows/create`.
* Créer à partir de zéro.
* Nom : `synchroniser les profils TWC non synchronisés`.
* Déclencheur : « Lorsqu'une personne rejoint TWC unsynced profiles ».
  {% endstep %}

{% step %}

#### Ajouter une action webhook

Définissez l'URL de destination du webhook :

`https://<host>/api/<tenantId>/webhooks/listeners/klaviyo/profiles/sync` (hôte : voir [Environnements et URL](https://docs.thewalletcrew.io/connectors/fr/marketing-automation.md#environments-and-urls))

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

Ajoutez un en-tête :

* Clé : `X-API-KEY`
* Valeur : une clé API créée dans The Wallet Crew qui inclut la `tenant.klaviyo.listener` permission d'écriture

Corps (JSON) :

```json
{
  "email": "{{ person.email }}",
  "phone_number": "{{ person.phone_number }}"
}
```

{% endstep %}

{% step %}

#### Activez, puis rétroalimentez les profils passés

* Activez le flux.
* Dans le menu du flux, utilisez **Ajouter des profils passés**.
* Sélectionnez « depuis le début ».
* Lancez la rétro-alimentation.

Cela force l'évaluation et la synchronisation des profils existants.
{% endstep %}
{% endstepper %}

## Dépannage

Ces vérifications expliquent la plupart des situations « c'est configuré mais rien ne se passe ».

| Symptôme                                                   | Vérifier                                                                                                                                                                                                                   |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Les événements n'apparaissent pas dans Klaviyo             | La clé privée Klaviyo a **table Events** permission. Pour les événements d'inscription, le flux exécuté inclut le `klaviyo` étape.                                                                                         |
| Les mises à jour des abonnements ne fonctionnent pas       | La clé privée a **Listes**, **Profils** et **Abonnements** autorisations.                                                                                                                                                  |
| Le jeton est toujours manquant après la rétro-alimentation | La règle du segment est exacte (`neostore.authenticationToken` **n'est pas défini**), le flux de synchronisation est **activé**, et l'action du webhook affiche des exécutions réussies dans l'historique du flux Klaviyo. |
| Le webhook échoue                                          | L'en-tête est `X-API-KEY`. La clé API a la `tenant.klaviyo.listener` permission d'écriture. L'URL de destination utilise le bon `<tenantId>`.                                                                              |
| Les webhooks ne peuvent pas être activés dans Klaviyo      | Le compte Klaviyo n'est pas conforme à la 2FA.                                                                                                                                                                             |
| Le lien s'affiche sans jeton                               | Le modèle utilise `lookup:'neostore.authenticationToken'`, le profil est passé par le flux de synchronisation, et le jeton existe sur le profil.                                                                           |
| La logique du segment pour l'état installé est incorrecte  | Le segment vérifie les propriétés Apple et Google, et la casse de la valeur stockée correspond à la condition du segment (exemple : `Installé`).                                                                           |
| Les clients arrivent sur la mauvaise page                  | `/mail` ouvre la mise en page d'inscription et `/mail/confirm` ouvre la page de Carte.                                                                                                                                     |

## FAQ

<details>

<summary><strong>L'e-mail est-il requis pour synchroniser <code>neostore.authenticationToken</code>?</strong></summary>

L'e-mail est l'identifiant le plus courant. Le numéro de téléphone peut également être fourni.

Le webhook accepte les deux champs. Les règles de correspondance dépendent de la configuration du locataire.

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
