# 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](/fr/docs/migrate/) 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](/fr/docs/workspaces/). Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Domaines | [Domaines d’envoi](/fr/docs/domains/) |
| 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](/fr/docs/developers/api-keys/) : **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](/fr/docs/workspaces/production-access/) et ne peuvent envoyer qu’aux membres de l’espace de travail. |
| Modèles | [Modèles](/fr/docs/templates/) avec un alias et des versions, dont le rendu est effectué avec [Temple](/fr/docs/templates/temple/) |
| Webhooks par domaine | [Webhooks](/fr/docs/webhooks/) par espace de travail |
| Routes entrantes (inbound routes) | [E-mails entrants](/fr/docs/inbound/), avec le webhook `email.received` ou l’[automatisation](/fr/docs/inbound/forward-with-automations/) **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](/fr/docs/suppressions/) 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 API → Emails** et **Email API → Logs** |
| Tags | `meta` |
| Vérification d’e-mails | [Vérification d’e-mails](/fr/docs/email-verification/) |
| IP dédiées | [IP dédiées](/fr/docs/deliverability/dedicated-ips/) 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 :

```bash title="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>"
  }'
```

```bash title="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 "` |
| `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](/fr/docs/email-api/headers-and-metadata/). |
| `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](/fr/docs/email-api/send-email/).

## 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](/fr/docs/smtp/settings/).

## 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}`](/fr/docs/api-reference/emails/get/) |

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](/fr/docs/webhooks/request-signature/).

```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 API → Suppressions**, 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](/fr/docs/suppressions/manage/).

## Transférer les modèles

Copiez le HTML de chaque modèle depuis l’éditeur de MailerSend, puis importez-le dans **Email Marketing → Templates** ou créez-le avec l’[API des modèles](/fr/docs/api-reference/templates/create/). 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](/fr/docs/templates/temple/) et [Importer et exporter des modèles](/fr/docs/templates/import-export/).

## Modifier le DNS

Ajoutez votre domaine dans **Email API → Domains** 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](/fr/docs/domains/dns-records/).

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](/fr/docs/inbound/set-up/).

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](/fr/docs/get-started/go-live/)
- [Configurer des webhooks](/fr/docs/webhooks/set-up/)
- [Migration prioritaire](/fr/docs/programs/priority-migration/) : laissez les ingénieurs d’Emailit effectuer la migration avec vous

---
Source: https://emailit.com/fr/docs/migrate/mailersend/
