> 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/mailchimp.md).

# Mailchimp

The Wallet Crew peut envoyer des e-mails transactionnels via Mailchimp Transactional (Mandrill). Cela couvre des messages tels que 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 Mailchimp Transactional** lorsque vous souhaitez centraliser l’activité e-mail dans Mandrill, ou lorsque vous vous appuyez déjà sur Mandrill pour le suivi de la délivrabilité.

Cette configuration est limitée à l’envoi transactionnel. Elle n’intègre pas les fonctionnalités Mailchimp Marketing comme les audiences ou les campagnes.

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

## Configurez votre propre compte Mailchimp Transactional (Mandrill)

Avant de mettre à jour la configuration de The Wallet Crew, assurez-vous que Mandrill peut authentifier votre identité d’expéditeur. En pratique, cela signifie disposer d’un compte Mailchimp Transactional, générer une clé API Transactional et valider le domaine d’expéditeur ou l’adresse e-mail que vous souhaitez utiliser.

{% 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" %}
L’utilisation d’un sous-domaine dédié réduit l’exposition et améliore la sécurité grâce à une meilleure isolation. Nous recommandons d’utiliser le même domaine personnalisé que votre application lorsque cela a du sens pour votre configuration.
{% endhint %}
{% endstep %}

{% step %}
**Créez une clé API Transactional**

Créez une clé API dans Mailchimp Transactional (Mandrill), car The Wallet Crew l’utilise pour appeler les API d’envoi de Mandrill en votre nom.

<div data-with-frame="true"><figure><img src="/files/9f1c26248977109516fc8f4e254ebb50e6871051" alt="API configuration in Mailchimp Transactional." width="375"><figcaption><p>Configuration de l’API dans Mailchimp Transactional.</p></figcaption></figure></div>

Suivez ce guide : [Générez votre clé API](https://mailchimp.com/developer/transactional/guides/quick-start/#generate-your-api-key).
{% 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" data-icon="chevrons-right">Console d’administration - Configuration avancée</a></p>

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

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

```yaml
provider:
  type: mailchimp
  apiKey: md-xxxx
  from:
    email: support@yourbrand.com
    name: Support de votre marque
resources:
  - /locales/emails/
```

{% endcode %}

Remplacez `md-xxxx` par votre clé API Mandrill. Définissez ensuite les valeurs `from` sur une identité d’expéditeur acceptée par Mandrill.

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

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

{% step %}
**Enregistrez et testez**

Enregistrez le fichier dans la console d’administration pour appliquer le changement de fournisseur. Déclenchez un seul e-mail transactionnel à partir de votre flux habituel, puis confirmez la livraison dans les journaux d’activité de Mailchimp Transactional.
{% endstep %}
{% endstepper %}

## Dépannage

La plupart des problèmes proviennent de l’utilisation du mauvais type de clé ou d’un envoi depuis une identité non vérifiée. Si l’envoi d’e-mails échoue ou que rien ne semble changer, commencez par ces vérifications :

* **Mailchimp Marketing vs Transactional**: vous devez utiliser une **Transactional (Mandrill)** clé.
* **401/403 depuis Mailchimp**: vérifiez la clé et que Transactional est activé.
* **E-mails non distribués**: vérifiez votre domaine/adresse e-mail d’expéditeur dans Mailchimp Transactional.
* **Rien ne change après modification**: confirmez que vous avez modifié `/server/emails.yml` dans le bon tenant et que vous l’avez enregistré.

## FAQ

<details>

<summary><strong>Est-ce la même chose que « e-mails marketing Mailchimp » ?</strong></summary>

**Non**. Cette intégration utilise uniquement **Mailchimp Transactional (Mandrill)** pour envoyer des messages transactionnels.

</details>

<details>

<summary><strong>Ai-je besoin d’un module complémentaire Mailchimp payant ?</strong></summary>

En général oui, car Transactional (Mandrill) est un produit distinct des forfaits Mailchimp Marketing standard.

</details>

<details>

<summary><strong>Où configurer Mailchimp dans The Wallet Crew ?</strong></summary>

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

</details>

<details>

<summary><strong>Devons-nous authentifier notre domaine dans Mailchimp Transactional ?</strong></summary>

**Oui**. Vérifiez l’identité d’expéditeur que vous utilisez pour `from.email` dans Mailchimp Transactional. Si vous envoyez depuis un domaine, configurez l’authentification (SPF/DKIM) et ajoutez un enregistrement DMARC pour ce domaine ou sous-domaine.

</details>

<details>

<summary><strong>Puis-je conserver SendGrid en staging et Mailchimp en production ?</strong></summary>

Oui, mais ce n’est pas recommandé.

Chaque tenant a sa propre configuration, vous pouvez donc choisir différents fournisseurs par environnement. En pratique, utiliser différents fournisseurs rend le dépannage plus difficile. Cela augmente aussi le risque de différences spécifiques au fournisseur entre le staging et la production (authentification de l’expéditeur, comportement de délivrabilité, journaux d’activité et limites de débit).

Si vous avez besoin d’un environnement de test sûr, préférez utiliser le **même fournisseur** dans les deux environnements. Utilisez un sous-domaine d’expéditeur différent (par exemple `staging.wallet.yourbrand.com`) et envoyez uniquement vers des adresses internes.

</details>

<details>

<summary><strong>Quel est le moyen le plus rapide de valider ma configuration ?</strong></summary>

Enregistrer `/server/emails.yml`, déclenchez un seul e-mail, puis vérifiez l’événement dans les journaux d’activité de Mailchimp Transactional.

</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/mailchimp.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.
