SendGrid vers Mailtrap :
Un Guide de Migration

Ce guide couvre les principes de base pour migrer de SendGrid vers Mailtrap sans difficulté : comparaisons de terminologie, configurations SMTP ou API, et autres spécifications techniques nécessaires pour une transition fluide.

Principales différences entre SendGrid et Mailtrap

  1. En fonction du plan tarifaire, Mailtrap conserve les emails dans les journaux d’emails pendant 30 jours. Le contenu des emails et les données historiques sont stockés et accessibles pendant 3 à 7 jours sans frais supplémentaires.
  2. Vous pouvez demander un plan de facturation annuel avec Mailtrap, et pas seulement des plans mensuels.
  3. Mailtrap propose Email Testing. Il s’agit d’un produit distinct pour inspecter l’HTML/CSS, les scores de spam, etc., et déboguer les emails dans des environnements de staging, de développement et de QA avant de les envoyer aux destinataires.

Comparaison de la terminologie

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

Processus de migration étape par étape

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

  2. Si vous utilisez le 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. Exportez votre liste de contacts de SendGrid en tant que CSV et importez-la dans Mailtrap. Consultez notre guide étape par étape.

    Besoin d’aide ?

    Contactez notre support et nos experts techniques vous aideront.

  5. Vous pouvez également importer vos modèles d’email sous forme HTML ou en créer de nouveaux en utilisant un créateur de modèle d’email en HTML ou en glisser-déposer. Pour plus d’informations, consultez notre guide des Modèles d’Email.

  6. Si vous prévoyez d’envoyer plus de 200 000 emails par mois, contacter le support de Mailtrap est fortement recommandé. Ils vous aideront tout au long du processus, attribueront une IP dédiée et vérifieront si tout est correctement configuré.

    Astuce Mailtrap

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

Pour commencer

Pour commencer à envoyer des emails avec Mailtrap, il vous suffit de créer un compte et de vérifier votre domaine. La configuration et la vérification du domaine se font dans le menu Sending Domains. Lisez cet article pour en savoir plus.

Vérification du domaine

  • Une fois que votre domaine est vérifié à l’aide des enregistrements DNS fournis, il subit un contrôle automatique de conformité. Ce processus prend généralement de quelques minutes à plusieurs heures. Vous pouvez envoyer des emails uniquement après que le contrôle de conformité a été entièrement validé et que le statut vérifié apparaisse à côté de votre domaine.
Onglet de vérification de domaine - domaine vérifié
  • Définissez les options de désabonnement avec Mailtrap et importez vos listes de suppression depuis SendGrid. N’oubliez pas d’importer votre liste de contacts et vos modèles HTML dans Mailtrap.
  • Optionnellement, créez des webhooks pour recevoir des informations sur les rebonds, les plaintes de spam, les ouvertures, les clics et d’autres événements.
  • Active le suivi des ouvertures et des clics pour comprendre comment les clients interagissent avec vos emails.

Envoi avec Mailtrap SMTP

Endpoints SMTP

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

Ports SMTP

PortFonctionSupport MailtrapSupport SendGrid
587Recommandé pour la connexion SMTP TLS chiffrée
25Peut poser problème en raison du blocage par certains fournisseurs de messagerie pour éviter les abus
2525Pour les connexions non chiffrées/TLS

Configuration SMTP

Allez dans Sending Domains (Domaines d’Envoi) et cliquez sur le domaine vérifié à partir duquel vous souhaitez envoyer des emails. Allez dans l’onglet Integration (Intégration) et cliquez sur Integrate (Intégrer) sous Transactional (Transactionnel) ou Bulk Stream (Flux en Masse), selon le type d’emails que vous souhaitez envoyer.

Onglet de sélection Integration des Sending Domains de Mailtrap

Copiez et collez les identifiants (pour le flux que vous avez choisi) dans votre application ou projet, et vous serez prêt à commencer à envoyer des emails. Lisez plus sur l’intégration SMTP ici.

Intégration SMTP du Flux d’envoi en masse de Mailtrap

Remarque: L’activation de TLS est obligatoire, comme indiqué dans les identifiants.

Envoi avec l’API de Mailtrap

Jetons de l’API de Mailtrap

Mailtrap crée automatiquement un jeton lorsque vous ajoutez un domaine. Par défaut, le jeton dispose des autorisations d’administrateur de domaine. Vous pouvez modifier les autorisations du jeton dans le menu API Tokens (Jetons API) sous Settings (Paramètres).

En savoir plus sur la gestion des jetons API dans notre guide.

Mappage d’API

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

Bibliothèques de l’API

Actuellement, neuf bibliothèques sont disponibles sur Mailtrap.

Langage de programmationMailtrapSendGrid
Node.jsNode.js SDKNodeJS
NodeMailer (Node.js)NodeMailer SDKNon supporté
PHPPHP SDKPHP
PHP (Laravel + Symphony)PHP SDKNon pris en charge (un seul pilote communautaire disponible)
RubyRuby SDKRuby
Ruby (ActionMailer)ActionMailer SDKUne bibliothèque communautaire
PythonPython SDKPython
ElixirElixir SDKBibliothèques communautaires uniquement
JavaJava SDKJava

Authentification de l’API

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

Permissions/Gestion des utilisateurs

Si vous êtes dans le plan Business ou supérieur, vous pouvez ajouter des utilisateurs à votre compte et gérer leurs autorisations. Pour cela, cliquez sur le menu User Management (Gestion des utilisateurs) dans les Settings (paramètres), puis sur les trois points (menu des options supplémentaires) à droite. Vous pouvez également gérer les utilisateurs et les autorisations avec API.

Menu User Management de Mailtrap

En fonction des autorisations que les utilisateurs reçoivent, ils peuvent afficher, accéder et/ou modifier des fonctionnalités spécifiques d’une application. Notez qu’un utilisateur a besoin des autorisations d’administrateur pour s’authentifier et envoyer des emails via API.

De plus, Mailtrap vous permet d’activer ou de désactiver l’authentification à deux facteurs (2FA) basée sur l’application pour tous ou certains utilisateurs de votre compte, avec la possibilité d’imposer la 2FA à tous les utilisateurs. Consultez notre guide 2FA pour plus de détails.

Si vous souhaitez en savoir plus sur la gestion des autorisations des utilisateurs, cliquez sur ce lien ◀️.

ActionMailer Balancer pour une migration en douceur

Pour les applications Ruby on Rails, Mailtrap propose ActionMailer Balancer, qui facilite la migration.

L’extension ActionMailer permet une distribution proportionnelle de la charge d’envoi des emails entre deux services d’envoi différents et réduit les risques d’envoi.

Après avoir installé le Balancer et effectué quelques configurations mineures, la méthode d’envoi d’ActionMailer sera étendue.

Pour plus d’informations détaillées sur le boilerplate et son utilisation en développement, consultez la page ActionMailer Balancer de Github de Mailtrap.