Aller au contenu
Docs

Guide

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.

Mis à jour le 23 oct. 2026

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 :

Before: Brevo
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>"
  }'
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>"
  }'
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 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 tags et X-Mailin-custom, 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.
  • 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 de X-Emailit-Timestamp et de votre secret whsec_. 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

Brevo tient deux listes de blocage. Transférez-les toutes les deux :

  1. 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 type recipient pour tous. Brevo bloque une adresse pour un expéditeur, alors qu’Emailit la bloque pour tout l’espace de travail.

  2. 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 type recipient pour les rebonds définitifs et les plaintes pour spam, et unsubscribe pour les désinscriptions. Le type unsubscribe arrê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.

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

    CSV
    email,type,reason
    old-address@example.com,recipient,brevo hard bounce
    left@example.com,unsubscribe,brevo unsubscribed
  4. 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

  1. Créez des champs personnalisés. Pour chaque attribut de contact Brevo que vous utilisez, en dehors de EMAIL, FIRSTNAME et LASTNAME, créez un champ personnalisé dans Emailit. Les clés sont en minuscules : COMPANY devient donc company.

  2. Créez des listes de contacts, une pour chaque liste Brevo à laquelle vous envoyez des campagnes.

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

  4. Importez-la. Dans Email MarketingContacts, sélectionnez Import, associez EMAIL, FIRSTNAME, LASTNAME et 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

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

Merci pour votre retour.

Merci, nous lisons chaque message.