Guide
Migrer depuis ZeptoMail
Passez de ZeptoMail (désormais Zoho CPaaS) à Emailit. Faites correspondre les Agents et les send mail tokens, convertissez les appels API et les modèles Mustache, remplacez les paramètres SMTP, et transférez les webhooks et les adresses bloquées.
Ce guide fait correspondre les concepts, les appels API, les webhooks, les adresses bloquées et les modèles de ZeptoMail à leurs équivalents dans Emailit. En septembre 2026, ZeptoMail a été renommé Zoho CPaaS. Les jetons, les hôtes et les paramètres SMTP existants continuent de fonctionner : ce guide utilise donc les noms ZeptoMail que vous trouverez dans votre code. 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
| ZeptoMail (Zoho CPaaS) | Emailit |
|---|---|
| Compte | Compte |
| Agents (anciennement Mail Agents) | Espaces de travail, ou un seul espace de travail avec plusieurs domaines d’envoi |
| Send mail token d’un Agent | Clé API Sending Only, éventuellement restreinte à un domaine |
| Jetons OAuth Zoho pour les API de gestion | Clé API Full Access. Le même type de clé envoie les e-mails et gère votre espace de travail. |
| Domaines associés aux Agents | Domaines d’envoi |
| Agents sandbox | Les nouveaux espaces de travail sont en mode bac à sable et ne livrent qu’aux membres de l’espace de travail. Il n’existe pas de mode qui accepte les e-mails sans les livrer. |
| Modèles par Agent, avec une clé et un alias | Modèles par espace de travail, avec un alias et des versions |
| Webhooks par Agent | Webhooks par espace de travail |
| Suppression list, avec des entrées d’adresses e-mail et de domaines | Liste d’adresses bloquées composée d’adresses e-mail |
| E-mails traités et logs d’e-mails | Email APIEmails et Email APILogs |
client_reference |
meta |
| Cache de fichiers (File cache) | Pièces jointes par url |
ZeptoMail n’envoie que des e-mails transactionnels. Dans Emailit, le même espace de travail dispose aussi de campagnes, de listes de contacts et d’automatisations, si vous voulez aussi transférer vos newsletters.
Mettre à jour vos appels API
Le POST /v1.1/email de ZeptoMail devient POST /v2/emails. Le schéma d’autorisation change, et les adresses deviennent de simples chaînes :
curl https://api.zeptomail.com/v1.1/email \
-H "Authorization: Zoho-enczapikey $ZEPTOMAIL_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": { "address": "hello@acme.com", "name": "Acme" },
"to": [{ "email_address": { "address": "ada@example.com" } }],
"subject": "Your receipt",
"textbody": "Thanks for your order.",
"htmlbody": "<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>"
}'| ZeptoMail | Emailit |
|---|---|
Authorization: Zoho-enczapikey <token> |
Authorization: Bearer secret_… |
Hôtes régionaux comme api.zeptomail.eu ou cpaas.zoho.eu |
Un seul hôte, api.emailit.com |
from: { address, name } |
from: "Name <email>" |
to[], cc[], bcc[] avec email_address: { address, name } |
to, cc, bcc sous forme de chaîne ou de tableau, 50 adresses au maximum pour chacun |
reply_to: [{ address, name }] |
reply_to |
subject |
subject |
htmlbody, textbody |
html, text |
mime_headers |
headers |
attachments[] avec content, mime_type, name |
attachments[] avec content, content_type, filename |
attachments[] avec file_cache_key |
attachments[] avec une url qu’Emailit télécharge, ou le content en base64 |
inline_images[] avec cid |
attachments[] avec un content_id, référencé sous la forme cid: dans le HTML |
client_reference |
meta, par exemple meta: { "reference": "order-12345" }, renvoyé dans les événements webhook |
track_opens, track_clicks |
tracking: { "loads": true, "clicks": true } |
POST /v1.1/email/template avec template_key ou template_alias et merge_info |
Le même POST /v2/emails avec template (un alias ou un ID) et variables |
POST /v1.1/email/batch et /email/template/batch |
Non disponible. Envoyez une requête par destinataire avec ses propres variables. |
Réponse avec request_id, et un email_reference par e-mail dans les webhooks et les logs |
200 avec id (em_…), status: "accepted" et, pour plusieurs destinataires, ids avec un ID par destinataire |
Emailit prend aussi en charge la programmation avec scheduled_at et les relances sûres avec un en-tête Idempotency-Key, ce que ZeptoMail ne propose pas à l’envoi. Consultez Envoyer un e-mail.
Changer les paramètres SMTP
| Paramètre | ZeptoMail | Emailit |
|---|---|---|
| Hôte | smtp.zeptomail.com, ou un hôte régional |
smtp.emailit.com |
| Port | 587 (STARTTLS), 465 (TLS) |
587, 2587, 2525 ou 25 (STARTTLS), 465 (TLS) |
| Nom d’utilisateur | emailapikey |
emailit |
| Mot de passe | Le send mail token de l’Agent, sans Zoho-enczapikey |
Votre clé API Emailit |
Emailit ne lit pas les en-têtes X-TM-* comme X-TM-CLIENT-REF, X-TM-OPEN-TRACK, X-TM-CLICK-TRACK ou X-TM-FILE-KEY. Supprimez-les. Réglez le suivi au niveau du domaine, et utilisez l’API quand vous avez besoin de métadonnées. Consultez Paramètres SMTP.
Faire correspondre les événements webhook
| Événement ZeptoMail | Événement Emailit |
|---|---|
| Delivered | email.delivered |
Soft bounce (softbounce) |
email.attempted pendant qu’Emailit réessaie, puis email.bounced si toutes les nouvelles tentatives échouent |
Hard bounce (hardbounce) |
email.bounced |
Open (email_open), première ouverture uniquement |
email.loaded, envoyé à chaque chargement |
Click (email_link_click) |
email.clicked, envoyé à chaque clic |
Feedback loop (fbl_complaint) |
email.complained |
Emailit envoie aussi des événements pour lesquels ZeptoMail n’a pas de webhook, comme email.accepted quand l’API accepte un e-mail et email.suppressed quand un blocage recipient arrête l’envoi vers une adresse. Consultez Types d’événements.
Le format des requêtes change :
- ZeptoMail envoie (POST)
event_nameet une listeevent_message, avec l’e-mail dansemail_infoet les détails dansevent_data. Emailit envoie un tableau JSON de 100 événements au maximum, chacun avec le nom danstypeet l’e-mail dansdata.object. - Utilisez
data.object.id, l’IDem_de la réponse d’envoi, au lieu deemail_referenceourequest_id. Chaque e-mail Emailit a un seul destinataire,data.object.to: vous n’avez donc pas besoin debounced_recipient. Vos valeursmetase 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. - ZeptoMail signe avec HMAC-SHA256 dans un en-tête
producer-signaturequi contienttset unsen base64. Emailit envoieX-Emailit-Timestamp, en secondes, etX-Emailit-Signature, le HMAC-SHA256 en hexadécimal de<timestamp>.<raw body>, calculé avec 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
-
Exportez votre liste d’adresses bloquées. L’export depuis le tableau de bord couvre les 60 derniers jours, avec 5 000 entrées au maximum par fichier : utilisez donc l’API des adresses bloquées (
GET /v1.1/suppressions/email) pour les entrées plus anciennes. -
Constituez un seul CSV avec les colonnes
email,type,reason:email,type,reason old-address@example.com,recipient,zeptomail hard bounce blocked@example.com,recipient,zeptomail suppressionUtilisez le type
recipientpour les adresses avec l’actionsuppressoureject. Il bloque les envois par l’API, par SMTP et par les campagnes. Les entrées avecsuppress_trackingn’ont pas d’équivalent : laissez-les donc de côté. -
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.
Emailit bloque des adresses exactes : les entrées de domaine comme example.com ne peuvent donc pas être importées. Consultez Gérer les adresses bloquées.
Transférer les modèles
Copiez le HTML de chaque modèle depuis l’éditeur de ZeptoMail, ou récupérez-le avec l’API des modèles de ZeptoMail, qui le renvoie dans htmlbody. Importez-le dans Email MarketingTemplates ou créez-le avec l’API des modèles, et utilisez l’alias du modèle ZeptoMail comme alias Emailit s’il respecte le format des alias : lettres minuscules, chiffres, - et _.
Les modèles ZeptoMail utilisent Mustache. Temple couvre les usages courants :
| ZeptoMail (Mustache) | Emailit (Temple) |
|---|---|
{{name}}, {{order.total}} |
Identique |
{{{html_block}}} |
{{html_block}}. Temple n’échappe jamais le HTML : échappez vous-même les saisies des utilisateurs. |
{{#plan}}…{{/plan}} |
{{#if plan}}…{{/if}} |
{{^plan}}…{{/plan}} |
{{#if plan}}{{else}}…{{/if}} |
{{#items}}…{{/items}} sur une liste |
Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. |
| Pas de valeur par défaut intégrée | {{name|"there"}} ajoute une valeur de repli |
merge_info |
variables |
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 de ZeptoMail, son CNAME de rebond ni son CNAME de suivi. Conservez votre enregistrement DMARC. Consultez Enregistrements DNS.
Après la bascule, supprimez les enregistrements DKIM, de rebond et de suivi de ZeptoMail, ainsi que include:zeptomail.net si vous l’avez ajouté à votre enregistrement SPF.
É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