# Migrer depuis Mailjet

> Passez de Mailjet à Emailit. Faites correspondre les paires de clés API et les expéditeurs, convertissez les appels à la Send API v3.1 et le langage de modèles, changez les paramètres SMTP, et transférez webhooks, exclusions et listes de contacts.

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

| Mailjet | Emailit |
| --- | --- |
| Clé API principale et clés API des sous-comptes | Compte et [espaces de travail](/fr/docs/workspaces/). Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Paire de clés API (clé publique et clé secrète) | [Clé API](/fr/docs/developers/api-keys/) : **Full Access**, ou **Sending Only**, éventuellement restreinte à un domaine |
| Expéditeurs : adresses individuelles et domaines entiers | [Domaines d’envoi](/fr/docs/domains/). Les adresses d’expéditeur individuelles ne sont pas disponibles. |
| `SandboxMode` | Pas de mode test. Les nouveaux espaces de travail sont en [mode bac à sable](/fr/docs/workspaces/production-access/) et ne livrent qu’aux membres de l’espace de travail. |
| Modèles et langage de modèles Mailjet | [Modèles](/fr/docs/templates/) avec un alias et des versions, dont le rendu est effectué avec [Temple](/fr/docs/templates/temple/) |
| Event API, une URL par type d’événement | [Webhooks](/fr/docs/webhooks/) : un seul endpoint peut recevoir tous les types d’événements |
| Parse API | [E-mails entrants](/fr/docs/inbound/) |
| Liste d’exclusion, contacts ayant porté plainte pour spam et adresses bloquées | [Adresses bloquées](/fr/docs/suppressions/) |
| Contacts, listes de contacts et propriétés de contact | [Contacts](/fr/docs/contacts/), [listes de contacts](/fr/docs/audiences/) et [champs personnalisés](/fr/docs/contacts/custom-fields/) |
| Segments | Choisissez et excluez des listes de contacts dans chaque campagne. Les [segments](/fr/docs/segments/) sont en alpha et réservés à l’équipe Emailit. |
| Campagnes et automatisations | [Campagnes](/fr/docs/campaigns/) et [automatisations](/fr/docs/automations/) (bêta) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Statistiques et historique des messages | **Email API → Emails**, **Email API → Logs** et [rapports de campagne](/fr/docs/campaigns/reports/) |

## Mettre à jour vos appels API

Le `POST /v3.1/send` de Mailjet reçoit une authentification basique et une liste `Messages` aux champs en PascalCase. Le `POST /v2/emails` d’Emailit reçoit un jeton bearer et un seul message aux champs en minuscules :

```bash title="Before: Mailjet"
curl https://api.mailjet.com/v3.1/send \
  --user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
  -H "Content-Type: application/json" \
  -d '{
    "Messages": [{
      "From": { "Email": "hello@acme.com", "Name": "Acme" },
      "To": [{ "Email": "ada@example.com" }],
      "Subject": "Your receipt",
      "TextPart": "Thanks for your order.",
      "HTMLPart": "<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>"
  }'
```

| Mailjet (Send API v3.1) | Emailit |
| --- | --- |
| Authentification basique avec la clé publique et la clé secrète | `Authorization: Bearer secret_…` |
| `api.mailjet.com`, ou `api.us.mailjet.com` pour les comptes US | Un seul hôte, `api.emailit.com` |
| `Messages[]`, 50 au maximum par appel | Un message par requête |
| `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 |
| `ReplyTo` | `reply_to` |
| `Subject`, `TextPart`, `HTMLPart` | `subject`, `text`, `html` |
| `Headers` | `headers` |
| `Attachments[]` avec `ContentType`, `Filename`, `Base64Content` | `attachments[]` avec `content_type`, `filename`, `content` |
| `InlinedAttachments[]` avec `ContentID` | `attachments[]` avec un `content_id`, référencé par `cid:` dans le HTML |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta`, par exemple `meta: { "custom_id": "order-123" }`, renvoyé dans les événements webhook |
| `TemplateID`, `TemplateLanguage: true` et `Variables` | `template` (un alias ou un ID) et `variables` |
| `TrackOpens`, `TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `URLTags` | Ajoutez des paramètres UTM à vos liens. Les campagnes les ajoutent pour vous. |
| `Globals` | Non disponible. Répétez les champs communs dans chaque requête. |
| Réponse avec `MessageUUID` et `MessageID` pour chaque destinataire | `200` avec `id` (`em_…`), `status: "accepted"` et, pour plusieurs destinataires, `ids` avec un ID par destinataire |

Les ID d’Emailit sont des chaînes : vous n’avez donc plus à gérer les grands entiers des valeurs `MessageID` de Mailjet. Emailit prend aussi en charge la programmation avec `scheduled_at` et les relances sûres avec un en-tête `Idempotency-Key`. Consultez [Envoyer un e-mail](/fr/docs/email-api/send-email/).

## Changer les paramètres SMTP

| Paramètre | Mailjet | Emailit |
| --- | --- | --- |
| Hôte | `in-v3.mailjet.com` | `smtp.emailit.com` |
| Port | `587`, `588`, `2525`, `25` ou `80` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Nom d’utilisateur | Votre clé API publique | `emailit` |
| Mot de passe | Votre clé API secrète | Votre clé API Emailit |

Emailit ne lit pas les en-têtes de Mailjet, comme `X-Mailjet-Campaign`, `X-MJ-CustomID`, `X-MJ-EventPayload`, `X-Mailjet-TrackOpen`, `X-Mailjet-TrackClick`, `X-MJ-TemplateID` ou `X-MJ-Vars`. Supprimez-les. Réglez le suivi au niveau du domaine, et utilisez l’API quand vous avez besoin de modèles ou de métadonnées. Consultez [Paramètres SMTP](/fr/docs/smtp/settings/).

## Faire correspondre les événements webhook

| Événement Mailjet | Événement Emailit |
| --- | --- |
| `sent` | `email.delivered` |
| `bounce` | `email.bounced`. Emailit envoie aussi `email.attempted` pour chaque tentative échouée qu’il réessaie. |
| `blocked` | `email.suppressed` quand l’adresse a un blocage de type `recipient` |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsub` | `email.unsubscribed`, pour les e-mails de campagne uniquement |
| Route de la Parse API | `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 :

- Mailjet demande une URL par type d’événement et envoie un événement par requête, sauf si vous regroupez les événements. Un webhook Emailit peut s’abonner à de nombreux types d’événements et envoie un tableau JSON de 100 événements au maximum : parcourez donc le corps avec une boucle.
- Le nom de l’événement passe de `event` à `type`, et l’e-mail se trouve dans `data.object`. Utilisez `data.object.id`, l’ID `em_` de la réponse d’envoi, au lieu de `MessageID` ou `Message_GUID`, et `data.object.to` au lieu de `email`. Vos valeurs `meta`, qui remplacent `CustomID` et `Payload`, 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`.
- Mailjet ne signe pas ses requêtes. Emailit les signe toutes : vérifiez `X-Emailit-Signature` à l’aide de `X-Emailit-Timestamp` et de votre secret `whsec_`, et retirez si vous le souhaitez les identifiants d’authentification basique de votre URL. 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

Mailjet n’a pas de liste unique d’adresses bloquées, alors rassemblez les adresses à plusieurs endroits :

1. Rassemblez les adresses que Mailjet bloque :

   | Mailjet | Comment les exporter | Type Emailit |
   | --- | --- | --- |
   | Liste d’exclusion | Le téléchargement de la liste d’exclusion dans le tableau de bord, ou `GET /v3/REST/contact?IsExcludedFromCampaigns=true` | `unsubscribe`, qui arrête les campagnes mais laisse passer les e-mails transactionnels, comme la liste d’exclusion de Mailjet |
   | Contacts ayant porté plainte pour spam | Les contacts dont `IsSpamComplaining` est défini, via `GET /v3/REST/contact` | `recipient` |
   | Rebonds définitifs | Les événements `bounce` enregistrés par vos webhooks, ou vos rapports de campagne | `recipient` |

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

```csv
email,type,reason
excluded@example.com,unsubscribe,mailjet exclusion list
angry@example.com,recipient,mailjet spam complaint
```

   Le type `recipient` bloque les envois par l’API, par SMTP et par les campagnes.

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.

Si vous utilisiez plusieurs clés API Mailjet, répétez l’opération pour chacune. Consultez [Gérer les adresses bloquées](/fr/docs/suppressions/manage/).

## Transférer les contacts

Exportez chaque liste de contacts depuis **Contacts** dans Mailjet, ou avec `GET /v3/REST/listrecipient?ContactsList={id}`, qui inclut l’indicateur `IsUnsubscribed` de chaque membre. Les propriétés de contact s’obtiennent avec `GET /v3/REST/contactdata`.

1. **Préparez Emailit.** Créez un [champ personnalisé](/fr/docs/contacts/custom-fields/) pour chaque propriété de contact que vous utilisez, et une [liste de contacts](/fr/docs/audiences/) pour chaque liste.

2. **Importez les membres abonnés.** Dans **Email Marketing → Contacts**, sélectionnez **Import**, associez les colonnes et choisissez la liste de contacts correspondante. Découpez les fichiers en parties de 2 500 lignes au maximum. Consultez [Importer et exporter des contacts](/fr/docs/contacts/import-export/).

3. **Bloquez les autres.** L’import ajoute toutes les personnes du fichier comme abonnées : gardez donc les membres désinscrits hors du fichier. Ajoutez-les plutôt à votre fichier d’adresses bloquées avec le type `unsubscribe`, et laissez de côté les contacts dont l’inscription est encore en attente de confirmation. Un blocage `unsubscribe` arrête toutes les campagnes : n’en ajoutez donc pas pour les personnes encore abonnées à une autre liste que vous transférez.

Recréez vos campagnes et vos automatisations dans **Email Marketing → Campaigns** et **Automations**, à partir de vos modèles importés.

## Transférer les modèles

Récupérez le HTML de chaque modèle avec `GET /v3/REST/template/{id}/detailcontent`, qui renvoie `Html-part` et `Text-part`, ou copiez-le depuis l’éditeur de Mailjet. Importez-le 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`.

Convertissez le langage de modèles Mailjet en Temple :

| Mailjet | Emailit (Temple) |
| --- | --- |
| `{{var:name}}`, `{{var:order.total}}` | `{{name}}`, `{{order.total}}` |
| `{{var:name:"there"}}` | `{{name\|"there"}}` |
| `{{data:firstname}}` (une propriété de contact) | `{{first_name}}` ou `{{cf.<key>}}` dans les campagnes. Dans les envois par l’API, transmettez la valeur dans `variables`. |
| `{% if var:plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if var:plan == "pro" %}`, `{% elseif %}` | Non pris en charge. Transmettez un booléen comme `is_pro` et utilisez `{{#if is_pro}}`. |
| `{% for item in var:items %}…{% endfor %}` | Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. |
| Fonctions comme `Upper()` ou `FormatNumber()` | Non pris en charge. Mettez en forme la valeur dans votre code. |
| `{{mj:unsub_link}}` | `{{unsubscribe_url}}` dans les campagnes |
| `Variables` | `variables` |

Temple n’échappe 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 l’enregistrement DKIM `mailjet._domainkey` de Mailjet ni avec son enregistrement TXT de propriété. Conservez votre enregistrement DMARC. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/).

Si votre hôte de suivi personnalisé Mailjet est déjà `go`, choisissez un autre nom pour celui d’Emailit avec `tracking_key`. Consultez [Configurer un domaine de suivi personnalisé](/fr/docs/tracking/custom-tracking-domain/).

Après la bascule, supprimez les enregistrements DKIM, de propriété, de suivi et de return-path de Mailjet, et retirez `include:spf.mailjet.com` de votre enregistrement SPF. Si vous recevez des e-mails avec la Parse API sur votre propre domaine, déplacez-les d’abord vers un [sous-domaine de réception](/fr/docs/inbound/set-up/) Emailit.

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