SendGrid vers Mailtrap :
Un guide de migration

Ce guide couvre les principes de base pour migrer de SendGrid vers Mailtrap sans effort : comparaisons terminologiques, configurations SMTP ou API, et autres spécifications techniques nécessaires pour un passage tout en douceur.

Principales différences entre SendGrid et Mailtrap

  1. Selon le forfait, Mailtrap stocke les emails dans les journaux d’emails jusqu’à 60 jours. Le contenu des emails et les données historiques sont stockés et accessibles entre 3 et 15 jours sans frais supplémentaires.
  2. Vous pouvez demander une facturation ou un forfait annuel avec Mailtrap, au-delà des seuls forfaits facturés mensuellement.
  3. Mailtrap propose Email Testing. Il s’agit d’un produit distinct qui permet d’inspecter les scores de spam, le code HTML/ CSS, etc. et de déboguer les emails dans les environnements de staging, de développement et QA avant de les envoyer aux destinataires.
  4. Mailtrap ne dispose pas de l’option de programmation pour l’envoi d’emails différés.

Comparaison terminologique

  • Teammates
  • SendGrid Templates
  • Suppressions
  • Email Categories
  • Webhooks
  • X-SMTPAPI
  • unique_args

Flux général étape par étape pour la migration

  1. Inscrivez-vous à Mailtrap, ajoutez votre domaine d’envoi sous Sending Domains et vérifiez-le. Consultez notre Getting Started Guide pour plus de détails.

  2. Si vous utilisez un service SMTP, modifiez vos paramètres en conséquence.

  3. Si vous utilisez l’API, consultez nos bibliothèques et la documentation de l’API.

  4. Assurez-vous de bien comprendre les principales différences entre SendGrid et Mailtrap mentionnées ci-dessus.

    Besoin d’aide ?

    Contactez notre assistance et nos experts techniques vous apporteront leur aide.

  5. Si vous avez besoin d’envoyer plus de 200 000 emails par mois, n’hésitez pas à contacter le support Mailtrap. Nous programmerons un appel avec vous pour vous aider à effectuer la transition correctement.

    Astuce Mailtrap

    Vous pouvez utiliser la gemme ActionMailer Balancer de Ruby pour répartir proportionnellement la charge d’envoi d’emails entre deux services d’envoi différents (par exemple, 70 % SendGrid et 30 % Mailtrap) afin d’atténuer les risques liés à l’envoi.

Démarrage

Pour commencer à envoyer des emails avec Mailtrap, il vous suffit de créer un compte, de vous inscrire, puis de vérifier votre domaine. La configuration et la vérification du domaine s’effectuent depuis le menu Sending Domains.

Vérification du domaine

  • Une fois que vous avez créé un compte et ajouté votre domaine d’envoi, il vous faudra attendre jusqu’à deux jours ouvrables pour passer le contrôle de sécurité.
  • Assurez-vous de ne pas apporter de compléments, de corrections et d’autres modifications pendant la période de vérification du domaine, car cela pourrait être considéré comme un comportement suspect.
  • Jusqu’à ce que le domaine soit vérifié, le débit d’envoi est limité à 50 emails par heure pour éviter d’abuser du système avec des activités de spam. Pour en savoir plus, consultez notre article Sending Limits.
  • Les limites d’envoi peuvent être levées en contactant l’équipe d’assistance de Mailtrap. Dans ce cas, vous devrez répondre à plusieurs questions pour prouver la fiabilité et l’autorité de votre domaine d’envoi.

Envoi avec Mailtrap SMTP

SMTP Endpoints

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
smtp.sendgrid.net

SMTP Ports

PortFunctionMailtrap supportSendGrid support
587Recommandé pour une connexion SMTP TLS cryptée
25Peut poser problème en raison du blocage appliqué par certains fournisseurs de messagerie pour éviter les abus
2525Pour une connexion non chiffrée/TLS
465Pour une connexion SSL SMTP

Configuration SMTP

Après vous être inscrit et avoir vérifié votre domaine d’envoi, sélectionnez ce domaine et allez dans l’onglet SMTP/API Settings. Ensuite, choisissez Transactional ou Bulk Stream en fonction du type d’emails que vous souhaitez envoyer.

Copiez et collez les informations d’identification SMTP données (pour le flux que vous avez choisi) dans votre application.

Remarque : l’activation de TLS est obligatoire, comme indiqué dans les informations d’identification.

Envoi avec l’API Mailtrap

Mailtrap API tokens

Lors de la création d’un domaine, un jeton est automatiquement généré et nommé selon la formule suivante : [nom de domaine] + [jeton] + [ID du jeton]. Vous pouvez ajouter ou supprimer des autorisations de jeton en cochant les cases correspondantes dans le menu Tokens.

Pour en savoir plus sur la gestion des jetons API, consultez notre guide.

API Mapping

Type d’APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Bibliothèques d’API

Actuellement, il existe cinq bibliothèques disponibles sur Mailtrap.

Langage de ProgrammationMailtrapSendGrid
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython
ElixirElixir SDKNon pris en charge

Authentification de l’API

Nous utilisons l’authentification Bearer. Passez le jeton API dans le code sous l’en-tête Authorization.

Autorisations/Gestion des utilisateurs

Vous pouvez ajouter des utilisateurs à votre compte et gérer leurs autorisations si vous avez souscrit au forfait Business ou à un forfait supérieur. Pour ajouter des utilisateurs, attribuer et modifier leurs autorisations, cliquez sur l’onglet User Management et sur les trois points à droite.

Notez qu’un utilisateur a besoin de permissions fournies par un administrateur (Admin) pour s’authentifier et envoyer des emails via l’API.

En savoir plus sur la gestion des autorisations des utilisateurs.

ActionMailer Balancer pour une migration sans effort

Pour les applications Ruby on Rails, Mailtrap propose ActionMailer Balancer qui rend la migration plus fluide. L’extension ActionMailer permet de répartir proportionnellement la charge d’envoi d’emails entre deux services d’envoi différents et d’atténuer les risques d’envoi.

Après avoir installé le Balancer dans votre application et effectué quelques configurations mineures, celui-ci étendra la méthode d’envoi d’ActionMailer.

Pour en savoir plus sur le modèle de base et son utilisation en développement, consultez la page Github ActionMailer Balancer de Mailtrap.