Guide
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 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 :
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>"
}]
}'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 dansdata.object. Utilisezdata.object.id, l’IDem_de la réponse d’envoi, au lieu deMessageIDouMessage_GUID, etdata.object.toau lieu deemail. Vos valeursmeta, qui remplacentCustomIDetPayload, se trouvent dansdata.object.meta. - Pour
email.loadedetemail.clicked,data.objectest le chargement ou le clic. Utilisezdata.object.email_idpour l’ID de l’e-mail, etdata.object.email.rcpt_toetdata.object.email.metapour le destinataire et vos valeursmeta. - Mailjet ne signe pas ses requêtes. Emailit les signe toutes : vérifiez
X-Emailit-Signatureà l’aide deX-Emailit-Timestampet de votre secretwhsec_, et retirez si vous le souhaitez les identifiants d’authentification basique de votre URL. Consultez Signature des requêtes.
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 :
-
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=trueunsubscribe, qui arrête les campagnes mais laisse passer les e-mails transactionnels, comme la liste d’exclusion de MailjetContacts ayant porté plainte pour spam Les contacts dont IsSpamComplainingest défini, viaGET /v3/REST/contactrecipientRebonds définitifs Les événements bounceenregistrés par vos webhooks, ou vos rapports de campagnerecipient -
Constituez un seul CSV avec les colonnes
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintLe type
recipientbloque les envois par l’API, par SMTP et par les campagnes. -
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.
-
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.
-
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.
-
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 blocageunsubscribearrê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
- Liste de contrôle avant la mise en production
- Configurer des webhooks
- Migration prioritaire : laissez les ingénieurs d’Emailit effectuer la migration avec vous