# Migrer depuis Elastic Email

> Passez d’Elastic Email à Emailit. Faites correspondre les appels aux API v4 et v2, les identifiants SMTP et les notifications, convertissez les champs de fusion, et transférez adresses bloquées, contacts et campagnes.

Ce guide fait correspondre les concepts, les appels API, les notifications, les adresses bloquées, les modèles et les contacts d’Elastic Email à leurs équivalents dans Emailit. 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

| Elastic Email | 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 avec niveaux d’accès | [Clés API](/fr/docs/developers/api-keys/) : **Full Access**, ou **Sending Only**, éventuellement restreinte à un domaine |
| Identifiants SMTP | Votre clé API, utilisée comme mot de passe SMTP |
| Domaines vérifiés et adresses d’expéditeur vérifiées | [Domaines d’envoi](/fr/docs/domains/). Les adresses d’expéditeur individuelles ne sont pas disponibles. |
| Canaux et valeurs de postback | `meta` |
| Modèles, désignés par leur nom | [Modèles](/fr/docs/templates/) avec un alias et des versions |
| Champs de fusion et scripts de modèle | [Temple](/fr/docs/templates/temple/) : variables, valeurs par défaut et conditions |
| Notifications web HTTP | [Webhooks](/fr/docs/webhooks/) |
| Routes entrantes (inbound routes) | [E-mails entrants](/fr/docs/inbound/) |
| Adresses bloquées et statuts de contact qui bloquent l’envoi | [Adresses bloquées](/fr/docs/suppressions/) |
| Contacts et listes | [Contacts](/fr/docs/contacts/) 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 et automatisations | [Campagnes](/fr/docs/campaigns/) et [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 |
| Vérification d’e-mails | [Vérification d’e-mails](/fr/docs/email-verification/) |
| IP privées et pools d’IP | [IP dédiées](/fr/docs/deliverability/dedicated-ips/) sur demande |

Elastic Email ajoute un lien de désinscription à chaque e-mail, y compris aux envois par l’API et par SMTP. Emailit n’ajoute les en-têtes `List-Unsubscribe` qu’aux [campagnes](/fr/docs/campaigns/) et aux e-mails marketing des automatisations, et vous ajoutez vous-même le lien visible avec `{{unsubscribe_url}}`. Si vous envoyez des newsletters ou d’autres e-mails en masse via l’API ou SMTP, ajoutez votre propre lien et vos propres en-têtes `List-Unsubscribe`. Consultez [En-têtes et métadonnées](/fr/docs/email-api/headers-and-metadata/#add-list-unsubscribe-to-bulk-mail).

## Mettre à jour vos appels API

Le `POST /v4/emails/transactional` d’Elastic Email devient `POST /v2/emails`. Le corps est plat, les noms de champs sont en minuscules, et la clé passe dans un en-tête `Authorization` :

```bash title="Before: Elastic Email"
curl https://api.elasticemail.com/v4/emails/transactional \
  -H "X-ElasticEmail-ApiKey: $ELASTICEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Recipients": { "To": ["ada@example.com"] },
    "Content": {
      "From": "Acme <hello@acme.com>",
      "Subject": "Your receipt",
      "Body": [
        { "ContentType": "HTML", "Content": "<p>Thanks for your order.</p>" },
        { "ContentType": "PlainText", "Content": "Thanks for your order." }
      ]
    }
  }'
```

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

| Elastic Email (API v4) | Emailit |
| --- | --- |
| En-tête `X-ElasticEmail-ApiKey` | `Authorization: Bearer secret_…` |
| `Content.From` | `from` |
| `Recipients.To`, `CC`, `BCC` | `to`, `cc`, `bcc`, 50 adresses au maximum pour chacun |
| `Content.ReplyTo` | `reply_to` |
| `Content.Subject` | `subject` |
| `Content.Body[]` avec `ContentType` `HTML` et `PlainText` | `html` et `text` |
| `Content.Headers` | `headers` |
| `Content.Attachments[]` avec `BinaryContent`, `Name`, `ContentType` | `attachments[]` avec `content`, `filename`, `content_type` |
| `Content.AttachFiles` (fichiers chargés au préalable) | `attachments[]` avec une `url` qu’Emailit télécharge |
| `Content.TemplateName` | `template`, un alias ou un ID de modèle |
| `Content.Merge` | `variables` |
| `Options.ChannelName`, `Content.Postback` | `meta`, renvoyé dans les événements webhook |
| `Options.TrackOpens`, `Options.TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `Options.TimeOffset` (en minutes) | `scheduled_at` (ISO 8601 ou anglais courant) |
| `Options.PoolName` | Inutile. Une IP dédiée envoie tous les e-mails de son espace de travail. |
| `Content.Utm` | Ajoutez des paramètres UTM à vos liens. Les campagnes les ajoutent pour vous. |
| `POST /v4/emails` avec `Recipients[].Fields` (fusion en masse) | Une requête par destinataire, chacune avec ses propres `variables` |
| En-tête `Idempotency-Key` | En-tête `Idempotency-Key`, conservé 24 heures |
| Réponse avec `TransactionID` et `MessageID` | `200` avec `id` (`em_…`), `status: "accepted"` et, pour plusieurs destinataires, `ids` avec un ID par destinataire |

Si vous utilisez encore l’API v2 (`/v2/email/send` avec un paramètre `apikey`), faites correspondre ses champs de formulaire de la même façon : `from` et `fromName` deviennent `from`, `bodyHtml` et `bodyText` deviennent `html` et `text`, les champs `merge_*` deviennent `variables`, et `template` devient `template`. En v2, chaque adresse de `to` reçoit un message distinct, comme en copie cachée (Cci). Dans Emailit, les destinataires de `to` se voient les uns les autres dans l’en-tête `To` : envoyez donc une requête par destinataire pour les garder séparés. Consultez [Envoyer un e-mail](/fr/docs/email-api/send-email/).

## Changer les paramètres SMTP

| Paramètre | Elastic Email | Emailit |
| --- | --- | --- |
| Hôte | `smtp.elasticemail.com` | `smtp.emailit.com` |
| Port | `2525`, `587` ou `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Nom d’utilisateur | Le nom de l’identifiant SMTP, une adresse e-mail | `emailit` |
| Mot de passe | Le jeton de l’identifiant SMTP | Votre clé API Emailit |

Emailit ne lit pas les en-têtes de contrôle d’Elastic Email, comme `X-ElasticEmail-Channel`, `X-ElasticEmail-Postback`, `IsTransactional`, `trackopens` ou `trackclicks`. Supprimez-les et réglez plutôt le suivi au niveau du domaine. Consultez [Paramètres SMTP](/fr/docs/smtp/settings/).

## Faire correspondre les événements webhook

| Notification Elastic Email | Événement Emailit |
| --- | --- |
| `Sent` (le serveur du destinataire a accepté le message) | `email.delivered` |
| `Opened` | `email.loaded` |
| `Clicked` | `email.clicked` |
| `Error` | `email.bounced` pour les échecs définitifs. Les échecs temporaires envoient `email.attempted` pendant qu’Emailit réessaie. |
| `AbuseReport` | `email.complained` |
| `Unsubscribed` | `email.unsubscribed`, pour les e-mails de campagne uniquement |
| Route entrante qui notifie une URL | `email.received`, puis récupérez le contenu avec [`GET /emails/{id}`](/fr/docs/api-reference/emails/get/) |

Emailit envoie aussi `email.accepted` quand l’API accepte un e-mail, et `email.suppressed` quand un blocage de type `recipient` bloque une adresse. Consultez [Types d’événements](/fr/docs/webhooks/event-types/).

Le format des requêtes change :

- Elastic Email envoie un événement par requête, dans la chaîne de requête ou sous forme d’objet JSON plat. 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 `status` à `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`, et `data.object.to` au lieu de `to`. Vos valeurs `meta`, qui remplacent `channel` et `postback`, 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`.
- Emailit signe chaque requête. Vérifiez `X-Emailit-Signature`, le HMAC-SHA256 en hexadécimal de `<timestamp>.<raw body>`, à l’aide de `X-Emailit-Timestamp` et de votre secret `whsec_`. La signature facultative d’Elastic Email utilise aussi des secrets `whsec_`, mais elle signe une chaîne différente : mettez donc à jour votre code de vérification. 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

1. Exportez les adresses qu’Elastic Email bloque, depuis **Suppressions** dans le tableau de bord ou avec l’API (`/v4/suppressions/bounces`, `/complaints` et `/unsubscribes`).

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

   | Statut Elastic Email | Type Emailit |
   | --- | --- |
   | Invalid (`Bounced`) | `recipient` |
   | Complaint (`Abuse`) | `recipient` |
   | Unsubscribed | `unsubscribe`, qui arrête les campagnes mais laisse passer les e-mails transactionnels. Utilisez `recipient` pour bloquer tous les e-mails. |

```csv
email,type,reason
old-address@example.com,recipient,elastic email bounced
left@example.com,unsubscribe,elastic email unsubscribed
```

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

Consultez [Gérer les adresses bloquées](/fr/docs/suppressions/manage/).

## Transférer les contacts et les campagnes

Exportez vos contacts depuis **Contacts** (sélectionnez-les, puis **More actions > Export**) ou avec `POST /v4/contacts/export`, et exportez chaque liste à laquelle vous envoyez des campagnes. Transférez-les ensuite selon leur statut :

| Statut Elastic Email | Destination |
| --- | --- |
| Engaged, Active | Importez-les dans la liste de contacts correspondante dans **Email Marketing → Contacts** avec **Import**. |
| Transactional | Laissez-les en dehors des listes de contacts. Ils ne se sont jamais abonnés à vos e-mails marketing. |
| Invalid, Complaint, Unsubscribed | La liste d’adresses bloquées, comme ci-dessus. |
| Inactive, Stale, Not Confirmed | Laissez-les de côté. |

Créez des [champs personnalisés](/fr/docs/contacts/custom-fields/) pour vos champs de contact avant l’import, et découpez les fichiers en parties de 2 500 lignes au maximum. L’import ajoute toutes les personnes du fichier comme abonnées : n’importez donc que les personnes qui doivent recevoir vos campagnes. Consultez [Importer et exporter des contacts](/fr/docs/contacts/import-export/).

Recréez vos campagnes et vos automatisations dans **Email Marketing → Campaigns** et **Automations**, à partir de vos modèles importés.

## Transférer les modèles

Copiez le HTML de chaque modèle avec **Edit as HTML** dans Elastic Email, ou récupérez-le avec `GET /v4/templates/{name}`, qui le renvoie dans `Body`. Importez-le dans **Email Marketing → Templates** ou créez-le avec l’[API des modèles](/fr/docs/api-reference/templates/create/), et utilisez le nom du modèle comme alias s’il respecte le format des alias : lettres minuscules, chiffres, `-` et `_`.

Les champs de fusion d’Elastic Email utilisent des accolades simples, et Temple des doubles accolades. Les champs à accolades simples laissés dans un modèle sont envoyés en texte brut, alors convertissez-les tous :

| Elastic Email | Emailit (Temple) |
| --- | --- |
| `{firstname}`, `{lastname}`, `{email}` | `{{first_name}}`, `{{last_name}}`, `{{email}}` dans les campagnes. Dans les envois par l’API, les noms que vous transmettez dans `variables`. |
| `{firstname:friend}` | `{{first_name\|"friend"}}` |
| `{company}` ou un autre champ personnalisé | `{{cf.company}}` dans les campagnes |
| `{unsubscribe}` | `{{unsubscribe_url}}` dans les campagnes |
| `{contactprofile}` | `{{manage_subscriptions_url}}` dans les campagnes |
| `{view}` | `{{webview_url}}` dans les campagnes |
| `{accountaddress}` et les autres champs du compte | Écrivez-les directement dans le modèle, ou conservez-les dans des [valeurs globales](/fr/docs/contacts/global-values/) |
| Scripts de modèle dans `{{ … }}` | Non pris en charge. Calculez les valeurs dans votre code et utilisez `{{#if}}` pour le contenu conditionnel. |

Consultez [Balises de fusion](/fr/docs/campaigns/merge-tags/) et [Temple](/fr/docs/templates/temple/).

## 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 DKIM `api._domainkey` d’Elastic Email, ni avec son CNAME `tracking` ou un domaine de rebond personnalisé. Conservez votre enregistrement DMARC. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/).

Après la bascule, supprimez les enregistrements DKIM et de suivi d’Elastic Email, et retirez `include:_spf.elasticemail.com` de votre enregistrement SPF. Si vous recevez des e-mails avec les routes entrantes d’Elastic Email, déplacez-les d’abord vers un [sous-domaine de réception](/fr/docs/inbound/set-up/) Emailit. Emailit reçoit sur un sous-domaine, comme `inbound.acme.com` : les adresses de réception changent donc.

## Étapes suivantes

- [Liste de contrôle avant la mise en production](/fr/docs/get-started/go-live/)
- [Configurer des webhooks](/fr/docs/webhooks/set-up/)
- [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/elastic-email/
