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

# Brevo

Envoyez des liens « Add to Wallet » pour Apple Wallet et Google Wallet depuis Brevo en important un attribut de contact \`WALLET\_LINK\`.

Brevo peut être utilisé pour distribuer des cartes Apple Wallet et Google Wallet par e-mail. Cette configuration enrichit les contacts Brevo avec un lien Wallet sécurisé, puis le réutilise dans les modèles Brevo.

<details>

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

* Une marque de vente au détail envoie un lien « Ajouter au Wallet » de fidélité après l’inscription à la newsletter.
* Un programme de cartes-cadeaux envoie un lien « Enregistrer votre carte-cadeau » après l’achat.
* Un programme d’adhésion envoie un e-mail de renouvellement incluant le lien de la carte mis à jour.

</details>

## Prérequis

Les contacts Brevo doivent pouvoir être exportés et importés. Les attributs Brevo doivent également pouvoir être gérés.

The Wallet Crew doit être configuré pour générer un `authToken` par e-mail. Ce jeton est utilisé pour créer une URL sécurisée « Ajouter au Wallet ».

Si les cartes sont normalement générées depuis un connecteur CRM (Cegid, Openbravo, etc.), les e-mails importés depuis Brevo doivent exister dans ce système. Si ce n’est pas le cas, utilisez [Par e-mail](/guides-enrolment/fr/inscription/via-email.md) pour générer et envoyer des liens sécurisés « Ajouter au Wallet ».

Les règles de mise à jour des contacts Brevo et les contraintes d’importation CSV sont documentées par Brevo : <https://help.brevo.com/hc/en-us/articles/10227982847762-Update-the-information-of-your-contacts>

{% hint style="warning" %}
Le `authToken` est un identifiant. Il doit être traité comme une donnée sensible. Il ne doit pas être publié publiquement ni stocké dans des systèmes non contrôlés.
{% endhint %}

{% hint style="info" %}
À confirmer : l’URL de base de la « page de destination de la carte » peut varier selon l’environnement et la configuration du projet. L’URL de base correcte doit être extraite de la configuration du projet The Wallet Crew.
{% endhint %}

## Configuration

{% stepper %}
{% step %}

#### 1) Exporter les contacts depuis Brevo

Exportez un fichier CSV de la liste de contacts Brevo avec le champ e-mail.

Ouvrez : <https://app.brevo.com/contact/list>

Dans l’interface Brevo, sélectionnez **Contacts → Plus d’actions → Exporter**.

<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%2Fgit-blob-6ba406055f8e449b4ebd16913db4066d0fd3e1b8%2Fdocumentation-brevo-select-contacts-more-actions-export.png?alt=media" alt="Brevo contact list export menu: Contacts → More actions → Export"><figcaption><p>Lancez une exportation de contacts depuis la liste de contacts Brevo.</p></figcaption></figure></div>

Utilisez les options suivantes :

* Attributs à exporter : `EMAIL`
* Séparateur de champs CSV : `,` (virgule)

<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%2Fgit-blob-af6b8157eb3b28cdfcef0f2d92baa4908d5f5405%2Fdocumentation-brevo-export-contacts-from-brevo.png?alt=media" alt="Brevo export contacts options showing EMAIL attribute and comma separator"><figcaption><p>Exportez uniquement ce qui est nécessaire. Gardez le fichier minimal.</p></figcaption></figure></div>

Le fichier devient disponible dans le centre de notifications Brevo.
{% endstep %}

{% step %}

#### 2) Créer un attribut `WALLET_LINK` dans Brevo

Créez un attribut texte pour stocker le lien Wallet de chaque contact.

Dans Brevo, accédez à l’écran des attributs et sélectionnez **Ajouter un nouvel attribut**.

<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%2Fgit-blob-bfe19e429929ea56e5126d0c5ac259f0bd3b2994%2Fdocumentation-brevo-create-new-attribute.png?alt=media" alt="Brevo attributes screen with the &#x27;add a new attribute&#x27; action"><figcaption><p>Créez un nouvel attribut personnalisé pour les liens Wallet.</p></figcaption></figure></div>

Créez l’attribut avec :

* Nom de l’attribut : `WALLET_LINK`
* Type d’attribut : `Texte`

<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%2Fgit-blob-c378b2ed98560e6e51065d5389e4658298c585aa%2Fdocumentation-brevo-create-new-attribute-2.png?alt=media" alt="Brevo new attribute form filled with WALLET_LINK and type Text"><figcaption><p>`WALLET_LINK` stocke l’URL « Ajouter au Wallet » de chaque contact.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### 3) Générer des `authToken` valeurs dans The Wallet Crew

Dans la console d’administration The Wallet Crew, ouvrez **Générateur de jetons**. Générez un `authToken` basé sur l’e-mail.

<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%2Fgit-blob-1ed24518c14e1ae40fefdf3e58c6912eec1cf9b9%2Fdocumentation-brevo-generate-authtoken-based-email.png?alt=media" alt="The Wallet Crew Token Generator with a list of emails pasted for token generation"><figcaption><p>Générez un jeton par e-mail.</p></figcaption></figure></div>

Cette étape produit généralement une liste de `{EMAIL, authToken}` valeurs. Stockez-les dans une feuille de travail pour l’étape suivante.
{% endstep %}

{% step %}

#### 4) Construire les liens Wallet (`WALLET_LINK`)

Pour chaque contact, concaténez :

* l’URL de base de la page d’atterrissage Carte du projet
* le paramètre de requête `neo.authToken`

Exemple de sortie :

* `https://<host>/<tenant>/Carte?neo.authToken=<authToken>`

Dans Excel ou Google Sheets, une formule typique ressemble à :

* `=BASE_URL & "?neo.authToken=" & AUTH_TOKEN_CELL`

Le CSV résultant devrait contenir au moins :

* `EMAIL`
* `WALLET_LINK`
  {% endstep %}

{% step %}

#### 5) Importer `WALLET_LINK` les valeurs dans Brevo

Importez le CSV mis à jour afin que Brevo écrive `WALLET_LINK` sur chaque contact.

<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%2Fgit-blob-b32f1a020082170f2d88b78c321a92032a9f7499%2Fdocumentation-brevo-import-wallet-links-brevo.png?alt=media" alt="Brevo import contacts entry point screen"><figcaption><p>Lancez une importation de contacts pour mettre à jour les attributs.</p></figcaption></figure></div>

Téléversez le fichier CSV :

<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%2Fgit-blob-94e84655033d854f8aa600fc84f7431049f91e3c%2Fdocumentation-brevo-upload-file.png?alt=media" alt="Brevo import flow step to upload a CSV file"><figcaption><p>Sélectionnez le fichier enrichi qui contient `WALLET_LINK`.</p></figcaption></figure></div>

Associez les champs et confirmez l'importation :

<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%2Fgit-blob-756f0b94e4bbdac5742f9803ad2be933aac0f680%2Fdocumentation-brevo-import-wallet-links-brevo-2.png?alt=media" alt="Brevo import field mapping screen for WALLET_LINK"><figcaption><p>Associez `WALLET_LINK` à l'attribut personnalisé.</p></figcaption></figure></div>

Une fois terminé, validez le rapport d'importation :

<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%2Fgit-blob-1eafadac823b9a81ce7b8556b17dafea29744f75%2Fdocumentation-brevo-import-is-completed.png?alt=media" alt="Brevo import completed confirmation"><figcaption><p>Brevo confirme l'état du travail d'importation.</p></figcaption></figure></div>

<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%2Fgit-blob-e444cace40be4c6ffac59515cf661abf01b35a1b%2Fdocumentation-brevo-check-import-report.png?alt=media" alt="Brevo import report screen showing the summary and potential errors"><figcaption><p>Utilisez le rapport pour repérer les e-mails manquants ou les lignes rejetées.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### 6) Ajoutez un bouton « Ajouter à Wallet » dans le modèle d'e-mail Brevo

Ajoutez un lien ou un bouton dans le modèle d'e-mail qui pointe vers l' `WALLET_LINK` attribut.

<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%2Fgit-blob-2c39dd39fcc8cc12ed84ff53ad7aca65d9c9424a%2Fdocumentation-brevo-add-link.png?alt=media" alt="Brevo email template editor where a button link uses the WALLET_LINK attribute"><figcaption><p>Utilisez l'attribut du contact comme URL du bouton.</p></figcaption></figure></div>

Ajoutez une condition d'affichage afin que le bloc ne s'affiche que lorsque `WALLET_LINK` est présent.

<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%2Fgit-blob-1aff6c9f29989493f303d21030117d54a28296b3%2Fdocumentation-brevo-add-wallet-button-brevo-email.png?alt=media" alt="Brevo email template conditional display settings using WALLET_LINK availability"><figcaption><p>Masquez le bloc Wallet lorsque le contact n'a aucun lien Wallet.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## FAQ

<details>

<summary><strong>Que se passe-t-il si l'e-mail d'un contact n'existe pas dans le CRM connecté ?</strong></summary>

The Wallet Crew peut ne pas être en mesure de résoudre une fiche client existante pour la création ou les mises à jour de Carte. Dans ce cas, privilégiez [Par e-mail](/guides-enrolment/fr/inscription/via-email.md), qui distribue les liens sécurisés générés par le projet via le flux d'e-mails de The Wallet Crew.

</details>

<details>

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

Exécutez une importation test avec un petit segment. Ouvrez quelques liens depuis l'aperçu du contact Brevo et confirmez que la Carte attendue s'affiche et peut être ajoutée à Apple Wallet ou Google Wallet.

</details>

<details>

<summary><strong>Faut-il stocker `authToken` à long terme dans Brevo ?</strong></summary>

Cela dépend de la politique de sécurité et de la durée de vie du jeton définies pour le projet. Si les jetons expirent ou doivent être renouvelés, régénérez-les et réimportez `WALLET_LINK` les valeurs avant chaque campagne.

</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/brevo.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.