Comment migrer de SendGrid vers Mailer To Go

Guide Migration, SMTP, Délivrabilité, SendGrid July 9, 2026 by Équipe Mailer To Go

Un guide étape par étape pour migrer les e-mails transactionnels de SendGrid vers Mailer To Go : configuration du domaine d'envoi, SPF/DKIM/DMARC, échange des identifiants SMTP/API, importation de votre liste de suppression, et une transition en exécution parallèle sécurisée avec restauration.

Migrer votre email transactionnel de SendGrid vers Mailer To Go est principalement un échange DNS et identifiants — la partie difficile n’est pas le code, c’est la transition sans perdre votre réputation d’envoi ou renvoyer à des gens qui ont déjà rejeté ou résilié. Ce guide parcourt toute la migration dans l’ordre, avec les changements de configuration exactes et un déploiement sûr et réversible.

Si vous hésitez encore, la comparaison Alternative à SendGrid couvre le pourquoi. Ce guide est le comment.

Avant de commencer : inventoriez ce que SendGrid fait pour vous

Les migrations tournent mal quand quelque chose d’invisible est laissé de côté. Notez :

Les domaines d’envoi et adresses From: d’où vous envoyez aujourd’hui.
Vos données de suppression — rebonds, blocages, signalements de spam et résiliations. C’est la seule chose que vous devez reporter ; renvoyer à une adresse supprimée sabote votre réputation dès le premier jour.
Comment vous envoyez — SMTP, l’API Web (@sendgrid/mail, sendgrid-ruby, sendgrid pour Python), ou les deux.
Templates stockés dans SendGrid (modèles dynamiques) versus rendus dans votre app.
Webhooks d’événements (livré/ouverture/clic/rebond) et tout ce qui en aval les consomme.
Volume approximatif quotidien/pic, pour que vous puissiez planifier l’échauffement.

Étape 1 — Créez votre domaine d’envoi Mailer To Go

Inscrivez-vous sur mailertogo.com et ajoutez un sous-domaine d’envoi plutôt que votre domaine racine — nous recommandons mtg.votredomaine.com. Il isole votre réputation et, si vous le déléguez, nous permet de gérer le DNS pour vous. Voir Pourquoi Mailer To Go envoie depuis mtg.votredomaine.com pour le raisonnement et la configuration.

Étape 2 — Authentifiez (SPF, DKIM, DMARC)

Publiez les enregistrements SPF, DKIM et DMARC affichés dans votre tableau de bord pour le domaine d’envoi. Si vous exécutez déjà DMARC pour SendGrid, vous avez une avance — vous ajoutez simplement Mailer To Go comme source autorisée pendant le chevauchement et resserrez une fois SendGrid disparu. Procédure complète avec enregistrements réels et vérification dig : Configuration de l’authentification email, de bout en bout.

Étape 3 — Échangez vos identifiants

SMTP. La configuration caractéristique de SendGrid est le nom d’utilisateur littéral apikey. Pointez le même mailer vers Mailer To Go à la place :

# Avant — SendGrid
host: smtp.sendgrid.net   port: 587
username: apikey
password: SG.xxxxxxxx   (votre clé API SendGrid)

# Après — Mailer To Go
host: smtp.<region>.mailertogo.net   port: 587
username: <MAILERTOGO_SMTP_USER>
password: <MAILERTOGO_SMTP_PASSWORD>

Dans Rails, ce ne sont que de nouvelles valeurs d’environnement — pas de changement de code :

# config/environments/production.rb
config.action_mailer.smtp_settings = {
  address:              ENV["MAILERTOGO_SMTP_HOST"],   # smtp.<region>.mailertogo.net
  port:                 587,
  user_name:            ENV["MAILERTOGO_SMTP_USER"],
  password:             ENV["MAILERTOGO_SMTP_PASSWORD"],
  authentication:       :plain,
  enable_starttls_auto: true
}

API. Si vous utilisez le SDK de SendGrid, basculez le transport vers SMTP (le chemin le moins coûteux en code) ou vers l’API Mailer To Go. En Node, quitter @sendgrid/mail pour SMTP via Nodemailer :

// Avant — @sendgrid/mail
// sgMail.setApiKey(process.env.SENDGRID_API_KEY);
// await sgMail.send({ to, from, subject, html });

// Après — Nodemailer sur SMTP Mailer To Go
const nodemailer = require("nodemailer");
const transport = nodemailer.createTransport({
  host: process.env.MAILERTOGO_SMTP_HOST,
  port: 587,
  auth: { user: process.env.MAILERTOGO_SMTP_USER, pass: process.env.MAILERTOGO_SMTP_PASSWORD },
});
await transport.sendMail({ to, from, subject, html });

Étape 4 — Importez votre liste de suppression (ne sautez pas)

Exportez vos suppressions de SendGrid avant la transition — Suppressions → Global Unsubscribes / Bounces / Spam Reports / Blocks dans le tableau de bord, ou via l’API :

curl -s -H "Authorization: Bearer $SENDGRID_API_KEY" \
  https://api.sendgrid.com/v3/suppression/bounces > bounces.json
curl -s -H "Authorization: Bearer $SENDGRID_API_KEY" \
  https://api.sendgrid.com/v3/suppression/unsubscribes > unsubscribes.json

Chargez ces adresses dans votre liste de suppression Mailer To Go pour qu’un contact qui a rejeté difficilement ou s’est désinscrit ne soit jamais envoyé à nouveau. Cette étape unique protège la réputation que vous avez passé des années à construire sur SendGrid.

Étape 5 — Échauffez-vous et basculez graduellement

Votre nouveau domaine d’envoi n’a pas encore de réputation, donc ne basculez pas 100 % du trafic à la fois. Exécutez les deux fournisseurs en parallèle et décalez le trafic par étapes — par ex. 10 % → 25 % → 50 % → 100 % sur une ou deux semaines — en commençant par votre email le plus engagé, le plus sûr (réinitialisations de mot de passe, reçus). Regardez les taux de rebond et de plaintes à chaque étape. Gardez SendGrid actif et capable de reprendre le trafic jusqu’à ce que vous soyez complètement basculé.

Étape 6 — Vérifiez, puis décommissionnez

Envoyez un email de test et confirmez que SPF, DKIM et DMARC passent tous (Gmail → Show original).
Repointer vos webhooks d’événements sur les gestionnaires Mailer To Go de votre app et confirmer que les événements de rebond/plainte circulent toujours.
Une fois que 100 % du trafic fonctionne correctement via Mailer To Go pendant quelques jours, rétrogradez ou annulez SendGrid — mais laissez vos enregistrements SPF/DKIM pour lui en place pendant une ou deux semaines au cas où vous deviez revenir en arrière, puis supprimez-les.

Retour en arrière

Parce que le changement est identifiants + DNS, le retour en arrière est rapide : repointer les variables d’environnement de votre mailer vers SendGrid. Garder les deux fournisseurs authentifiés pendant le chevauchement est ce qui fait que c’est un changement d’une ligne au lieu d’une urgence.

Nouveau dans l’envoi depuis un sous-domaine ou l’authentification email ? Commencez par Pourquoi Mailer To Go envoie depuis mtg.votredomaine.com et le guide de configuration SPF/DKIM/DMARC. Migration d’un autre fournisseur ? Voir Migration de Mailgun vers Mailer To Go.