SendGrid

Configurez la manière dont The Wallet Crew envoie les e-mails transactionnels avec SendGrid.

The Wallet Crew peut envoyer des e-mails transactionnels via SendGrid. 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. Une marque peut passer à son propre compte SendGrid lorsqu’il a besoin de contrôler entièrement la délivrabilité, la réputation et la facturation.

Si la bonne option n’est pas encore évidente, commencez par Fournisseur d’e-mail.

Option 1 : Utiliser le compte SendGrid de The Wallet Crew

C’est l’option la plus simple, et c’est celle par défaut. Aucun compte SendGrid ni aucune gestion de clé API ne sont requis. The Wallet Crew s’en charge.

Pour rendre la marque visible dans la boîte de réception du client, activez un domaine d’envoi personnalisé. Cela améliore la délivrabilité. Cela réduit également les risques d’usurpation et d’hameçonnage.

Avec le compte SendGrid de The Wallet Crew, The Wallet Crew doit activer le domaine d’envoi personnalisé de son côté. Les enregistrements DNS (SPF/DKIM, et idéalement DMARC) doivent tout de même être ajoutés sur le domaine de la marque.

1

Déterminer quel domaine d’envoi 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.

Déléguer un sous-domaine dédié réduit la surface d’attaque et améliore la sécurité en isolant le trafic lié à la Carte. Il est recommandé d’utiliser le même domaine personnalisé que l’application.

2

Demandez au support d’activer le domaine d’envoi

Contactez le support de The Wallet Crew avec le sous-domaine à utiliser. L’équipe fournira les enregistrements DNS à ajouter et activera le domaine dans SendGrid.

3

Configurer le DNS (SPF, DKIM, DMARC)

Ajoutez les enregistrements DNS fournis par The Wallet Crew, puis attendez la propagation du DNS.

Pour le processus général et son importance, voir Domaine personnalisé.

4

Tester un envoi réel

Déclenchez un e-mail transactionnel et confirmez :

• l’e-mail est bien livré (non bloqué ni mis en quarantaine)
• l’expéditeur visible correspond au domaine prévu
• SPF/DKIM passent (vérifiez dans les en-têtes de la boîte aux lettres si nécessaire)

Option 2 : Utiliser un compte SendGrid dédié

1

Créer une clé API SendGrid

Dans SendGrid, allez à Paramètres → Clés API. Créez une clé API avec Mail Send autorisations.

2

Mettre à jour /server/emails.yml

Ouvrez l’éditeur de configuration avancée :

Administration de The Wallet Crew - configuration avancée

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

/server/emails.yml

provider:
  type: sendgrid
  apiKey: YOUR_SENDGRID_API_KEY
  from:
    email: [email protected]
    name: Votre marque
resources:
  - /locales/emails/

Utilisez un from.email qui appartient à un domaine authentifié dans SendGrid.

Traitez la clé API SendGrid comme un mot de passe.

Ne la collez pas dans des tickets ou des captures d’écran.

3

Configurer l’authentification de l’expéditeur dans SendGrid

Authentifiez le domaine d’envoi dans SendGrid à l’aide du flux standard « Domain Authentication ». Cela configure SPF et DKIM. Ajoutez un enregistrement DMARC pour le domaine d’envoi si nécessaire. Cela améliore la délivrabilité et réduit le risque d’usurpation.

4

Enregistrer et tester

Enregistrez le fichier. Déclenchez un seul e-mail transactionnel. Vérifiez l’événement dans les journaux d’activité de SendGrid.

Dépannage

• Si SendGrid renvoie 401 ou 403, la clé API est invalide ou ne dispose pas des autorisations requises.
• Si l’adresse « from » est rejetée, le domaine n’est pas authentifié. Vérifiez d’abord SPF et DKIM.
• Si les e-mails arrivent dans les spams, revérifiez l’authentification, la politique DMARC et la réputation de l’expéditeur.
• Si rien ne change après la modification, confirmez que le bon fichier de locataire a été enregistré. Le fichier doit être /server/emails.yml.

FAQ

Où SendGrid est-il configuré dans The Wallet Crew ?

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

Le compte SendGrid de The Wallet Crew peut-il être conservé au lieu d’un compte dédié ?

Oui. The Wallet Crew utilise sa propre configuration SendGrid par défaut.

L’envoi depuis un domaine contrôlé par la marque reste possible. Demandez au support d’activer un domaine d’envoi personnalisé, puis configurez SPF/DKIM et DMARC sur le DNS de la marque.

Le domaine d’envoi doit-il être authentifié dans SendGrid ?

Oui. Activez l’authentification de domaine SendGrid (SPF/DKIM). Ajoutez également un enregistrement DMARC pour le domaine ou le sous-domaine utilisé pour from.email.

Différents comptes SendGrid peuvent-ils être utilisés par environnement ?

Oui. Chaque locataire a sa propre configuration, donc une clé API différente peut être utilisée par locataire.

Quelle est la façon la plus rapide de valider l’intégration ?

Enregistrez /server/emails.yml, déclenchez un seul e-mail transactionnel, puis vérifiez-le dans le flux d’activité de SendGrid.