Guía
Migrar desde ZeptoMail
Pasa de ZeptoMail (ahora Zoho CPaaS) a Emailit. Equivalencias de los Agents y los send mail tokens, conversión de las llamadas a la API y de las plantillas Mustache, cambio de SMTP y traslado de los webhooks y las direcciones bloqueadas.
Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, las direcciones bloqueadas y las plantillas de ZeptoMail con sus equivalentes en Emailit. En septiembre de 2026, ZeptoMail pasó a llamarse Zoho CPaaS. Los tokens, los hosts y la configuración SMTP existentes siguen funcionando, así que esta guía usa los nombres de ZeptoMail que encontrarás en tu código. Lee primero Migrar a Emailit para conocer el orden general y cómo usar los dos proveedores en paralelo.
Conceptos
| ZeptoMail (Zoho CPaaS) | Emailit |
|---|---|
| Cuenta | Cuenta |
| Agents (antes, Mail Agents) | Espacios de trabajo, o un espacio de trabajo con varios dominios de envío |
| Send mail token de un Agent | Clave de API Sending Only, limitada opcionalmente a un dominio |
| Tokens OAuth de Zoho para las API de gestión | Clave de API con Full Access. El mismo tipo de clave envía emails y gestiona tu espacio de trabajo. |
| Dominios asociados a los Agents | Dominios de envío |
| Agents en sandbox | Los espacios de trabajo nuevos están en modo sandbox y solo entregan a los miembros del espacio de trabajo. No hay ningún modo que acepte emails sin entregarlos. |
| Plantillas por Agent, con una clave y un alias | Plantillas por espacio de trabajo, con un alias y versiones |
| Webhooks por Agent | Webhooks por espacio de trabajo |
| Lista de suppressions con entradas de email y de dominio | Lista de direcciones bloqueadas, con direcciones de email |
| Emails procesados y registros de emails | Email APIEmails y Email APILogs |
client_reference |
meta |
| File cache | Adjuntos por url |
ZeptoMail solo envía emails transaccionales. En Emailit, el mismo espacio de trabajo también tiene campañas, listas de contactos y automatizaciones, si quieres trasladar también tus newsletters.
Actualizar las llamadas a la API
POST /v1.1/email de ZeptoMail pasa a ser POST /v2/emails. El esquema de autorización cambia, y las direcciones pasan a ser cadenas simples:
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_… |
Hosts regionales como api.zeptomail.eu o cpaas.zoho.eu |
Un solo host, api.emailit.com |
from: { address, name } |
from: "Name <email>" |
to[], cc[], bcc[] con email_address: { address, name } |
to, cc, bcc como cadena o como array de hasta 50 cada uno |
reply_to: [{ address, name }] |
reply_to |
subject |
subject |
htmlbody, textbody |
html, text |
mime_headers |
headers |
attachments[] con content, mime_type, name |
attachments[] con content, content_type, filename |
attachments[] con file_cache_key |
attachments[] con una url que Emailit descarga, o el content en base64 |
inline_images[] con cid |
attachments[] con un content_id, al que se hace referencia como cid: en el HTML |
client_reference |
meta, por ejemplo meta: { "reference": "order-12345" }, que se devuelve en los eventos de webhook |
track_opens, track_clicks |
tracking: { "loads": true, "clicks": true } |
POST /v1.1/email/template con template_key o template_alias y merge_info |
El mismo POST /v2/emails con template (un alias o ID) y variables |
POST /v1.1/email/batch y /email/template/batch |
No disponible. Envía una petición por destinatario con sus propias variables. |
Respuesta con request_id, y un email_reference por email en los webhooks y los registros |
200 con id (em_…), status: "accepted" y, con varios destinatarios, ids con un ID para cada uno |
Emailit también admite la programación con scheduled_at y los reintentos seguros con una cabecera Idempotency-Key, que ZeptoMail no ofrece al enviar. Consulta Enviar un email.
Cambiar la configuración SMTP
| Ajuste | ZeptoMail | Emailit |
|---|---|---|
| Host | smtp.zeptomail.com o un host regional |
smtp.emailit.com |
| Puerto | 587 (STARTTLS), 465 (TLS) |
587, 2587, 2525 o 25 (STARTTLS), 465 (TLS) |
| Usuario | emailapikey |
emailit |
| Contraseña | El send mail token del Agent, sin Zoho-enczapikey |
Tu clave de API de Emailit |
Emailit no lee las cabeceras X-TM-*, como X-TM-CLIENT-REF, X-TM-OPEN-TRACK, X-TM-CLICK-TRACK o X-TM-FILE-KEY. Elimínalas. Configura el seguimiento en el dominio y usa la API cuando necesites metadatos. Consulta Configuración SMTP.
Equivalencias de los eventos de webhook
| Evento de ZeptoMail | Evento de Emailit |
|---|---|
| Delivered | email.delivered |
Soft bounce (softbounce) |
email.attempted mientras Emailit reintenta, y después email.bounced si fallan todos los reintentos |
Hard bounce (hardbounce) |
email.bounced |
Open (email_open), solo la primera apertura |
email.loaded, que se envía en cada carga |
Click (email_link_click) |
email.clicked, que se envía en cada clic |
Feedback loop (fbl_complaint) |
email.complained |
Emailit también envía eventos para los que ZeptoMail no tiene webhook, como email.accepted cuando la API acepta un email y email.suppressed cuando un bloqueo de tipo recipient impide el envío a una dirección. Consulta Tipos de eventos.
El formato de las peticiones cambia:
- ZeptoMail envía por POST
event_namey una listaevent_message, con el email enemail_infoy los detalles enevent_data. Emailit envía un array JSON de hasta 100 eventos, cada uno con el nombre entypey el email endata.object. - Usa
data.object.id, el IDem_de la respuesta de envío, en lugar deemail_referenceorequest_id. Cada email de Emailit tiene un solo destinatario,data.object.to, así que no necesitasbounced_recipient. Tus valores demetaestán endata.object.meta. - Para
email.loadedyemail.clicked,data.objectes la carga o el clic. Usadata.object.email_idpara el ID del email, ydata.object.email.rcpt_toydata.object.email.metapara el destinatario y tus valores demeta. - ZeptoMail firma con HMAC-SHA256 en una cabecera
producer-signatureque contienetsy unasen base64. Emailit envíaX-Emailit-Timestamp, en segundos, yX-Emailit-Signature, el HMAC-SHA256 en hexadecimal de<timestamp>.<raw body>con tu secretowhsec_como clave. Consulta Verificar las firmas de los webhooks.
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);
}Trasladar las direcciones bloqueadas
-
Exporta tu lista de suppressions. La exportación desde el panel cubre los últimos 60 días, con hasta 5000 entradas por archivo, así que usa la API de suppressions (
GET /v1.1/suppressions/email) para las entradas más antiguas. -
Crea un único CSV con las columnas
email,type,reason:email,type,reason old-address@example.com,recipient,zeptomail hard bounce blocked@example.com,recipient,zeptomail suppressionUsa el tipo
recipientpara las direcciones con la acciónsuppressoreject. Bloquea los envíos por API, por SMTP y de campañas. Las entradas consuppress_trackingno tienen equivalente, así que déjalas fuera. -
En Email APISuppressions, selecciona Import y sube el archivo. Cada archivo puede tener hasta 10.000 filas y ocupar como máximo 8 MB. Los duplicados se omiten.
Emailit bloquea direcciones exactas, así que las entradas de dominio, como example.com, no se pueden importar. Consulta Gestionar las direcciones bloqueadas.
Trasladar las plantillas
Copia el HTML de cada plantilla desde el editor de ZeptoMail, u obtenlo con su API de plantillas, que lo devuelve en htmlbody. Impórtalo en Email MarketingTemplates o crea la plantilla con la API de plantillas, y usa el alias de la plantilla de ZeptoMail como alias en Emailit si se ajusta al formato de los alias: letras minúsculas, números, - y _.
Las plantillas de ZeptoMail usan Mustache. Temple cubre lo más habitual:
| ZeptoMail (Mustache) | Emailit (Temple) |
|---|---|
{{name}}, {{order.total}} |
Igual |
{{{html_block}}} |
{{html_block}}. Temple nunca escapa el HTML, así que escapa tú los datos que introducen los usuarios. |
{{#plan}}…{{/plan}} |
{{#if plan}}…{{/if}} |
{{^plan}}…{{/plan}} |
{{#if plan}}{{else}}…{{/if}} |
{{#items}}…{{/items}} sobre una lista |
No compatible. Genera la lista en tu código y pásala como una sola variable. |
| Sin valor por defecto integrado | {{name|"there"}} añade un valor alternativo |
merge_info |
variables |
Consulta Lenguaje de plantillas Temple e Importar, exportar y duplicar plantillas.
Cambiar los DNS
Añade tu dominio en Email APIDomains y publica los registros de Emailit. Usan sus propios nombres (emailit._domainkey, emailit.<domain> y, opcionalmente, go e inbound), así que no entran en conflicto con el registro DKIM de ZeptoMail ni con sus CNAME de rebote y de seguimiento. Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.
Después del cambio definitivo, elimina los registros DKIM, de rebote y de seguimiento de ZeptoMail, y también include:zeptomail.net si lo añadiste a tu registro SPF.
Próximos pasos
- Lista de comprobación para pasar a producción
- Configurar un webhook
- Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo