# 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](/es/docs/migrate/) 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](/es/docs/workspaces/), o un espacio de trabajo con varios dominios de envío |
| Send mail token de un Agent | [Clave de API](/es/docs/developers/api-keys/) **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](/es/docs/domains/) |
| Agents en sandbox | Los espacios de trabajo nuevos están en [modo sandbox](/es/docs/workspaces/production-access/) 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](/es/docs/templates/) por espacio de trabajo, con un alias y versiones |
| Webhooks por Agent | [Webhooks](/es/docs/webhooks/) por espacio de trabajo |
| Lista de suppressions con entradas de email y de dominio | [Lista de direcciones bloqueadas](/es/docs/suppressions/), con direcciones de email |
| Emails procesados y registros de emails | **Email API → Emails** y **Email API → Logs** |
| `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](/es/docs/campaigns/), [listas de contactos](/es/docs/audiences/) y [automatizaciones](/es/docs/automations/), 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:

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

```bash title="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 "` |
| `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](/es/docs/email-api/send-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](/es/docs/smtp/settings/).

## 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](/es/docs/webhooks/event-types/).

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](/es/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);
}
```

## 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 API → Suppressions**, 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](/es/docs/suppressions/manage/).

## 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 Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/), 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](/es/docs/templates/temple/) e [Importar, exportar y duplicar plantillas](/es/docs/templates/import-export/).

## Cambiar los DNS

Añade tu dominio en **Email API → Domains** 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](/es/docs/domains/dns-records/).

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](/es/docs/get-started/go-live/)
- [Configurar un webhook](/es/docs/webhooks/set-up/)
- [Migración prioritaria](/es/docs/programs/priority-migration/): deja que los ingenieros de Emailit hagan la migración contigo

---
Fuente: https://emailit.com/es/docs/migrate/zeptomail/
