SendGrid

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

Le 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. Vous pouvez passer à votre propre compte SendGrid lorsque vous avez besoin d’un contrôle total sur la délivrabilité, la réputation et la facturation.

Si vous ne savez pas quelle option choisir, commencez par Fournisseur d’e-mails.

Option 1 : Utiliser le compte SendGrid du Wallet Crew

C’est l’option la plus simple, et c’est celle par défaut. Vous n’avez pas besoin de créer un compte SendGrid ni de gérer des clés API. Le Wallet Crew s’occupe de tout.

Si vous voulez que les clients voient votre marque dans leur boîte de réception, activez un domaine d’envoi personnalisé. Cela améliore la délivrabilité. Cela réduit aussi les risques d’usurpation et de phishing.

Lorsque vous utilisez le compte SendGrid du Wallet Crew, Le Wallet Crew doit activer le domaine d’envoi personnalisé de son côté. Vous devrez quand même ajouter des enregistrements DNS (SPF/DKIM, et idéalement DMARC) sur votre domaine.

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.

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

2

Demandez au support d’activer votre domaine d’envoi

Contactez le support du Wallet Crew avec le sous-domaine que vous souhaitez 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 Le Wallet Crew, puis attendez la propagation du DNS.

Pour le processus général et pour comprendre pourquoi c’est important, voir Configuration du domaine personnalisé.

4

Tester un envoi réel

Déclenchez un e-mail transactionnel et confirmez :

• l’e-mail est bien distribué (non bloqué ou mis en quarantaine)
• l’expéditeur visible correspond au domaine que vous avez prévu
• SPF/DKIM passent (vérifiez dans les en-têtes de votre boîte mail si nécessaire)

Option 2 : Utiliser votre propre compte SendGrid

1

Créer une clé API SendGrid

Dans SendGrid, allez dans Paramètres → Clés API. Créez une clé API avec les autorisations d’envoi de mails .

2

Mettre à jour /server/emails.yml

Ouvrez l’éditeur de configuration avancée :

Administration du Wallet Crew - Configuration avancée

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

/server/emails.yml

fournisseur :
  type : sendgrid
  apiKey : YOUR_SENDGRID_API_KEY
  from:
    email : [email protected]
    name : Your Brand
ressources :
  - /locales/emails/

Utilisez un from.email appartenant à un domaine que vous authentifiez dans SendGrid.

Traitez votre 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 votre domaine d’envoi dans SendGrid en utilisant le flux standard « Authentification de domaine ». Cela configure SPF et DKIM. Ajoutez un enregistrement DMARC pour votre domaine d’envoi si nécessaire. Cela améliore la délivrabilité et réduit le risque d’usurpation.

4

Enregistrez et testez

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

Dépannage

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

FAQ

Où puis-je configurer SendGrid dans Le Wallet Crew ?

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

Pouvons-nous conserver le compte SendGrid du Wallet Crew au lieu d’utiliser le nôtre ?

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

Si vous le conservez, vous pouvez quand même envoyer depuis un domaine que vous contrôlez. Demandez au support d’activer un domaine d’envoi personnalisé, puis configurez SPF/DKIM et DMARC sur votre DNS.

Faut-il authentifier notre domaine dans SendGrid ?

Oui. Activez l’authentification de domaine SendGrid (SPF/DKIM). Ajoutez aussi un enregistrement DMARC pour le domaine ou sous-domaine que vous utilisez pour from.email.

Pouvons-nous utiliser différents comptes SendGrid par environnement ?

Oui. Chaque locataire a sa propre configuration. Vous pouvez utiliser différentes clés API par locataire.

Quel est le moyen le plus rapide de valider l’intégration ?

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