# Mailchimp

The Wallet Crew peut envoyer des emails transactionnels via Mailchimp Transactional (Mandrill). Cela couvre des messages tels que les liens de téléchargement de carte, les emails de vérification, etc.

Par défaut, The Wallet Crew utilise **son propre compte SendGrid**. Vous pouvez basculer vers **votre propre compte Mailchimp Transactional** lorsque vous souhaitez centraliser l'activité d'email 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 marketing de Mailchimp telles que les audiences ou les campagnes.

Si vous n'êtes pas sûr de l'option à choisir, commencez par [Fournisseur d'email](https://docs.thewalletcrew.io/fr/connecter/email-provider).

## Configurer 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 ou l'adresse email de l'expéditeur que vous souhaitez utiliser.

{% stepper %}
{% step %}
**Décidez quel domaine d'expéditeur vous souhaitez utiliser**

Préférez un sous-domaine dédié tel que `wallet.yourbrand.com` ou `registration.yourbrand.com`. Cela permet de maintenir l'authentification des emails 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="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-ca18994e5cf2a59ddd8722db2ba37ff27af22de5%2Fmailchimp_1.png?alt=media" 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 %}
**Mettez à 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 : Support de Your brand
resources :
  - /locales/emails/
```

{% endcode %}

Remplacez `md-xxxx` par votre clé API Mandrill. Ensuite, définissez les `from` valeurs sur 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 email 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'emails é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é.
* **Emails non délivrés** : vérifiez votre domaine/email 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 « Mailchimp marketing emails » ?</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 add-on Mailchimp payant ?</strong></summary>

Généralement oui, car Transactional (Mandrill) est un produit distinct des plans standards 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>Devons-nous authentifier notre domaine dans Mailchimp Transactional ?</strong></summary>

**Oui**. Vérifiez l'identité de l'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 staging et Mailchimp en production ?</strong></summary>

Oui, mais ce n'est pas recommandé.

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

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>Quelle est la façon la plus rapide de valider ma configuration ?</strong></summary>

Enregistrez `/server/emails.yml`, déclenchez un seul email, puis vérifiez l'événement dans les journaux d'activité de Mailchimp Transactional.

</details>