This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Brevo

Envoyez les liens « Ajouter à Wallet » 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.

Exemples concrets
  • 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.

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 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

À 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.

Configuration

1

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.

Brevo contact list export menu: Contacts → More actions → Export
Lancez une exportation de contacts depuis la liste de contacts Brevo.

Utilisez les options suivantes :

  • Attributs à exporter : EMAIL

  • Séparateur de champs CSV : , (virgule)

Brevo export contacts options showing EMAIL attribute and comma separator
Exportez uniquement ce qui est nécessaire. Gardez le fichier minimal.

Le fichier devient disponible dans le centre de notifications Brevo.

2

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.

Brevo attributes screen with the 'add a new attribute' action
Créez un nouvel attribut personnalisé pour les liens Wallet.

Créez l’attribut avec :

  • Nom de l’attribut : WALLET_LINK

  • Type d’attribut : Texte

Brevo new attribute form filled with WALLET_LINK and type Text
`WALLET_LINK` stocke l’URL « Ajouter au Wallet » de chaque contact.
3

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.

The Wallet Crew Token Generator with a list of emails pasted for token generation
Générez un jeton par e-mail.

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

4

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

5

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

Brevo import contacts entry point screen
Lancez une importation de contacts pour mettre à jour les attributs.

Téléversez le fichier CSV :

Brevo import flow step to upload a CSV file
Sélectionnez le fichier enrichi qui contient `WALLET_LINK`.

Associez les champs et confirmez l'importation :

Brevo import field mapping screen for WALLET_LINK
Associez `WALLET_LINK` à l'attribut personnalisé.

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

Brevo import completed confirmation
Brevo confirme l'état du travail d'importation.
Brevo import report screen showing the summary and potential errors
Utilisez le rapport pour repérer les e-mails manquants ou les lignes rejetées.
6

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.

Brevo email template editor where a button link uses the WALLET_LINK attribute
Utilisez l'attribut du contact comme URL du bouton.

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

Brevo email template conditional display settings using WALLET_LINK availability
Masquez le bloc Wallet lorsque le contact n'a aucun lien Wallet.

FAQ

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

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, qui distribue les liens sécurisés générés par le projet via le flux d'e-mails de The Wallet Crew.

Faut-il stocker `authToken` à long terme dans Brevo ?

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.

Mis à jour