# 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](/fr/docs/migrate/) 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](/fr/docs/workspaces/). Chaque espace de travail a ses propres domaines, clés, membres et crédits. |
| Clés API | [Clés API](/fr/docs/developers/api-keys/) : **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](/fr/docs/domains/). 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](/fr/docs/workspaces/production-access/) et ne livrent qu’aux membres de l’espace de travail. |
| Modèles et langage de modèles Brevo | [Modèles](/fr/docs/templates/) avec un alias et des versions, dont le rendu est effectué avec [Temple](/fr/docs/templates/temple/) |
| Webhooks transactionnels, marketing et entrants | [Webhooks](/fr/docs/webhooks/) |
| Analyse des e-mails entrants (inbound parsing) | [E-mails entrants](/fr/docs/inbound/) |
| Contacts bloqués (transactionnels) et contacts en liste de blocage (campagnes) | [Adresses bloquées](/fr/docs/suppressions/) |
| Contacts, attributs et listes | [Contacts](/fr/docs/contacts/), [champs personnalisés](/fr/docs/contacts/custom-fields/) et [listes de contacts](/fr/docs/audiences/) |
| 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 e-mail | [Campagnes](/fr/docs/campaigns/) |
| Automatisations | [Automatisations](/fr/docs/automations/) (bêta) |
| Formulaires | [Formulaires](/fr/docs/forms/) (accès anticipé), ou l’[URL d’inscription](/fr/docs/audiences/subscribe-url/) d’une liste de contacts |
| `tags` et en-tête `X-Mailin-custom` | `meta` |
| IP dédiées | [IP dédiées](/fr/docs/deliverability/dedicated-ips/) 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 :

```bash title="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>"
  }'
```

```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>"
  }'
```

| Brevo | Emailit |
| --- | --- |
| En-tête `api-key: xkeysib-…` | `Authorization: Bearer secret_…` |
| `sender: { email, name }` ou `sender: { id }` | `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: { 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](/fr/docs/email-api/send-email/).

## 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](/fr/docs/smtp/settings/).

## 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}`](/fr/docs/api-reference/emails/get/) |

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](/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

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

Les domaines bloqués n’ont pas d’équivalent, car Emailit bloque des adresses exactes. Consultez [Gérer les adresses bloquées](/fr/docs/suppressions/manage/).

## 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é](/fr/docs/contacts/custom-fields/) 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 Marketing → Contacts**, 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](/fr/docs/contacts/import-export/).

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 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 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](/fr/docs/templates/temple/) et [Balises de fusion](/fr/docs/campaigns/merge-tags/).

## Recréer les campagnes et les automatisations

Créez vos campagnes dans **Email Marketing → Campaigns** à partir de vos modèles importés. Recréez chaque automatisation Brevo sous forme d’[automatisation](/fr/docs/automations/) 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](/fr/docs/forms/) (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 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 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](/fr/docs/domains/dns-records/).

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](/fr/docs/inbound/set-up/) Emailit.

## Étapes suivantes

- [Liste de contrôle avant la mise en production](/fr/docs/get-started/go-live/)
- [Créer une campagne](/fr/docs/campaigns/create/)
- [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/brevo/
