circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

Mailchimp

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

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.

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.

1

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.

circle-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.

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é APIarrow-up-right.

3

Mettez à jour /server/emails.yml

Ouvrez l'éditeur de configuration avancée :

chevrons-rightConsole d'administration - Configuration avancée

Puis créez ou modifiez /server/emails.yml:

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

Remplacez md-xxxx par votre clé API Mandrill. Ensuite, définissez les from valeurs sur une identité d'expéditeur que Mandrill accepte.

circle-exclamation
4

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.

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

chevron-rightEst-ce la même chose que « Mailchimp marketing emails » ?hashtag

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

chevron-rightAi-je besoin d'un add-on Mailchimp payant ?hashtag

Généralement oui, car Transactional (Mandrill) est un produit distinct des plans standards Mailchimp Marketing.

chevron-rightOù configurer Mailchimp dans The Wallet Crew ?hashtag

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

chevron-rightDevons-nous authentifier notre domaine dans Mailchimp Transactional ?hashtag

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.

chevron-rightPuis-je garder SendGrid en staging et Mailchimp en production ?hashtag

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.

chevron-rightQuelle est la façon la plus rapide de valider ma configuration ?hashtag

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

Mis à jour