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 par e-mail des Cartes Apple Wallet et Google Wallet. 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 distribution envoie un lien de fidélité « Ajouter à Wallet » 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 qui inclut 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 construire une URL sécurisée « Ajouter à Wallet ».

Si les Cartes sont normalement générées à partir d’un connecteur CRM (Cegid, Openbravo, etc.), les e-mails importés depuis Brevo doivent exister dans ce système. Dans le cas contraire, utilisez Par 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’import CSV sont documentées par Brevo : https://help.brevo.com/hc/en-us/articles/10227982847762-Update-the-information-of-your-contacts

La authToken est une information d’identification. Elle doit être traitée comme une donnée sensible. Elle ne doit pas être publiée publiquement ni stockée dans des systèmes non contrôlés.

À confirmer : l’URL de base de la « page d’atterrissage de la Carte » peut varier selon l’environnement et la configuration du projet. L’URL de base correcte doit être récupérée à partir de 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.

Lancez une exportation des contacts depuis la liste de contacts Brevo.

Utilisez les options suivantes :

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

N’exportez que le nécessaire. Gardez le fichier au minimum.

Le fichier devient disponible dans le centre de notifications Brevo.

2

2) Créez un WALLET_LINK attribut dans Brevo

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

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

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

`WALLET_LINK` stocke l’URL « Ajouter à Wallet » de chaque contact.

3

3) Générer authToken des 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.

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

4) Construire les liens Wallet (WALLET_LINK)

Pour chaque contact, concaténez :

• l’URL de base de la page de destination du projet « Carte »
• 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 à ceci :

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

Le CSV النات?

• EMAIL
• WALLET_LINK

5

5) Importer WALLET_LINK les valeurs dans Brevo

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

Commencez une importation de contacts pour mettre à jour les attributs.

Téléversez le fichier CSV :

Sélectionnez le fichier enrichi qui contient `WALLET_LINK`.

Faites correspondre les champs et confirmez l'importation :

Associez `WALLET_LINK` à l'attribut personnalisé.

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

Brevo confirme le statut de la tâche d'importation.

Utilisez le rapport pour repérer les e-mails manquants ou les lignes rejetées.

6

6) Ajoutez un bouton « Ajouter au 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 le WALLET_LINK attribut.

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.

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 être incapable de résoudre un enregistrement client existant pour la création ou les mises à jour de Carte. Dans ce cas, préférez Par e-mail, qui distribue des liens sécurisés générés par le projet via le flux d’e-mails de The Wallet Crew.

Comment valider que `WALLET_LINK` fonctionne avant d’envoyer une campagne ?

Lancez une importation de 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.

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

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-les et réimportez-les WALLET_LINK valeurs avant chaque campagne.