# Migrer depuis Mailtrap

> Passez de Mailtrap Email Sending à Emailit. Faites correspondre les flux, les jetons et les sous-comptes, convertissez les appels API et les modèles Handlebars, changez les paramètres SMTP, et transférez webhooks, adresses bloquées et contacts.

Ce guide fait correspondre les concepts, les appels API, les webhooks, les adresses bloquées, les modèles et les contacts de Mailtrap Email Sending à 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

| Mailtrap | Emailit |
| --- | --- |
| Organisation et sous-comptes | Compte et [espaces de travail](/fr/docs/workspaces/). Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Domaines d’envoi | [Domaines d’envoi](/fr/docs/domains/) |
| Flux transactionnel (transactional stream) | L’[API e-mail](/fr/docs/email-api/) et le [relais SMTP](/fr/docs/smtp/) |
| Flux bulk (bulk stream) | Des [campagnes](/fr/docs/campaigns/), ou l’API avec vos propres en-têtes `List-Unsubscribe` |
| Jetons d’API avec droits par ressource | [Clés API](/fr/docs/developers/api-keys/) : **Full Access**, ou **Sending Only**, éventuellement restreinte à un domaine |
| Domaine de démonstration | Les nouveaux espaces de travail sont en [mode bac à sable](/fr/docs/workspaces/production-access/) et peuvent envoyer aux membres de l’espace de travail depuis votre propre domaine vérifié. |
| Email Sandbox (tests) | Non disponible. Gardez l’Email Sandbox de Mailtrap pour vos tests, ou envoyez aux membres de l’espace de travail pendant le développement. |
| 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 flux | [Webhooks](/fr/docs/webhooks/) par espace de travail |
| Adresses bloquées par domaine et par flux | Une seule [liste d’adresses bloquées](/fr/docs/suppressions/) par espace de travail |
| Logs d’e-mails | **Email API → Emails** et **Email API → Logs** |
| `category` et `custom_variables` | `meta` |
| Email Marketing : contacts, listes, campagnes, automatisations | [Contacts](/fr/docs/contacts/), [listes de contacts](/fr/docs/audiences/), [campagnes](/fr/docs/campaigns/) et [automatisations](/fr/docs/automations/) (bêta) |
| E-mails entrants | [E-mails entrants](/fr/docs/inbound/) |

Pour séparer la réputation transactionnelle et la réputation marketing, comme le font les deux flux de Mailtrap, envoyez-les depuis des domaines ou sous-domaines différents, par exemple `mail.acme.com` pour les reçus et `news.acme.com` pour les newsletters.

## Mettre à jour vos appels API

Le `POST /api/send` de Mailtrap 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: Mailtrap"
curl https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_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>"
  }'
```

| Mailtrap | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` ou `Api-Token: <token>` | `Authorization: Bearer secret_…` |
| `send.api.mailtrap.io` et `bulk.api.mailtrap.io` | Un seul hôte, `api.emailit.com` |
| `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`, `headers` | Identiques |
| `attachments[]` avec `content`, `filename`, `type`, `disposition` et `content_id` | `attachments[]` avec `content`, `filename`, `content_type` et `content_id`, ou une `url` à la place de `content` |
| `category` | `meta`, par exemple `meta: { "category": "password-reset" }` |
| `custom_variables` | `meta`, renvoyé dans les événements webhook |
| `template_uuid` et `template_variables` | `template` (un alias ou un ID) et `variables` |
| Suivi réglé par domaine | Suivi réglé par domaine, ou par e-mail avec `tracking: { "loads": true, "clicks": true }` |
| `POST /api/batch` (500 messages au maximum) | Non disponible. Envoyez une requête par message. |
| Réponse avec `message_ids`, un par destinataire | `200` avec `id` (`em_…`), `status: "accepted"` et, pour plusieurs destinataires, `ids` avec un ID par destinataire |

Emailit prend aussi en charge la programmation avec `scheduled_at` et les relances sûres avec un en-tête `Idempotency-Key`, ce que l’API d’envoi de Mailtrap ne propose pas. Consultez [Envoyer un e-mail](/fr/docs/email-api/send-email/).

## Changer les paramètres SMTP

| Paramètre | Mailtrap | Emailit |
| --- | --- | --- |
| Hôte | `live.smtp.mailtrap.io`, ou `bulk.smtp.mailtrap.io` pour le flux bulk | `smtp.emailit.com` |
| Port | `587`, `2525` ou `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Nom d’utilisateur | `api` | `emailit` |
| Mot de passe | Votre jeton d’API Mailtrap | Votre clé API Emailit |

Emailit ne lit pas les en-têtes `X-MT-Category` ni `X-MT-Custom-Variables`. Supprimez-les et utilisez l’API quand vous avez besoin de métadonnées. Consultez [Paramètres SMTP](/fr/docs/smtp/settings/).

## Faire correspondre les événements webhook

| Événement Mailtrap | Événement Emailit |
| --- | --- |
| `delivery` | `email.delivered` |
| `soft bounce` | `email.attempted` pendant qu’Emailit réessaie, puis `email.bounced` si toutes les nouvelles tentatives échouent |
| `bounce` | `email.bounced` |
| `reject` | `email.suppressed` quand l’adresse a un blocage de type `recipient` |
| `suspension` | `email.held` |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, pour les e-mails de campagne uniquement |
| `inbound.message_received` | `email.received`, puis récupérez le contenu avec [`GET /emails/{id}`](/fr/docs/api-reference/emails/get/) |

Emailit envoie aussi `email.accepted` quand l’API accepte un e-mail. Consultez [Types d’événements](/fr/docs/webhooks/event-types/).

Le format des requêtes change :

- Mailtrap envoie une liste `events` de 500 événements au maximum, ou du JSON Lines. Emailit envoie comme corps de la requête un tableau JSON de 100 événements au maximum.
- Le nom de l’événement se trouve dans `type`, et l’e-mail dans `data.object`. Utilisez `data.object.id`, l’ID `em_` de la réponse d’envoi, au lieu de `message_id`, et `data.object.to` au lieu de `email`. Vos valeurs `meta`, qui remplacent `category` et `custom_variables`, 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 `Mailtrap-Signature` de Mailtrap 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. Exportez vos adresses bloquées depuis **Suppressions** dans Mailtrap, ou parcourez les pages de `GET https://mailtrap.io/api/suppressions`, qui renvoie 1 000 entrées au maximum par appel.

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

   | Type Mailtrap | Type Emailit |
   | --- | --- |
   | `hard bounce`, `spam complaint`, `manual import` | `recipient`, qui bloque les envois par l’API, par SMTP et par les campagnes |
   | `unsubscription` | `unsubscribe`, qui arrête les campagnes mais laisse passer les e-mails transactionnels. Utilisez `recipient` pour les désinscriptions du flux transactionnel. |

```csv
email,type,reason
old-address@example.com,recipient,mailtrap hard bounce
left@example.com,unsubscribe,mailtrap unsubscription
```

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 : les adresses bloquées pour plusieurs domaines ou flux Mailtrap ne sont donc ajoutées qu’une fois.

Consultez [Gérer les adresses bloquées](/fr/docs/suppressions/manage/).

## Transférer les contacts

Si vous utilisez Mailtrap Email Marketing, exportez vos contacts depuis **Contacts** avec **More Actions > Export**, ou avec `POST https://mailtrap.io/api/contacts/exports` filtré sur `subscription_status` et `list_id`. Créez d’abord dans Emailit les [champs personnalisés](/fr/docs/contacts/custom-fields/) et les [listes de contacts](/fr/docs/audiences/) correspondants.

N’importez que les contacts abonnés, une liste de contacts à la fois, dans **Email Marketing → Contacts** avec **Import**. L’import ajoute toutes les personnes du fichier comme abonnées : ajoutez donc plutôt les contacts désinscrits à votre fichier d’adresses bloquées, avec le type `unsubscribe`. Découpez les fichiers en parties de 2 500 lignes au maximum. Consultez [Importer et exporter des contacts](/fr/docs/contacts/import-export/).

## Transférer les modèles

Récupérez le HTML de vos modèles avec `GET https://mailtrap.io/api/email_templates`, qui renvoie le `body_html`, le `body_text` et le `subject` de chaque modèle. Importez chacun d’eux dans **Email Marketing → Templates** ou créez-le avec l’[API des modèles](/fr/docs/api-reference/templates/create/), et donnez-lui un alias, comme `receipt`.

Les modèles Mailtrap utilisent Handlebars. Temple couvre les usages courants :

| Mailtrap (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{name}}`, `{{user.name}}` | Identique |
| `{{{html_block}}}` | `{{html_block}}`. Temple n’échappe jamais le HTML : échappez vous-même les saisies des utilisateurs. |
| `{{#if plan}}…{{else}}…{{/if}}` | Identique |
| `{{#unless plan}}…{{/unless}}` | `{{#if plan}}{{else}}…{{/if}}` |
| `{{#if name}}{{name}}{{else}}Customer{{/if}}` | `{{name\|"Customer"}}` |
| `{{#each items}}…{{/each}}`, `{{#with}}` | Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. |
| `template_variables` | `variables` |

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 `rwmt1._domainkey` et `rwmt2._domainkey` de Mailtrap, ni avec son CNAME de vérification ou son CNAME de suivi `mt-link`. Conservez votre enregistrement DMARC. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/).

Après la bascule, supprimez les enregistrements DKIM, de vérification et de suivi de Mailtrap, ainsi que `include:_spf.mailtrap.io` si votre enregistrement SPF le contient encore. La réception Mailtrap utilise l’enregistrement MX de votre domaine racine, et la réception Emailit un sous-domaine comme `inbound.acme.com` : déplacez donc les e-mails entrants et mettez à jour vos adresses de réception avant de modifier l’enregistrement MX. Consultez [Configurer la réception](/fr/docs/inbound/set-up/).

## É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/mailtrap/
