Vous aurez besoin d’un compte SendGrid (Twilio SendGrid) et d’un accès aux DNS de votre domaine.
Documentation propre à SendGrid : Authentification de l’expéditeur · Clés API · Inscription
1. Authentifiez votre domaine
Paramètres → Authentification de l’expéditeur → Authentifier votre domaine.
Choisissez votre hébergeur DNS dans la liste, et répondez Oui à « Souhaitez-vous également personnaliser la marque des liens pour ce domaine ? » — la personnalisation des liens réécrit les liens suivis vers votre propre domaine au lieu de sendgrid.net, et un client qui survole un lien dans votre facture doit voir votre nom.
Saisissez un sous-domaine tel que mail.votredomaine.com lorsqu’on vous demande le domaine à partir duquel vous envoyez.
2. Publiez les enregistrements CNAME
SendGrid vous fournit trois ou cinq enregistrements CNAME. Ajoutez-les tous.
| Type | Hôte | Rôle |
|---|
CNAME | em1234.votredomaine.com | Domaine du Return-path (rebonds) |
CNAME | s1._domainkey.votredomaine.com | Clé DKIM 1 |
CNAME | s2._domainkey.votredomaine.com | Clé DKIM 2 |
⭐ SendGrid utilise délibérément des CNAME plutôt que des enregistrements TXT, et c’est bien plus pratique : les véritables valeurs des clés résident chez SendGrid, ils peuvent donc effectuer la rotation de leurs clés de signature sans que vous ayez à retoucher vos DNS.
⚠️ Si votre fournisseur DNS est Cloudflare, définissez ces enregistrements sur DNS uniquement (nuage gris), et non sur proxy. Un CNAME relayé par proxy résout vers les adresses de Cloudflare et la vérification de SendGrid échoue.
Cliquez sur Vérifier dans SendGrid. Comptez jusqu’à une heure.
3. Créez une clé API
Paramètres → Clés API → Créer une clé API.
Choisissez Accès restreint et accordez uniquement Envoi d’e-mails → Accès complet. Rien d’autre.
⛔ N’utilisez pas de clé à accès complet (Full Access). Une clé à accès complet peut lire vos contacts, modifier les paramètres de votre compte et créer d’autres clés ; la seule chose dont nous avons besoin est d’envoyer un message. Si notre copie de votre clé venait à être exposée, la différence entre ces deux types de clés équivaut à la différence entre quelques e-mails indésirables et un compte compromis.
⚠️ La clé n’est affichée qu’une seule fois. Copiez-la avant de quitter la page — SendGrid ne peut pas vous la réafficher, seulement la remplacer.
4. Connectez-la dans Zinn®
Ouvrez Envoi d’e-mails dans votre tableau de bord :
- Fournisseur — SendGrid
- Envoyer depuis ce domaine —
mail.votredomaine.com (un domaine, pas une adresse)
- Clé API SendGrid — la clé obtenue à l’étape 3
SendGrid n’exige aucun autre paramètre de votre part.
5. Envoyez le test et saisissez le code
Cliquez sur Envoyer un message de test vers une boîte de réception située sur un autre domaine, lisez le code reçu, puis saisissez-le.
En cas de problème
403 Forbidden — votre clé API ne dispose pas de la permission Envoi d’e-mails. C’est de loin l’erreur la plus fréquente : une clé à accès restreint créée sans aucune permission cochée s’authentifie parfaitement mais n’a le droit de rien faire.
« The from address does not match a verified Sender Identity » — l’authentification de votre domaine n’est pas encore validée, ou le domaine indiqué dans Envoyer depuis ce domaine n’est pas celui que vous avez authentifié. SendGrid vérifie le domaine exact : authentifier mail.votredomaine.com n’autorise pas l’envoi depuis votredomaine.com.
Accepté mais jamais distribué — consultez l’onglet Activité dans SendGrid. Un compte flambant neuf est parfois retenu pour vérification pendant la première journée environ, et les messages y restent en attente au lieu d’être rejetés.
Votre compte a été suspendu après quelques envois — SendGrid est très strict avec les nouveaux comptes qui envoient vers des adresses qui génèrent des rebonds. Assurez-vous que votre liste de clients est propre avant d’effectuer la bascule.