# Mailchimp

The Wallet Crew peut envoyer des e-mails transactionnels via Mailchimp Transactional (Mandrill). 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 Mailchimp Transactional** lorsque vous souhaitez centraliser l’activité e-mail dans Mandrill, ou lorsque vous utilisez déjà 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 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" %}
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 est pertinent 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>

Puis 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: assistance de votre marque
resources:
  - /locales/emails/
```

{% endcode %}

Remplacez `md-xxxx` par votre clé API Mandrill. Puis définissez les `from` valeurs vers une identité d’expéditeur que Mandrill accepte.

{% 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 depuis 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 de l’envoi depuis une identité non vérifiée. Si l’envoi d’e-mails échoue ou si rien ne semble changer, commencez par ces vérifications :

* **Mailchimp Marketing vs Transactional**: vous devez utiliser une **Transactional (Mandrill)** clé.
* **401/403 de Mailchimp**: vérifiez la clé et que Transactional est activé.
* **E-mails non délivrés**: vérifiez votre domaine/adresse e-mail d’expéditeur dans Mailchimp Transactional.
* **Rien ne change après la 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 « les 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 offres standard de Mailchimp Marketing.

</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>Doit-on 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 garder SendGrid en préproduction 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 selon l’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 la préproduction 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, privilégiez le **même fournisseur** dans les deux environnements. Utilisez un sous-domaine d’expéditeur différent (par exemple `staging.wallet.yourbrand.com`) et n’envoyez qu’à des adresses internes.

</details>

<details>

<summary><strong>Quelle est la façon la plus rapide de valider ma configuration ?</strong></summary>

Enregistrez `/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: 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/mailchimp.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.
