Aller au contenu
Docs

Guide

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.

Mis à jour le 23 oct. 2026

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 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. 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 : Full Access, ou Sending Only, éventuellement restreinte à un domaine
Expéditeurs : adresses individuelles et domaines entiers Domaines d’envoi. 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 et ne livrent qu’aux membres de l’espace de travail.
Modèles et langage de modèles Mailjet Modèles avec un alias et des versions, dont le rendu est effectué avec Temple
Event API, une URL par type d’événement Webhooks : un seul endpoint peut recevoir tous les types d’événements
Parse API E-mails entrants
Liste d’exclusion, contacts ayant porté plainte pour spam et adresses bloquées Adresses bloquées
Contacts, listes de contacts et propriétés de contact Contacts, listes de contacts et champs personnalisés
Segments Choisissez et excluez des listes de contacts dans chaque campagne. Les segments sont en alpha et réservés à l’équipe Emailit.
Campagnes et automatisations Campagnes et automatisations (bêta)
CustomID, EventPayload, CustomCampaign meta
Statistiques et historique des messages Email APIEmails, Email APILogs et rapports de campagne

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 :

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>"
    }]
  }'
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 <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
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.

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.

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}

Emailit envoie aussi email.accepted quand l’API accepte un e-mail. Consultez Types d’événements.

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

Si vous utilisiez plusieurs clés API Mailjet, répétez l’opération pour chacune. Consultez Gérer les adresses bloquées.

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é pour chaque propriété de contact que vous utilisez, et une liste de contacts pour chaque liste.

  2. Importez les membres abonnés. Dans Email MarketingContacts, 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.

  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 MarketingCampaigns 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 MarketingTemplates ou créez-le avec l’API des modèles, 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 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 l’enregistrement DKIM mailjet._domainkey de Mailjet ni avec son enregistrement TXT de propriété. Conservez votre enregistrement DMARC. Consultez Enregistrements DNS.

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

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

Étapes suivantes

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

Merci pour votre retour.

Merci, nous lisons chaque message.