Saltar al contenido
Docs

Guía

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.

Actualizado el 23 oct 2026

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:

Antes: ZeptoMail
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>"
  }'
Después: 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>"
  }'
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_name y una lista event_message, con el email en email_info y los detalles en event_data. Emailit envía un array JSON de hasta 100 eventos, cada uno con el nombre en type y el email en data.object.
  • Usa data.object.id, el ID em_ de la respuesta de envío, en lugar de email_reference o request_id. Cada email de Emailit tiene un solo destinatario, data.object.to, así que no necesitas bounced_recipient. Tus valores de meta están en data.object.meta.
  • Para email.loaded y email.clicked, data.object es la carga o el clic. Usa data.object.email_id para el ID del email, y data.object.email.rcpt_to y data.object.email.meta para el destinatario y tus valores de meta.
  • ZeptoMail firma con HMAC-SHA256 en una cabecera producer-signature que contiene ts y una s en base64. Emailit envía X-Emailit-Timestamp, en segundos, y X-Emailit-Signature, el HMAC-SHA256 en hexadecimal de <timestamp>.<raw body> con tu secreto whsec_ como clave. Consulta Verificar las firmas de los webhooks.
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);
}

Trasladar las direcciones bloqueadas

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

  2. Crea un único CSV con las columnas email,type,reason:

    CSV
    email,type,reason
    old-address@example.com,recipient,zeptomail hard bounce
    blocked@example.com,recipient,zeptomail suppression

    Usa el tipo recipient para las direcciones con la acción suppress o reject. Bloquea los envíos por API, por SMTP y de campañas. Las entradas con suppress_tracking no tienen equivalente, así que déjalas fuera.

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

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.