> 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/connectors/fr/email-provider/sendgrid.md).

# SendGrid

Le Wallet Crew peut envoyer des e-mails transactionnels via SendGrid. Cela couvre des messages comme les liens de téléchargement de Carte, les e-mails de vérification, etc.

Par défaut, The Wallet Crew utilise **son propre compte SendGrid**. Vous pouvez passer à **votre propre compte SendGrid** lorsque vous avez besoin d’un contrôle total sur la délivrabilité, la réputation et la facturation.

Si vous ne savez pas quelle option choisir, commencez par [Fournisseur d’e-mails](/connectors/fr/email-provider.md).

### Option 1 : Utiliser le compte SendGrid du Wallet Crew

C’est l’option la plus simple, et c’est celle par défaut. Vous n’avez pas besoin de créer un compte SendGrid ni de gérer des clés API. Le Wallet Crew s’occupe de tout.

Si vous voulez que les clients voient votre marque dans leur boîte de réception, activez un **domaine d’envoi personnalisé**. Cela améliore la délivrabilité. Cela réduit aussi les risques d’usurpation et de phishing.

{% hint style="info" %}
Lorsque vous utilisez le compte SendGrid du Wallet Crew, Le Wallet Crew doit activer le domaine d’envoi personnalisé de son côté. Vous devrez quand même ajouter des enregistrements DNS (SPF/DKIM, et idéalement DMARC) sur votre domaine.
{% endhint %}

{% stepper %}
{% step %}

#### Décidez du domaine d’expéditeur que vous souhaitez utiliser

Préférez un sous-domaine dédié tel que `wallet.yourbrand.com` ou `registration.yourbrand.com`. Cela permet de garder l’authentification e-mail isolée des autres systèmes de messagerie.

{% hint style="info" %}
Déléguer un sous-domaine dédié réduit votre surface d’attaque et améliore la sécurité en isolant le trafic lié à Carte. Nous recommandons d’utiliser le même domaine personnalisé que votre application.
{% endhint %}
{% endstep %}

{% step %}

#### Demandez au support d’activer votre domaine d’envoi

Contactez le support du Wallet Crew avec le sous-domaine que vous souhaitez utiliser. L’équipe fournira les enregistrements DNS à ajouter et activera le domaine dans SendGrid.
{% endstep %}

{% step %}

#### Configurer le DNS (SPF, DKIM, DMARC)

Ajoutez les enregistrements DNS fournis par Le Wallet Crew, puis attendez la propagation du DNS.

Pour le processus général et pour comprendre pourquoi c’est important, voir [Configuration du domaine personnalisé](https://github.com/TheWalletCrew/docs/tree/main/configure/platform/configuring-custom-domain.md).
{% endstep %}

{% step %}

#### Tester un envoi réel

Déclenchez un e-mail transactionnel et confirmez :

* l’e-mail est bien distribué (non bloqué ou mis en quarantaine)
* l’expéditeur visible correspond au domaine que vous avez prévu
* SPF/DKIM passent (vérifiez dans les en-têtes de votre boîte mail si nécessaire)
  {% endstep %}
  {% endstepper %}

### Option 2 : Utiliser votre propre compte SendGrid

{% stepper %}
{% step %}

#### Créer une clé API SendGrid

Dans SendGrid, allez dans `Paramètres` → `Clés API`. Créez une clé API avec les **autorisations d’envoi de mails** .
{% endstep %}

{% step %}

#### Mettre à jour `/server/emails.yml`

Ouvrez l’éditeur de configuration avancée :

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/settings/configuration" class="button secondary">Administration du Wallet Crew - Configuration avancée</a></p>

Ensuite, créez ou modifiez `/server/emails.yml`.

{% code title="/server/emails.yml" %}

```yaml
fournisseur :
  type : sendgrid
  apiKey : YOUR_SENDGRID_API_KEY
  from:
    email : no-reply@yourbrand.com
    name : Your Brand
ressources :
  - /locales/emails/
```

{% endcode %}

Utilisez un `from.email` appartenant à un domaine que vous authentifiez dans SendGrid.

{% hint style="warning" %}
Traitez votre clé API SendGrid comme un mot de passe.

Ne la collez pas dans des tickets ou des captures d’écran.
{% endhint %}
{% endstep %}

{% step %}

#### Configurer l’authentification de l’expéditeur dans SendGrid

Authentifiez votre domaine d’envoi dans SendGrid en utilisant le flux standard « Authentification de domaine ». Cela configure SPF et DKIM. Ajoutez un enregistrement DMARC pour votre domaine d’envoi si nécessaire. Cela améliore la délivrabilité et réduit le risque d’usurpation.
{% endstep %}

{% step %}

#### Enregistrez et testez

Enregistrez le fichier. Déclenchez un seul e-mail transactionnel. Vérifiez l’événement dans vos journaux d’activité SendGrid.
{% endstep %}
{% endstepper %}

## Dépannage

* Si SendGrid renvoie **401** ou **403**, votre clé API est invalide ou ne dispose pas des autorisations nécessaires.
* Si l’adresse « from » est rejetée, votre domaine n’est pas authentifié. Vérifiez d’abord SPF et DKIM.
* Si les e-mails finissent dans les spams, revérifiez l’authentification, la stratégie DMARC et la réputation de l’expéditeur.
* Si rien ne change après modification, confirmez que vous avez enregistré le bon fichier de locataire. Le fichier doit être `/server/emails.yml`.

## FAQ

<details>

<summary><strong>Où puis-je configurer SendGrid dans Le Wallet Crew ?</strong></summary>

Modifiez `/server/emails.yml` dans l’éditeur de configuration avancée.

</details>

<details>

<summary><strong>Pouvons-nous conserver le compte SendGrid du Wallet Crew au lieu d’utiliser le nôtre ?</strong></summary>

**Oui**. Le Wallet Crew utilise par défaut sa propre configuration SendGrid.

Si vous le conservez, vous pouvez quand même envoyer depuis un domaine que vous contrôlez. Demandez au support d’activer un domaine d’envoi personnalisé, puis configurez SPF/DKIM et DMARC sur votre DNS.

</details>

<details>

<summary><strong>Faut-il authentifier notre domaine dans SendGrid ?</strong></summary>

**Oui**. Activez l’authentification de domaine SendGrid (SPF/DKIM). Ajoutez aussi un enregistrement DMARC pour le domaine ou sous-domaine que vous utilisez pour `from.email`.

</details>

<details>

<summary><strong>Pouvons-nous utiliser différents comptes SendGrid par environnement ?</strong></summary>

Oui. Chaque locataire a sa propre configuration. Vous pouvez utiliser différentes clés API par locataire.

</details>

<details>

<summary><strong>Quel est le moyen le plus rapide de valider l’intégration ?</strong></summary>

Enregistrer `/server/emails.yml`, déclenchez un seul e-mail transactionnel, puis vérifiez-le dans votre flux d’activité SendGrid.

</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/connectors/fr/email-provider/sendgrid.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.