# 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**. Vous pouvez passer à **votre propre compte SendGrid** lorsque vous avez besoin d’être pleinement propriétaire de la délivrabilité, de la réputation et de 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 de The Wallet Crew

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

Si vous souhaitez que vos clients voient votre marque dans leur boîte de réception, activez un **domaine d'envoi personnalisé**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 de The Wallet Crew, The Wallet Crew doit activer le domaine d’envoi personnalisé de son côté. Vous devrez tout de même ajouter des enregistrements DNS (SPF/DKIM, et idéalement DMARC) sur votre domaine.
{% endhint %}

{% stepper %}
{% step %}

#### Décidez quel domaine d’expéditeur vous souhaitez 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 votre surface d’attaque et améliore la sécurité en isolant le trafic lié à la 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 de The 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 The Wallet Crew, puis attendez la propagation DNS.

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

{% step %}

#### Tester un envoi réel

Déclenchez un e-mail transactionnel et vérifiez :

* l’e-mail est bien livré (ni bloqué ni mis en quarantaine)
* l’expéditeur affiché correspond au domaine prévu
* SPF/DKIM sont validés (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 **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: Your Brand
resources:
  - /locales/emails/
```

{% endcode %}

Utilisez un `from.email` qui appartient à 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 à l’aide du flux standard « Domain Authentication ». 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 les risques 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 requises.
* Si l’adresse « from » est rejetée, votre 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 vous avez enregistré le bon fichier du locataire. Le fichier doit être `/server/emails.yml`.

## FAQ

<details>

<summary><strong>Où configurer SendGrid dans The 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 de The Wallet Crew au lieu d’utiliser le nôtre ?</strong></summary>

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

Si vous le conservez, vous pouvez toujours 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>Devrons-nous authentifier notre domaine 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 que vous utilisez pour `from.email`.

</details>

<details>

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

Oui. Chaque locataire dispose de sa propre configuration. Vous pouvez utiliser différentes clés API 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 votre flux d’activité SendGrid.

</details>


---

# Agent Instructions: 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:

```
GET https://docs.thewalletcrew.io/connectors/fr/email-provider/sendgrid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.