Aller au contenu
Docs

Guide

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.

Mis à jour le 23 oct. 2026

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 :

Before: MailerSend
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>"
  }'
After: Emailit
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 dans data.object : utilisez data.object.id, l’ID em_ de la réponse d’envoi, au lieu de data.message_id (data.email.message.id dans les webhooks de version 1), et data.object.to au lieu de data.recipient. Vos valeurs meta se trouvent dans data.object.meta.
  • Pour email.loaded et email.clicked, data.object est le chargement ou le clic. Utilisez data.object.email_id pour l’ID de l’e-mail, et data.object.email.rcpt_to et data.object.email.meta pour le destinataire et vos valeurs meta.
  • L’en-tête Signature de MailerSend est un HMAC-SHA256 du corps brut. L’en-tête X-Emailit-Signature d’Emailit est un HMAC-SHA256 de <timestamp>.<raw body>, calculé avec votre secret whsec_ : lisez donc aussi X-Emailit-Timestamp. Consultez Signature des requêtes.
JavaScript
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

  1. 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, /unsubscribes et /blocklist). La liste de mise en attente est temporaire : vous pouvez donc la laisser de côté.

  2. Constituez un seul CSV avec les colonnes email,type,reason :

    CSV
    email,type,reason
    old-address@example.com,recipient,mailersend hard bounce
    angry@example.com,recipient,mailersend spam complaint

    Utilisez le type recipient pour 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 type unsubscribe, qui arrête les campagnes mais laisse passer les e-mails transactionnels.

  3. 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

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.