> 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/guides-enrolment/fr/inscription/via-email.md).
# Via e-mail
## Envoyez par e-mail des liens « Ajouter à Wallet »
L’e-mail est le moyen le plus simple de joindre les clients existants et de les amener dans Apple Wallet ou Google Wallet. Cela fonctionne bien pour les cartes de fidélité et d’adhésion, car les clients font déjà confiance à ce canal, et vous pouvez placer l’appel à l’action dans les parcours que vous utilisez déjà (bienvenue, confirmation d’achat, e-mails de service).
L’essentiel est de sécuriser les liens. Un lien Wallet est une action au porteur. Quiconque obtient l’URL peut essayer de l’ouvrir. Utilisez des URL signées ou des jetons, et évitez les données personnelles dans les paramètres de requête.
Exemples concrets
* Une marque de distribution envoie « Votre carte de fidélité est prête » après l’inscription à la newsletter.
* Un opérateur de billetterie envoie un e-mail « Enregistrez votre billet » juste après l’achat.
* Une marque de luxe envoie « Ajouter votre carte client » après une visite en magasin, avec recueil du consentement.
### Ce dont vous avez besoin avant de commencer
Vous avez besoin d’un [modèle de Carte](https://docs.thewalletcrew.io/configuration/wallet/template-configuration/how-to-create-a-template) et un flux d’émission, ainsi qu’un moyen d’identifier le client. Dans la plupart des configurations, The Wallet Crew résout une Carte soit à partir d’un identifiant interne `carteId` ou à partir d’un identifiant externe provenant de votre CRM.
Vous avez aussi besoin d’une identité d’expéditeur à laquelle les clients font confiance et que les fournisseurs de boîtes aux lettres acceptent. Configurez cela une fois, y compris la configuration du domaine d’envoi, puis réutilisez-le dans tous les parcours.
{% hint style="info" %}
Si vous prévoyez d’envoyer depuis votre propre domaine, configurez SPF/DKIM et une politique DMARC. Cela améliore la délivrabilité et réduit le risque d’hameçonnage.
{% endhint %}
### Choisissez le bon flux d’e-mails
Il existe deux flux courants. Choisissez-en un selon que le client existe déjà dans votre base de données.
#### Flux A — Le client existe : téléchargement direct
Utilisez ceci lorsque le client a déjà un compte de fidélité (ou tout autre identifiant stable) et que vous souhaitez une installation en un seul toucher. L’e-mail contient une URL sécurisée qui ouvre la page de Carte The Wallet Crew et permet au client d’enregistrer la Carte.
Pour empêcher l’énumération d’identifiants, n’exposez pas des identifiants prévisibles comme un numéro de fidélité sans signature ni jeton. Cela suit le même principe que les liens Ajouter à Wallet signés décrits dans [Sécurité de la carte Wallet](https://docs.thewalletcrew.io/configuration/wallet/wallet-card-security).
**Exemple : lien de téléchargement direct signé (HMAC)**
Pour les clients qui existent déjà dans votre CRM (et que vous pouvez référencer en toute sécurité avec un identifiant interne), vous pouvez envoyer un lien qui renvoie directement à leur Carte.
Exemple :
`https://app.neostore.cloud/{tenantId}/pass?id.y2.customerId={customerId}&id.y2.customerId.hmac={hmac256(customerId,tenantSecret)}`
Gardez le `secret du locataire` côté serveur. Toute personne qui le possède peut générer des liens valides.
#### Flux B — Le client n’existe pas : inscription d’abord
Utilisez ceci lorsque votre liste d’e-mails est plus large que votre base de fidélité, ou lorsque vous avez besoin de données manquantes ou du consentement avant d’émettre une Carte. Le lien dirige le client vers un formulaire d’inscription, puis l’équipe Wallet délivre la Carte à la fin du parcours du formulaire.
Commencez ici : [Formulaire d'inscription](/guides-enrolment/fr/inscription/enrolment-form.md).
{% hint style="warning" %}
Évitez de mettre des données personnelles identifiables (PII) dans l'URL (e-mail, prénom, nom). Utilisez un jeton généré par votre backend et que votre formulaire peut valider.
{% endhint %}
**Exemple : client absent de votre CRM (préremplir le formulaire)**
Si le client ne se trouve pas encore dans votre CRM, vous pouvez utiliser le parcours d'inscription pour collecter les données manquantes, puis les envoyer à votre CRM. Certaines marques choisissent de préremplir le formulaire à l'aide de paramètres de requête provenant de leur outil de campagne e-mail.
Exemple (déconseillé) :
`https://app.neostore.cloud/{tenantId}/mobile?email=cyril@neostore.cloud&firstName=Cyril&lastName=DURAND`
{% hint style="danger" %}
Cette URL est **non signée**. N'importe qui peut modifier les paramètres de requête. Évitez cette configuration en production.
{% endhint %}
**Recommandé : lien d’inscription basé sur un jeton (aucune donnée personnelle dans l’URL)**
Utilisez un jeton pour sécuriser le lien. Cela évite d’exposer des données personnelles dans l’URL et réduit les risques de falsification.
En pratique, vous générez un jeton depuis The Wallet Crew (API ou back-office), vous le stockez dans votre audience d’e-mailing, puis vous l’insérez dans l’URL du CTA.
Exemple :
`https://app.neostore.cloud/{tenantId}/mobile?neo.authToken={neostore-JWT}`
**Comment inclure les liens The Wallet Crew dans votre outil d’e-mailing**
Vous pouvez utiliser l’un des connecteurs partenaires de The Wallet Crew (par exemple Actito ou Klaviyo) ou votre propre plateforme (Mailchimp, Salesforce Marketing Cloud, Brevo/Sendinblue, etc.).
{% stepper %}
{% step %}
#### Générez le jeton
Générez le jeton avec l’API The Wallet Crew, ou générez-le manuellement depuis le back-office The Wallet Crew.
Utilisez une entrée stable (généralement un identifiant client ou une adresse e-mail), puis conservez le jeton opaque dans votre outil de campagne.
{% endstep %}
{% step %}
#### Stockez le jeton dans votre audience
Stockez le jeton dans votre base de données d’e-mailing en tant qu’attribut personnalisé, afin de pouvoir le fusionner dans l’URL du CTA.
{% endstep %}
{% step %}
#### Construisez l’URL du CTA
Utilisez un bouton comme « Ajouter à Wallet » et faites-le pointer vers une URL tokenisée :
`https://app.neostore.cloud/{tenantId}/mobile?neo.authToken={{profile.neostoreJwt}}`
Remplacez `{{profile.neostoreJwt}}` par la syntaxe de balises de fusion de votre outil.
{% endstep %}
{% endstepper %}
### Ajoutez le CTA à vos e-mails
En pratique, vous intégrez un lien derrière un bouton tel que « Ajouter à Wallet ». Vous pouvez le faire dans votre outil marketing (modèles de campagne) ou dans des e-mails transactionnels envoyés par The Wallet Crew.
#### Exemples de CTA
*Utilisez un bouton très contrasté et gardez-le visible sans défilement sur mobile.*
*Si vous avez plusieurs CTA, gardez le CTA Wallet visuellement distinct.*
### Gardez les liens sécurisés (règles recommandées)
Les liens signés et les jetons empêchent la falsification et réduisent le risque d’énumération de la Carte. Ils maintiennent également les données personnelles hors des URL qui peuvent être journalisées par des proxys, des scanners de boîtes mail ou des outils d’analyse.
Appliquez ces règles :
* Privilégiez un **identifiant opaque** (`carteId`) lorsque c’est possible.
* Lorsque vous devez utiliser un **identifiant externe**, protégez-le avec **HMAC**, un **jeton secret partagé**, ou un **JWT**.
* Conservez des durées de vie de jeton courtes pour les campagnes e-mail. Considérez le lien comme un mot de passe.
* Supposez que les e-mails peuvent être transférés. Si le transfert ne doit pas fonctionner, ajoutez une vérification par e-mail ou une autre étape de vérification dans le parcours.
Si un examen de sécurité plus approfondi est nécessaire, abordez HMAC, les jetons secrets partagés et JWT dans le cadre de la conception du lien. [Sécurité de la carte Wallet](https://docs.thewalletcrew.io/configuration/wallet/wallet-card-security) est la source de vérité. Pour des contrôles organisationnels plus larges, consultez le [plan d’assurance sécurité](https://docs.thewalletcrew.io/policies/privacy-and-security/security-insurance-plan).
### Segmentez vos envois et mesurez l’adoption
L’e-mail fonctionne mieux lorsque vous n’inondez pas de messages les clients qui ont déjà installé la Carte. Segmentez selon le statut « Carte installée » lorsque c’est possible, puis ciblez uniquement les clients qui ne l’ont pas encore installée.
Si le statut d’installation doit être synchronisé vers le CRM, utilisez les flux d’événements et d’intégration disponibles.
Vous pouvez également marquer les installations pour l’attribution. Si vous distribuez via des pages web, voyez comment le marquage fonctionne avec `neo.src` sur [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).
### Outils et connecteurs pris en charge
Vous pouvez envoyer des e-mails depuis votre propre plateforme d’e-mailing et intégrer des liens Wallet Crew dans vos modèles. Vous pouvez également configurer The Wallet Crew pour envoyer des e-mails transactionnels dans le cadre des parcours d’inscription et de vérification.
Voir : [Connecteurs](/guides-enrolment/fr/inscription/via-email/connectors.md).
## FAQ
Pouvons-nous lancer des campagnes marketing avec ces liens ?
Oui. Utilisez votre plateforme marketing pour envoyer la campagne et intégrez un lien Wallet Crew sécurisé derrière votre CTA.
Si The Wallet Crew envoie des e-mails pour les parcours d’inscription et de vérification, configurez d’abord l’identité de l’expéditeur et la configuration du domaine.
Dois-je inclure l’e-mail ou le nom du client dans l’URL ?
Évitez-le. Les URL sont souvent journalisées et analysées. Utilisez un jeton et laissez The Wallet Crew (ou votre backend) résoudre le client côté serveur.
Que se passe-t-il si un client transfère l’e-mail ?
Si le lien est un jeton au porteur, le destinataire transféré peut essayer de l’ouvrir. Si vous devez empêcher cela, utilisez un jeton à courte durée de vie et ajoutez une étape de vérification (défi par e-mail) avant d’émettre ou de révéler la Carte.
Comment éviter d’envoyer des e-mails aux clients qui ont déjà installé la Carte ?
Segmentez votre audience selon l’état d’installation, puis ciblez uniquement les profils « non installés ». Si les données doivent remonter dans le CRM, utilisez les événements de statut d’installation dans la configuration de l’intégration.
Où cela doit-il se trouver : e-mail, site web ou application mobile ?
Utilisez l’e-mail lorsque vous disposez déjà d’une adresse client et que vous voulez un parcours de conversion à faible effort.
Utilisez le web lorsque la Carte est installée depuis une zone connectée ou le tunnel de paiement : [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).
Utilisez l’application native lorsque vous avez une application et que vous voulez l’UX la plus rapide : [Dans votre application mobile](/guides-enrolment/fr/inscription/readme-1.md).
---
# 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/guides-enrolment/fr/inscription/via-email.md?ask=&goal=
```
`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.