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
- 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.
- Vous pouvez demander un plan de facturation annuel avec Mailtrap, et pas seulement des plans mensuels.
- 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
- User Management
- Templates
- Suppressions
- Email Categories
- Webhooks
- Headers
- X-MT-Custom-Variables
- Teammates
- SendGrid Templates
- Suppressions
- Categories
- Webhooks
- X-SMTPAPI
- unique_args
Processus de migration étape par étape
-
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.
-
Si vous utilisez le service SMTP, modifiez vos paramètres en conséquence.
-
Si vous utilisez l’API, consultez nos bibliothèques et la documentation de l’API.
-
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.
-
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.
-
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.
- 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
Port | Fonction | Support Mailtrap | Support SendGrid |
587 | Recommandé pour la connexion SMTP TLS chiffrée | ||
25 | Peut poser problème en raison du blocage par certains fournisseurs de messagerie pour éviter les abus | ||
2525 | Pour 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.
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.
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’API | Mailtrap | SendGrid |
Email sending | Send email | |
User management | User management | Teammates |
Email Testing | Email Testing API |
Bibliothèques de l’API
Actuellement, neuf bibliothèques sont disponibles sur Mailtrap.
Langage de programmation | Mailtrap | SendGrid |
Node.js | Node.js SDK | NodeJS |
NodeMailer (Node.js) | NodeMailer SDK | Non supporté |
PHP | PHP SDK | PHP |
PHP (Laravel + Symphony) | PHP SDK | Non pris en charge (un seul pilote communautaire disponible) |
Ruby | Ruby SDK | Ruby |
Ruby (ActionMailer) | ActionMailer SDK | Une bibliothèque communautaire |
Python | Python SDK | Python |
Elixir | Elixir SDK | Bibliothèques communautaires uniquement |
Java | Java SDK | Java |
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.
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.