Guide
Migrer depuis MailerSend
Passez de MailerSend à Emailit. Faites correspondre les domaines, les jetons et les utilisateurs SMTP, convertissez les appels API et la personnalisation, changez les paramètres SMTP, et transférez webhooks, adresses bloquées et modèles.
Ce guide fait correspondre les concepts, les appels API, les webhooks, les adresses bloquées et les modèles de MailerSend à leurs équivalents dans Emailit. Lisez d’abord Migrer vers Emailit pour l’ordre général et la façon de faire fonctionner les deux fournisseurs en parallèle.
Concepts
| MailerSend | Emailit |
|---|---|
| Compte | Compte et espaces de travail. Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Domaines | Domaines d’envoi |
| Identités d’expéditeur (sender identities) | Non disponible. Chaque adresse d’expéditeur doit se trouver sur un domaine vérifié. |
| Jetons d’API avec portées | Clés API : Full Access, ou Sending Only, éventuellement restreinte à un domaine |
| Utilisateurs SMTP | Votre clé API, utilisée comme mot de passe SMTP |
| Domaine de test et mode bac à sable | Pas de domaine de test partagé. Les nouveaux espaces de travail sont en mode bac à sable et ne peuvent envoyer qu’aux membres de l’espace de travail. |
| Modèles | Modèles avec un alias et des versions, dont le rendu est effectué avec Temple |
| Webhooks par domaine | Webhooks par espace de travail |
| Routes entrantes (inbound routes) | E-mails entrants, avec le webhook email.received ou l’automatisation Forward received email |
| Adresses bloquées par domaine : rebonds définitifs, plaintes pour spam, désinscriptions, liste de blocage | Une seule liste d’adresses bloquées par espace de travail |
| Liste de mise en attente (on hold list) | Inutile. Emailit réessaie les rebonds temporaires et signale chaque tentative avec email.attempted. |
| Activity | Email APIEmails et Email APILogs |
| Tags | meta |
| Vérification d’e-mails | Vérification d’e-mails |
| IP dédiées | IP dédiées sur demande |
Mettre à jour vos appels API
Le POST /v1/email de MailerSend devient POST /v2/emails. Les deux reçoivent un jeton bearer et du JSON, mais les adresses d’Emailit sont de simples chaînes au lieu d’objets :
curl https://api.mailersend.com/v1/email \
-H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": { "email": "hello@acme.com", "name": "Acme" },
"to": [{ "email": "ada@example.com" }],
"subject": "Your receipt",
"text": "Thanks for your order.",
"html": "<p>Thanks for your order.</p>"
}'curl https://api.emailit.com/v2/emails \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <hello@acme.com>",
"to": "ada@example.com",
"subject": "Your receipt",
"text": "Thanks for your order.",
"html": "<p>Thanks for your order.</p>"
}'| MailerSend | Emailit |
|---|---|
Authorization: Bearer <token> |
Authorization: Bearer secret_… |
from: { email, name } |
from: "Name <email>" |
to[], cc[], bcc[] avec email et name |
to, cc, bcc sous forme de chaîne ou de tableau, 50 adresses au maximum pour chacun |
reply_to: { email, name } |
reply_to |
subject, text, html |
Identiques |
headers: [{ "name": "…", "value": "…" }] |
headers: { "Name": "Value" } |
list_unsubscribe |
headers avec List-Unsubscribe et List-Unsubscribe-Post. Voir En-têtes et métadonnées. |
attachments[] avec content, filename, disposition et id |
attachments[] avec content, filename et content_type, ou une url à la place de content. Utilisez content_id pour les images intégrées. |
template_id |
template, un ID ou un alias de modèle |
personalization: [{ "email": "…", "data": { … } }] |
variables, avec une requête par destinataire quand les valeurs diffèrent |
tags |
meta, renvoyé dans les événements webhook |
send_at (horodatage Unix ou ISO 8601) |
scheduled_at (ISO 8601 ou anglais courant). Convertissez d’abord les horodatages Unix en ISO 8601. |
settings.track_opens, settings.track_clicks |
tracking: { "loads": true, "clicks": true } |
POST /v1/bulk-email |
Non disponible. Envoyez une requête par message. |
202 Accepted avec un en-tête x-message-id et un corps vide |
200 avec un corps JSON : id (em_…), status: "accepted" et, pour plusieurs destinataires, ids avec un ID par destinataire |
Chaque destinataire d’une requête Emailit devient un e-mail distinct avec son propre ID. MailerSend répond 202 même quand tous les destinataires sont bloqués, avec un avertissement dans le corps. Emailit accepte lui aussi les destinataires qui ont un blocage de type recipient, et donne à chacun le statut suppressed. Ajoutez un en-tête Idempotency-Key pour sécuriser les relances. Consultez Envoyer un e-mail.
Changer les paramètres SMTP
| Paramètre | MailerSend | Emailit |
|---|---|---|
| Hôte | smtp.mailersend.net |
smtp.emailit.com |
| Port | 587 (STARTTLS) |
587, 2587, 2525 ou 25 (STARTTLS), 465 (TLS) |
| Nom d’utilisateur | Le nom d’utilisateur généré pour l’utilisateur SMTP | emailit |
| Mot de passe | Le mot de passe de l’utilisateur SMTP | Votre clé API Emailit |
Emailit ne lit pas l’en-tête X-MailerSend-Tags. Supprimez-le. Contrairement à MailerSend, Emailit livre vos autres en-têtes personnalisés sans les modifier. Consultez Paramètres SMTP.
Faire correspondre les événements webhook
| Événement MailerSend | Événement Emailit |
|---|---|
activity.sent |
email.accepted (API uniquement) |
activity.delivered |
email.delivered |
activity.deferred |
email.attempted |
activity.soft_bounced |
email.attempted pendant qu’Emailit réessaie, puis email.bounced si toutes les nouvelles tentatives échouent |
activity.hard_bounced |
email.bounced |
activity.suppressed |
email.suppressed |
activity.opened, activity.opened_unique |
email.loaded, envoyé à chaque chargement |
activity.clicked, activity.clicked_unique |
email.clicked, envoyé à chaque clic |
activity.spam_complaint |
email.complained |
activity.unsubscribed |
email.unsubscribed, pour les e-mails de campagne uniquement |
| Route entrante qui transfère vers un webhook | email.received, puis récupérez le contenu avec GET /emails/{id} |
Le format des requêtes change :
- MailerSend envoie un événement par requête. Emailit envoie un tableau JSON de 100 événements au maximum : parcourez donc le corps avec une boucle.
- Dans les deux cas, le nom de l’événement se trouve dans
type. Chez Emailit, l’e-mail se trouve dansdata.object: utilisezdata.object.id, l’IDem_de la réponse d’envoi, au lieu dedata.message_id(data.email.message.iddans les webhooks de version 1), etdata.object.toau lieu dedata.recipient. Vos valeursmetase trouvent dansdata.object.meta. - Pour
email.loadedetemail.clicked,data.objectest le chargement ou le clic. Utilisezdata.object.email_idpour l’ID de l’e-mail, etdata.object.email.rcpt_toetdata.object.email.metapour le destinataire et vos valeursmeta. - L’en-tête
Signaturede MailerSend est un HMAC-SHA256 du corps brut. L’en-têteX-Emailit-Signatured’Emailit est un HMAC-SHA256 de<timestamp>.<raw body>, calculé avec votre secretwhsec_: lisez donc aussiX-Emailit-Timestamp. Consultez Signature des requêtes.
for (const event of req.body) {
const email = event.data.object;
if (event.type === 'email.bounced') markBounced(email.to, email.id);
if (event.type === 'email.complained') unsubscribe(email.to);
}Transférer les adresses bloquées
-
Dans MailerSend, exportez les listes Hard bounces, Spam complaints, Unsubscribes et Blocklist de chaque domaine, depuis les pages des adresses bloquées ou avec l’API (
/v1/suppressions/hard-bounces,/spam-complaints,/unsubscribeset/blocklist). La liste de mise en attente est temporaire : vous pouvez donc la laisser de côté. -
Constituez un seul CSV avec les colonnes
email,type,reason:email,type,reason old-address@example.com,recipient,mailersend hard bounce angry@example.com,recipient,mailersend spam complaintUtilisez le type
recipientpour les adresses qui ne doivent jamais recevoir d’e-mail. Il bloque les envois par l’API, par SMTP et par les campagnes. Pour les personnes qui se sont seulement désinscrites des e-mails marketing, utilisez le typeunsubscribe, qui arrête les campagnes mais laisse passer les e-mails transactionnels. -
Dans Email APISuppressions, sélectionnez Import et chargez le fichier. Chaque fichier peut contenir 10 000 lignes et peser 8 Mo au maximum. Les doublons sont ignorés.
Emailit a une seule liste d’adresses bloquées par espace de travail : les adresses de tous vos domaines MailerSend vont donc dans la même liste. Les blocages portent sur des adresses exactes : les motifs de liste de blocage comme .*@example.com n’ont pas d’équivalent. Consultez Gérer les adresses bloquées.
Transférer les modèles
Copiez le HTML de chaque modèle depuis l’éditeur de MailerSend, puis importez-le dans Email MarketingTemplates ou créez-le avec l’API des modèles. Donnez-lui un alias, comme receipt, et envoyez-le avec "template": "receipt" et variables.
La personnalisation de MailerSend est une version limitée de Twig. Temple couvre les usages courants :
| MailerSend | Emailit (Temple) |
|---|---|
{{ name }}, {{ user.name }} |
{{name}}, {{user.name}} |
{{ name|default('there') }} |
{{name|"there"}} |
{% if plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if plan == "pro" %}, {% elseif %} |
Non pris en charge. Transmettez un booléen comme is_pro et utilisez {{#if is_pro}}. |
{% for item in items %}…{% endfor %} |
Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. |
{{ name|upper }} et les autres filtres |
Non pris en charge. Mettez en forme la valeur dans votre code. |
personalization[].data |
variables |
MailerSend retire la plupart du HTML des valeurs de personnalisation. Temple n’échappe et ne retire jamais le HTML : échappez les saisies des utilisateurs avant de les transmettre. Consultez Temple et Importer et exporter des modèles.
Modifier le DNS
Ajoutez votre domaine dans Email APIDomains et publiez les enregistrements Emailit. Ils utilisent leurs propres noms (emailit._domainkey, emailit.<domain>, et éventuellement go et inbound) : ils n’entrent donc pas en conflit avec les enregistrements DKIM ms1._domainkey et ms2._domainkey de MailerSend, ni avec son CNAME de return-path mta ou son CNAME de suivi email. Conservez votre enregistrement DMARC. Consultez Enregistrements DNS.
Le routage entrant de MailerSend utilise lui aussi un sous-domaine inbound par défaut. Si c’est votre cas, donnez un autre sous-domaine à la réception Emailit avec inbound_key, ou basculez l’enregistrement MX au moment où vous déplacez les e-mails entrants. Consultez Configurer la réception.
Après la bascule, supprimez les enregistrements DKIM, de return-path et de suivi de MailerSend, et retirez include:_spf.mailersend.net de votre enregistrement SPF.
Étapes suivantes
- Liste de contrôle avant la mise en production
- Configurer des webhooks
- Migration prioritaire : laissez les ingénieurs d’Emailit effectuer la migration avec vous