circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

Brevo

Envoyez des liens « Ajouter au Wallet » Apple Wallet et Google Wallet depuis Brevo en important un attribut de contact `WALLET_LINK`.

Brevo peut être utilisé pour distribuer des passes 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.

chevron-rightExemples concretshashtag
  • Une marque de vente au détail envoie un lien de fidélité « Ajouter à Wallet » après l'inscription à la newsletter.

  • Un programme de cartes-cadeaux envoie un lien « Enregistrez votre carte-cadeau » après l'achat.

  • Un programme d'adhésion envoie un e-mail de renouvellement qui inclut le lien de pass mis à jour.

Prérequis

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

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

Si les passes sont normalement générés 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 Via e‑mail pour générer et envoyer des liens sécurisés « Ajouter à 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

circle-exclamation
circle-info

Besoin de confirmation : l'URL de base de la « page d'atterrissage du pass » peut varier selon l'environnement et la configuration du projet. L'URL de base correcte doit être prise depuis la configuration du projet The Wallet Crew.

Configuration

1

1) Exporter les contacts depuis Brevo

Exportez un CSV depuis la liste de contacts Brevo avec le champ e‑mail.

Ouvrir : 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
Démarrez une exportation de contacts depuis la liste de contacts Brevo.

Utilisez les options suivantes :

  • Attributs à exporter : EMAIL

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

Brevo export contacts options showing EMAIL attribute and comma separator
N'exportez que 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 par contact.

Dans Brevo, allez à 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 à Wallet » par contact.
3

3) Générer 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 typiquement 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 « page d'atterrissage du pass » du projet

  • le paramètre de requête neo.authToken

Exemple de sortie :

  • https://<host>/<tenant>/pass?neo.authToken=<authToken>

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

  • =BASE_URL & "?neo.authToken=" & AUTH_TOKEN_CELL

Le CSV résultant doit contenir au minimum :

  • EMAIL

  • WALLET_LINK

5

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

Brevo import contacts entry point screen
Démarrez 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`.

Mappez les champs et confirmez l'importation :

Brevo import field mapping screen for WALLET_LINK
Mappez `WALLET_LINK` vers l'attribut personnalisé.

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

Brevo import completed confirmation
Brevo confirme le statut du travail d'importation.
Brevo import report screen showing the summary and potential errors
Utilisez le rapport pour détecter 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 pas de lien Wallet.

FAQ

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

The Wallet Crew peut être incapable de résoudre un enregistrement client existant pour la création ou la mise à jour du pass. Dans ce cas, privilégiez Via e‑mail, qui distribue des liens sécurisés générés par le projet via le flux d'e‑mail de The Wallet Crew.

chevron-rightFaut‑il stocker `authToken` à long terme dans Brevo ?hashtag

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

Mis à jour