Guide
Migrer depuis Brevo
Passez de Brevo (anciennement Sendinblue) à Emailit. Convertissez les appels à l’API smtp/email et le langage de modèles, remplacez les clés SMTP, et transférez webhooks, listes de blocage, contacts, campagnes et automatisations.
Ce guide fait correspondre les concepts, les appels API, les webhooks, les listes de blocage, les modèles, les contacts et les automatisations de Brevo à leurs équivalents dans Emailit. Brevo s’appelait Sendinblue jusqu’en 2023, et certains de ses hôtes et en-têtes portent encore ce nom. 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
| Brevo | Emailit |
|---|---|
| Compte et sous-comptes | Compte et espaces de travail. Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Clés API | Clés API : Full Access, ou Sending Only, éventuellement restreinte à un domaine |
| Identifiant SMTP et clés SMTP | Votre clé API, utilisée comme mot de passe SMTP |
| Expéditeurs, vérifiés un par un ou via un domaine authentifié | Domaines d’envoi. Les adresses d’expéditeur individuelles ne sont pas disponibles. |
En-tête X-Sib-Sandbox |
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 Brevo | Modèles avec un alias et des versions, dont le rendu est effectué avec Temple |
| Webhooks transactionnels, marketing et entrants | Webhooks |
| Analyse des e-mails entrants (inbound parsing) | E-mails entrants |
| Contacts bloqués (transactionnels) et contacts en liste de blocage (campagnes) | Adresses bloquées |
| Contacts, attributs et listes | Contacts, champs personnalisés et listes de contacts |
| Segments | Choisissez et excluez des listes de contacts dans chaque campagne. Les segments sont en alpha et réservés à l’équipe Emailit. |
| Campagnes e-mail | Campagnes |
| Automatisations | Automatisations (bêta) |
| Formulaires | Formulaires (accès anticipé), ou l’URL d’inscription d’une liste de contacts |
tags et en-tête X-Mailin-custom |
meta |
| IP dédiées | IP dédiées sur demande |
Mettre à jour vos appels API
Le POST /v3/smtp/email de Brevo devient POST /v2/emails. La clé passe de l’en-tête api-key à Authorization, et les noms de champs raccourcissent :
curl https://api.brevo.com/v3/smtp/email \
-H "api-key: $BREVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender": { "email": "hello@acme.com", "name": "Acme" },
"to": [{ "email": "ada@example.com" }],
"subject": "Your receipt",
"textContent": "Thanks for your order.",
"htmlContent": "<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>"
}'| Brevo | Emailit |
|---|---|
En-tête api-key: xkeysib-… |
Authorization: Bearer secret_… |
sender: { email, name } ou sender: { id } |
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: { email, name } |
reply_to |
subject, htmlContent, textContent |
subject, html, text |
headers |
headers |
attachment[] avec content et name, ou url |
attachments[] avec content, filename et content_type, ou url |
templateId et params |
template (un alias ou un ID) et variables |
tags, headers["X-Mailin-custom"] |
meta, renvoyé dans les événements webhook |
scheduledAt (72 heures à l’avance au maximum) |
scheduled_at (ISO 8601 ou anglais courant) |
headers.idempotencyKey (conservé 30 minutes) |
Un en-tête HTTP Idempotency-Key, conservé 24 heures |
messageVersions[] |
Non disponible. Envoyez une requête par destinataire, chacune avec ses propres variables. |
headers["X-Sib-Sandbox"] |
Non disponible |
201 avec messageId |
200 avec id (em_…), status: "accepted" et, pour plusieurs destinataires, ids avec un ID par destinataire |
Brevo n’a pas de réglage du suivi par e-mail. Dans Emailit, tracking: { "loads": true, "clicks": true } remplace le réglage de suivi du domaine pour un e-mail. Consultez Envoyer un e-mail.
Changer les paramètres SMTP
| Paramètre | Brevo | Emailit |
|---|---|---|
| Hôte | smtp-relay.brevo.com |
smtp.emailit.com |
| Port | 587 ou 2525 (STARTTLS), 465 (TLS) |
587, 2587, 2525 ou 25 (STARTTLS), 465 (TLS) |
| Nom d’utilisateur | Votre identifiant SMTP, comme …@smtp-brevo.com ou l’adresse e-mail de votre compte |
emailit |
| Mot de passe | Une clé SMTP | Votre clé API Emailit |
Emailit ne lit pas les en-têtes de Brevo, comme X-Mailin-custom ou X-Mailin-Tag. Supprimez-les et utilisez l’API quand vous avez besoin de métadonnées. Consultez Paramètres SMTP.
Faire correspondre les événements webhook
| Événement Brevo | Événement Emailit |
|---|---|
request (envoyé) |
email.accepted (API uniquement) |
delivered |
email.delivered |
deferred |
email.attempted |
soft_bounce |
email.attempted pendant qu’Emailit réessaie, puis email.bounced si toutes les nouvelles tentatives échouent |
hard_bounce |
email.bounced |
invalid_email |
Une erreur dans la réponse de l’API pour une adresse mal formée, ou email.bounced si l’adresse n’existe pas |
blocked |
email.suppressed |
error |
email.failed |
spam |
email.complained |
opened, unique_opened, proxy_open |
email.loaded, envoyé à chaque chargement |
click |
email.clicked |
unsubscribed, unsubscribe |
email.unsubscribed, pour les e-mails de campagne uniquement |
list_addition |
subscriber.created |
contact_updated, contact_deleted |
contact.updated, contact.deleted |
inboundEmailProcessed |
email.received, puis récupérez le contenu avec GET /emails/{id} |
Le format des requêtes change :
- Brevo envoie un événement par requête, ou des lots de 500 événements au maximum quand l’envoi par lots est activé. Emailit 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 demessage-id, etdata.object.toau lieu deemail. Vos valeursmeta, qui remplacenttagsetX-Mailin-custom, 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. - Brevo ne signe pas les webhooks ; vous les protégez avec des identifiants ou un jeton. Emailit signe chaque requête : vérifiez
X-Emailit-Signatureà l’aide deX-Emailit-Timestampet de votre secretwhsec_. 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
Brevo tient deux listes de blocage. Transférez-les toutes les deux :
-
Contacts bloqués transactionnels. Exportez-les depuis Settings > Transactional emails > Blocked or Unsubscribed contacts, ou parcourez les pages de
GET /v3/smtp/blockedContacts. Utilisez le typerecipientpour tous. Brevo bloque une adresse pour un expéditeur, alors qu’Emailit la bloque pour tout l’espace de travail. -
Contacts de campagne en liste de blocage. Dans CRM > Contacts, filtrez les abonnements aux campagnes e-mail sur Blocklisted et exportez, ou utilisez
POST /v3/contacts/export. Utilisez le typerecipientpour les rebonds définitifs et les plaintes pour spam, etunsubscribepour les désinscriptions. Le typeunsubscribearrête toutes les campagnes mais laisse passer les e-mails transactionnels : ne l’ajoutez donc pas pour les personnes qui ont seulement quitté une liste et sont encore abonnées à une autre. -
Constituez un seul CSV avec les colonnes
email,type,reason:email,type,reason old-address@example.com,recipient,brevo hard bounce left@example.com,unsubscribe,brevo unsubscribed -
Importez-le. 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.
Les domaines bloqués n’ont pas d’équivalent, car Emailit bloque des adresses exactes. Consultez Gérer les adresses bloquées.
Transférer les contacts
-
Créez des champs personnalisés. Pour chaque attribut de contact Brevo que vous utilisez, en dehors de
EMAIL,FIRSTNAMEetLASTNAME, créez un champ personnalisé dans Emailit. Les clés sont en minuscules :COMPANYdevient donccompany. -
Créez des listes de contacts, une pour chaque liste Brevo à laquelle vous envoyez des campagnes.
-
Exportez chaque liste depuis CRM > Contacts avec More actions > Export, en incluant les attributs et le statut d’abonnement. Laissez de côté les contacts en liste de blocage et les personnes qui se sont désinscrites de la liste.
-
Importez-la. Dans Email MarketingContacts, sélectionnez Import, associez
EMAIL,FIRSTNAME,LASTNAMEet vos attributs, 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.
L’import ajoute toutes les personnes du fichier comme abonnées : vérifiez donc que le fichier ne contient aucune personne désinscrite avant de l’importer.
Transférer les modèles
Récupérez le HTML de chaque modèle avec GET /v3/smtp/templates/{templateId} pour les modèles transactionnels, ou GET /v3/emailCampaigns/{campaignId} pour les campagnes. Les deux le renvoient dans htmlContent. 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 Brevo en Temple :
| Brevo | Emailit (Temple) |
|---|---|
{{ params.name }}, {{ params.order.total }} |
{{name}}, {{order.total}} |
{{ contact.FIRSTNAME }}, {{ contact.LASTNAME }} |
{{first_name}}, {{last_name}} dans les campagnes |
{{ contact.COMPANY }} |
{{cf.company}} dans les campagnes |
{{ params.name|default:"there" }} |
{{name|"there"}} |
{% if params.plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if params.plan == "pro" %}, {% elif %} |
Non pris en charge. Transmettez un booléen comme is_pro et utilisez {{#if is_pro}}. |
{% for item in params.items %}…{% endfor %} |
Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. |
Filtres comme upper ou date |
Non pris en charge. Mettez en forme la valeur dans votre code. |
{{ unsubscribe }} |
{{unsubscribe_url}} dans les campagnes |
{{ update_profile }} |
{{manage_subscriptions_url}} dans les campagnes |
{{ mirror }} |
{{webview_url}} dans les campagnes |
Brevo échappe le HTML, sauf si vous ajoutez safe. Temple n’échappe jamais le HTML : échappez les saisies des utilisateurs avant de les transmettre. Consultez Temple et Balises de fusion.
Recréer les campagnes et les automatisations
Créez vos campagnes dans Email MarketingCampaigns à partir de vos modèles importés. Recréez chaque automatisation Brevo sous forme d’automatisation Emailit dans le contexte Contact :
| Déclencheur Brevo | Déclencheur Emailit |
|---|---|
| Contact ajouté à une liste, retiré d’une liste | Added to audience, Removed from audience |
| Anniversaire, ou un attribut de date | Date anniversary, Date in contact field |
| Formulaire envoyé | Form submitted, pour les formulaires Emailit (accès anticipé) |
| E-mail ouvert, lien cliqué | Email opened, Link clicked |
| Désinscription d’une liste e-mail | Unsubscribed |
| Événement personnalisé | Custom event, sur les forfaits Business et Custom |
Démarrez chaque automatisation avant de déplacer vos formulaires d’inscription, pour que les nouveaux contacts reçoivent leurs e-mails dès le premier jour.
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 TXT brevo-code de Brevo ni avec ses enregistrements DKIM (brevo1._domainkey et brevo2._domainkey, ou mail._domainkey sur les configurations plus anciennes). Conservez votre enregistrement DMARC. Consultez Enregistrements DNS.
Après la bascule, supprimez les enregistrements Brevo de code, de DKIM et de sous-domaine à votre marque, ainsi que include:spf.brevo.com ou include:spf.sendinblue.com si votre enregistrement SPF en contient un. Si vous recevez des e-mails avec l’analyse des e-mails entrants de Brevo, déplacez-les d’abord vers un sous-domaine de réception Emailit.
Étapes suivantes
- Liste de contrôle avant la mise en production
- Créer une campagne
- Migration prioritaire : laissez les ingénieurs d’Emailit effectuer la migration avec vous