This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mailchimp

Configurez The Wallet Crew pour envoyer des e-mails transactionnels via Mailchimp Transactional (Mandrill).

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.

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.

1

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.

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.

2

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.

API configuration in Mailchimp Transactional.
Configuration de l’API dans Mailchimp Transactional.

Suivez ce guide : Générez votre clé API.

3

Mettre à jour /server/emails.yml

Ouvrez l’éditeur de configuration avancée :

Console d’administration - Configuration avancée

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

/server/emails.yml
provider:
  type: mailchimp
  apiKey: md-xxxx
  from:
    email: [email protected]
    name: Support de votre marque
resources:
  - /locales/emails/

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

4

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.

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

Est-ce la même chose que « e-mails marketing Mailchimp » ?

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

Ai-je besoin d’un module complémentaire Mailchimp payant ?

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

Où configurer Mailchimp dans The Wallet Crew ?

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

Devons-nous authentifier notre domaine dans Mailchimp Transactional ?

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.

Puis-je conserver SendGrid en staging et Mailchimp en production ?

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.

Quel est le moyen le plus rapide de valider ma configuration ?

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

Mis à jour