> 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

Configurez la façon dont The Wallet Crew envoie les e-mails transactionnels avec SendGrid.

The 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**. Une marque peut passer à **son propre compte SendGrid** lorsqu’il a besoin de contrôler entièrement la délivrabilité, la réputation et la facturation.

Si la bonne option n’est pas encore évidente, commencez par [Fournisseur d’e-mail](/connectors/fr/email-provider.md).

### Option 1 : Utiliser le compte SendGrid de The Wallet Crew

C’est l’option la plus simple, et c’est celle par défaut. Aucun compte SendGrid ni aucune gestion de clé API ne sont requis. The Wallet Crew s’en charge.

Pour rendre la marque visible dans la boîte de réception du client, activez un **domaine d’envoi personnalisé**. Cela améliore la délivrabilité. Cela réduit également les risques d’usurpation et d’hameçonnage.

{% hint style="info" %}
Avec le compte SendGrid de The Wallet Crew, The Wallet Crew doit activer le domaine d’envoi personnalisé de son côté. Les enregistrements DNS (SPF/DKIM, et idéalement DMARC) doivent tout de même être ajoutés sur le domaine de la marque.
{% endhint %}

{% stepper %}
{% step %}

#### Déterminer quel domaine d’envoi utiliser

Privilégiez un sous-domaine dédié tel que `wallet.yourbrand.com` ou `registration.yourbrand.com`. Cela isole l’authentification des e-mails des autres systèmes de messagerie.

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

{% step %}

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

Contactez le support de The Wallet Crew avec le sous-domaine à 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 The Wallet Crew, puis attendez la propagation du DNS.

Pour le processus général et son importance, voir [Domaine personnalisé](/configure/fr/advanced-configuration/platform/custom-domain.md).
{% endstep %}

{% step %}

#### Tester un envoi réel

Déclenchez un e-mail transactionnel et confirmez :

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

### Option 2 : Utiliser un compte SendGrid dédié

{% stepper %}
{% step %}

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

Dans SendGrid, allez à `Paramètres` → `Clés API`. Créez une clé API avec **Mail Send** autorisations.
{% 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 de The Wallet Crew - configuration avancée</a></p>

Puis créez ou modifiez `/server/emails.yml`.

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

```yaml
provider:
  type: sendgrid
  apiKey: YOUR_SENDGRID_API_KEY
  from:
    email: no-reply@yourbrand.com
    name: Votre marque
resources:
  - /locales/emails/
```

{% endcode %}

Utilisez un `from.email` qui appartient à un domaine authentifié dans SendGrid.

{% hint style="warning" %}
Traitez la 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 le domaine d’envoi dans SendGrid à l’aide du flux standard « Domain Authentication ». Cela configure SPF et DKIM. Ajoutez un enregistrement DMARC pour le domaine d’envoi si nécessaire. Cela améliore la délivrabilité et réduit le risque d’usurpation.
{% endstep %}

{% step %}

#### Enregistrer et tester

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

## Dépannage

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

## FAQ

<details>

<summary><strong>Où SendGrid est-il configuré dans The Wallet Crew ?</strong></summary>

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

</details>

<details>

<summary><strong>Le compte SendGrid de The Wallet Crew peut-il être conservé au lieu d’un compte dédié ?</strong></summary>

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

L’envoi depuis un domaine contrôlé par la marque reste possible. Demandez au support d’activer un domaine d’envoi personnalisé, puis configurez SPF/DKIM et DMARC sur le DNS de la marque.

</details>

<details>

<summary><strong>Le domaine d’envoi doit-il être authentifié dans SendGrid ?</strong></summary>

**Oui**. Activez l’authentification de domaine SendGrid (SPF/DKIM). Ajoutez également un enregistrement DMARC pour le domaine ou le sous-domaine utilisé pour `from.email`.

</details>

<details>

<summary><strong>Différents comptes SendGrid peuvent-ils être utilisés par environnement ?</strong></summary>

Oui. Chaque locataire a sa propre configuration, donc une clé API différente peut être utilisée par locataire.

</details>

<details>

<summary><strong>Quelle est la façon la plus rapide de valider l’intégration ?</strong></summary>

Enregistrez `/server/emails.yml`, déclenchez un seul e-mail transactionnel, puis vérifiez-le dans le flux d’activité de 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.