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

# Par e-mail

Distribuez des cartes Apple Wallet et Google Wallet par e-mail à l’aide de liens signés ou basés sur des jetons qui ne révèlent pas de données personnelles dans l’URL.

## Envoyer par e-mail des liens « Ajouter à Wallet »

L’e-mail est le moyen le plus simple d’atteindre 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 l’appel à l’action peut être placé dans des parcours qu’une marque exécute déjà (accueil, confirmation d’achat, e-mails de service).

L’essentiel est de garder les liens sécurisés. Un lien Wallet est une action au porteur. Toute personne qui obtient l’URL peut tenter de l’ouvrir. Utilisez des URL signées ou des jetons, et évitez les données personnelles dans les paramètres de requête.

<details>

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

* 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 « Ajoutez votre carte client » après une visite en magasin, avec recueil du consentement.

</details>

### Ce qu’il faut avant de commencer

Un [modèle de Carte](/configure/fr/advanced-configuration/wallet/template-configuration/how-to-create-a-template.md) et un flux d’émission sont nécessaires, ainsi qu’un moyen d’identifier le client. Dans la plupart des configurations, The Wallet Crew résout une Carte soit à partir d’un `passId` ou à partir d’un identifiant externe provenant du CRM de la marque.

Une identité d’expéditeur à laquelle les clients font confiance et que les fournisseurs de messagerie acceptent est également requise. Configurez-la une seule fois, y compris la configuration du domaine d’envoi, puis réutilisez-la dans tous les parcours.

{% hint style="info" %}
Lors de l’envoi depuis un domaine appartenant à la marque, 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 la base de données de la marque.

#### Flux A — Le client existe : téléchargement direct

Utilisez ceci lorsque le client possède déjà un compte de fidélité (ou tout autre identifiant stable) et que l’objectif est une installation en un clic. L’e-mail contient une URL sécurisée qui ouvre la page de Carte de The Wallet Crew et permet au client d’enregistrer la Carte.

Pour éviter l’énumération d’ID, n’exposez pas d’identifiants prévisibles comme un numéro de fidélité sans signature ni jeton. Cela suit le même principe que les liens signés « Ajouter à Wallet » décrits dans [Sécurité de la carte Wallet](/configure/fr/advanced-configuration/wallet/wallet-card-security.md).

**Exemple : lien de téléchargement direct signé (HMAC)**

Pour les clients déjà existants dans le CRM, et qui peuvent être référencés en toute sécurité à l’aide d’un identifiant interne, un lien peut résoudre directement vers leur Carte.

Exemple :

`https://app.neostore.cloud/{tenantId}/Carte?id.y2.customerId={customerId}&id.y2.customerId.hmac={hmac256(customerId,tenantSecret)}`

Conservez le `tenantSecret` 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 la liste d’e-mails est plus grande que la base de fidélisation, ou lorsque des données manquantes ou le consentement doivent être collectés avant d’émettre une Carte. Le lien envoie le client vers un formulaire d’inscription, puis The Wallet Crew émet 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 placer des données personnelles identifiables (PII) dans l’URL (e-mail, prénom, nom). Utilisez un jeton généré par le backend de la marque et validé par le formulaire.
{% endhint %}

**Exemple : client non présent dans le CRM (préremplir le formulaire)**

Si le client n'est pas encore dans le CRM, le parcours d'inscription peut capturer les données manquantes puis les envoyer au 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=jane.doe@example.com&firstName=Jane&lastName=DOE`

{% 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 %}

**Lien d'inscription recommandé basé sur un jeton (aucune donnée personnelle identifiable 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 le risque de falsification.

En pratique, un jeton est généré depuis l'équipe Wallet (API ou back-office), stocké dans l'audience d'envoi d'e-mails, puis injecté dans l'URL du CTA.

Exemple :

`https://app.neostore.cloud/{tenantId}/mobile?neo.authToken={neostore-JWT}`

**Comment inclure les liens The Wallet Crew dans un outil d’e-mailing**

L’un des connecteurs partenaires de The Wallet Crew (par exemple Actito ou Klaviyo) peut être utilisé, ou la propre plateforme de la marque (Mailchimp, Salesforce Marketing Cloud, Brevo/Sendinblue, etc.).

{% stepper %}
{% step %}

#### Générer 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 ID client ou un e-mail), puis conservez le jeton opaque dans l’outil de campagne.
{% endstep %}

{% step %}

#### Stocker le jeton dans l’audience

Stockez le jeton dans la base de données d’e-mailing comme attribut personnalisé, afin qu’il puisse être fusionné dans l’URL du CTA.
{% endstep %}

{% step %}

#### Créer l’URL du CTA

Utilisez un bouton comme « Add to Wallet » et faites-le pointer vers une URL tokenisée :

`https://app.neostore.cloud/{tenantId}/mobile?neo.authToken={{profile.neostoreJwt}}`

Remplacer `{{profile.neostoreJwt}}` avec la syntaxe de balises de fusion de l’outil.
{% endstep %}
{% endstepper %}

### Ajouter le CTA aux e-mails

En pratique, le lien est placé derrière un bouton tel que « Add to Wallet ». Cela peut se faire dans l’outil marketing (modèles de campagne) ou dans les e-mails transactionnels envoyés par The Wallet Crew.

#### Exemples de CTA

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FQs7AjOSvyumn1S5ZXskt%2Fenroll-readme-email-cta-example-add-wallet-button-inside.png?alt=media&#x26;token=d372e061-6216-43bc-9cea-f85a47b38cbb" alt="Branded email containing an Add to Wallet button"><figcaption><p>Vérifiez que le bouton est très contrasté et visible dès le premier écran sur mobile.</p></figcaption></figure>

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FGue4JCXqcuzWJRBeNTKB%2Fenroll-readme-email-cta-example-add-wallet-link-presented.png?alt=media&#x26;token=d4674e8e-0530-4a21-934c-99c3d0f04b16" alt="Email presenting the Add to Wallet action as a secondary link"><figcaption><p>Lorsqu’il y a plusieurs CTA, vérifiez que le CTA Wallet reste visuellement distinct.</p></figcaption></figure>

### Sécuriser les liens (règles recommandées)

Les liens signés et les jetons empêchent toute falsification et réduisent le risque d’énumération de 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.

Utilisez ces règles :

* Préférez un **identifiant opaque** (`passId`) lorsque cela est possible.
* Lorsqu’un **identifiant externe** doit être utilisé, protégez-le avec **HMAC**, un **jeton secret partagé**, ou un **JWT**.
* Limitez la durée de vie des jetons pour les campagnes e-mail. Traitez le lien comme un mot de passe.
* Supposons que les e-mails peuvent être transférés. Si le transfert ne doit pas fonctionner, ajoutez un défi par e-mail ou une autre étape de vérification dans le parcours.

Si un examen de sécurité plus approfondi est nécessaire, incluez HMAC, les jetons secrets partagés et JWT dans la conception du lien. [Sécurité de la carte Wallet](/configure/fr/advanced-configuration/wallet/wallet-card-security.md) est la source de vérité. Pour des contrôles organisationnels plus larges, consultez le [plan d’assurance sécurité](/policies/fr/privacy-and-security/security-insurance-plan.md).

### Segmentez les envois et mesurez l’adoption

L’e-mail fonctionne mieux lorsque les clients ayant déjà installé la Carte sont exclus. Segmentez sur le statut « Carte installée » chaque fois que possible, puis ciblez uniquement les clients qui ne l’ont pas encore installée.

Si l’état d’installation doit être synchronisé vers le CRM, utilisez les flux d’événements et d’intégration disponibles.

Les installations peuvent également être taguées à des fins d’attribution. Pour une distribution via des pages web, voyez comment le balisage fonctionne avec `neo.src` sur [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).

### Outils et connecteurs pris en charge

Les e-mails peuvent être envoyés depuis la propre plateforme e-mail d’une marque, avec des liens The Wallet Crew intégrés dans les modèles. The Wallet Crew peut également être configuré 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

<details>

<summary><strong>Peut-on lancer des campagnes marketing avec ces liens ?</strong></summary>

Oui. Utilisez la plateforme marketing pour envoyer la campagne, et intégrez un lien sécurisé The Wallet Crew derrière le 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.

</details>

<details>

<summary><strong>Faut-il inclure l’e-mail ou le nom du client dans l’URL ?</strong></summary>

Évitez cela. Les URL sont souvent journalisées et analysées. Utilisez un jeton et laissez The Wallet Crew (ou le backend de la marque) résoudre le client côté serveur.

</details>

<details>

<summary><strong>Que se passe-t-il si un client transfère l’e-mail ?</strong></summary>

Si le lien est un jeton porteur, le destinataire transféré peut essayer de l’ouvrir. Si cela doit être empêché, utilisez un jeton à durée de vie courte et ajoutez une étape de vérification (défi par e-mail) avant d’émettre ou de révéler la Carte.

</details>

<details>

<summary><strong>Comment éviter d’envoyer des e-mails aux clients qui ont déjà installé la Carte ?</strong></summary>

Segmentez l’audience selon l’état d’installation, puis ciblez uniquement les profils « non installée ». Si les données doivent remonter dans le CRM, utilisez les événements d’état d’installation dans la configuration d’intégration.

</details>

<details>

<summary><strong>Où cela doit-il se trouver : e-mail, site web ou application mobile ?</strong></summary>

Utilisez l’e-mail lorsqu’une adresse client est déjà disponible et qu’un parcours de conversion à faible effort est l’objectif.

Utilisez le web lorsque la Carte est installée depuis une zone connectée ou le paiement : [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).

Utilisez une application native lorsqu’elle existe et que l’objectif est l’UX la plus rapide : [Sur votre application mobile](/guides-enrolment/fr/inscription/on-your-mobile-app.md).

</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/guides-enrolment/fr/inscription/via-email.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.
