Mailgun vers Mailtrap :
Un guide de migration

Ce guide couvre les principes de base sur la façon de migrer de Mailgun vers Mailtrap en toute transparence : comparaisons terminologiques, configurations SMTP ou API et autres spécifications techniques nécessaires au passage en douceur.

Différences entre Mailtrap et Mailgun

  1. Vos emails sont stockés dans les Mailtrap Emails Logs jusqu’à 60 jours, en fonction du forfait que vous avez choisi. Nous stockons également le contenu des emails et les données historiques pendant 3 à 15 jours.
  2. Mailtrap propose des forfaits mensuels récurrents avec une option pour demander une facturation annuelle/un forfait annuel. Contrairement à Mailgun, Mailtrap ne propose pas de forfait de paiement à l’utilisation, mais nous offrons un forfait gratuit à vie (Free Forever) de 1 000 emails pour tester et évaluer notre service.
  3. Mailtrap propose un Bulk Stream (flux en vrac) permettant d’envoyer des emails à de nombreux destinataires en une seule fois (newsletters, promotions marketing, mises à jour de produits, etc.).
  4. Mailtrap a un produit distinct – Mailtrap Email Testing – pour tester vos emails en phase de staging, vérifier le score de spam, valider le code HTML et CSS et inspecter la délivrabilité avec différents fournisseurs de boîtes de réception. Essentiellement, Mailtrap Email Testing ne sert qu’à tester les emails dans un environnement sûr, sans les envoyer à vos destinataires.
  5. Vous ne pouvez pas programmer l’envoi d’emails différés avec Mailtrap.

Mailtrap et Mailgun – Similitudes

  1. Prise en charge de l’envoi par SMTP ou API REST.
  2. Vous pouvez utiliser des enregistrements de chemin de retour et DKIM pour vérifier un domaine.
  3. Lors de l’envoi à partir d’un domaine ajouté récemment, le débit est mis en file d’attente ou limité.
  4. Vous pouvez ajouter un fichier .csv pour importer des adresses email supprimées.
  5. Mailgun et Mailtrap permettent tous deux d’ajouter des options de désabonnement aux emails sans programmation.

Comparaison terminologique

  • Multi User Access
  • Mailgun Templates
  • Suppressions
  • Tags
  • Webhooks
  • X-headers
  • X-Mailgun-Variables

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

  1. Une fois votre inscription à Mailtrap terminée, accédez à Sending Domains. Ajoutez votre domaine et procédez à sa vérification.

  2. Si vous choisissez le service SMTP, modifiez les paramètres d’envoi selon les informations d’identification fournies par Mailtrap. Cf. les informations sous l’en-tête SMTP ci-dessous.

  3. Si vous choisissez l’intégration API, consultez la documentation API et les bibliothèques Mailtrap.

  4. Prenez le temps de comprendre les principales différences entre Mailgun et Mailtrap, comme indiqué 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, 60 % Mailgun et 40 % Mailtrap) afin d’atténuer les risques liés à l’envoi.

Démarrage

Commencer à utiliser Mailtrap ne demande pas beaucoup d’efforts. Il vous suffit de créer un compte, puis de procéder à la configuration et à la vérification de votre domaine à partir du menu Sending Domains. Consultez notre guide de démarrage (Getting Started Guide) pour en savoir plus. Voici une rapide présentation de la procédure.

Vérification du domaine

  • Après votre inscription, l’ajout et la vérification de votre domaine, celui-ci est soumis à une vérification de sécurité, qui prend généralement deux jours ouvrables. Pendant cette période, votre débit est limité à 50 emails par heure afin d’éviter tout abus du système. Pour en savoir plus, lisez notre article Sending Limits.
  • Il est essentiel de ne pas supprimer et réajouter pendant la vérification de sécurité, car cela sera considéré comme un comportement suspect.
  • Vous pouvez lever la limitation en soumettant un ticket d’assistance dans lequel il vous sera demandé de répondre à quelques questions pour prouver la fiabilité de votre domaine.
  • Assurez-vous de définir les options de désabonnement avec Mailtrap et d’importer vos listes de suppression à partir de Mailgun.

SMTP

SMTP Endpoints

Mailgun Server (EU) Mailgun Server (US)
live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
smtp.eu.mailgun.orgsmtp.mailgun.org

SMTP Ports

PortFunction
587Le relais SMTP recommandé avec TSL.
25Trafic élevé, bloqué par certains fournisseurs de boîtes de réception en raison d’abus.
2525Port alternatif, au cas où vous rencontreriez des problèmes avec d’autres ports.
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-collez les identifiants (pour le flux que vous avez choisi) dans votre application ou projet, puis envoyez un email de confirmation pour vérifier la configuration. Consultez notre article Sending Domain Setup pour plus d’informations sur la procédure à suivre.

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

API

Mailtrap API tokens

Mailtrap crée automatiquement un jeton lorsque vous créez un domaine. Ce jeton dispose d’une autorisation d’accès Domain Admin par défaut. Vous pouvez modifier les autorisations pour ce jeton afin de l’autoriser avec d’autres domaines de votre compte.

Pour plus d’informations sur la gestion des jetons API, consultez notre guide.

API Mapping

Type d’APIMailtrapMailgun
The BasicsGeneralIntroduction
SendingSend emailMessages
Email TestingEmail Testing API

Bibliothèques d’API

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

Langage de programmationMailtrapMailgun
NodeJSNodeJS SDKMailgunJS
RubyRuby SDKMailgun Ruby Gem
PHPPHP SDKMailgunPHP
PythonPython SDKNon pris en charge
ElixirElixir SDKNon pris en charge

Authentification de l’API

Mailtrap utilise l’authentification Bearer. Vous devez donc transmettre le jeton API dans l’en-tête Authorization de votre email.

Gestion des utilisateurs

À partir du forfait Business sur Mailtrap Email API, vous pouvez ajouter des utilisateurs à votre compte et gérer leurs autorisations. En cliquant sur User Management, vous découvrez tous les utilisateurs d’un compte particulier. Vous pouvez facilement y ajouter de nouveaux membres et leur attribuer des autorisations.

En fonction des autorisations accordées aux utilisateurs, ceux-ci pourront afficher des fonctionnalités spécifiques d’une application, y accéder et/ou les modifier. Notez qu’un utilisateur a besoin d’autorisations d’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.