# Migrar desde MailerSend

> Pasa de MailerSend a Emailit. Equivalencias de dominios, tokens y usuarios SMTP, conversión de las llamadas a la API y de la personalización, cambio de SMTP, y traslado de webhooks, direcciones bloqueadas y plantillas.

Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, las direcciones bloqueadas y las plantillas de MailerSend con sus equivalentes en Emailit. Lee primero [Migrar a Emailit](/es/docs/migrate/) para conocer el orden general y cómo usar los dos proveedores en paralelo.

## Conceptos

| MailerSend | Emailit |
| --- | --- |
| Cuenta | Cuenta y [espacios de trabajo](/es/docs/workspaces/). Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Dominios | [Dominios de envío](/es/docs/domains/) |
| Identidades de remitente | No disponible. Todas las direcciones del remitente deben pertenecer a un dominio verificado. |
| Tokens de API con permisos | [Claves de API](/es/docs/developers/api-keys/): **Full Access**, o **Sending Only** limitada opcionalmente a un dominio |
| Usuarios SMTP | Tu clave de API, usada como contraseña SMTP |
| Dominio de prueba y modo sandbox | No hay dominio de prueba compartido. Los espacios de trabajo nuevos están en [modo sandbox](/es/docs/workspaces/production-access/) y solo pueden enviar a los miembros del espacio de trabajo. |
| Plantillas | [Plantillas](/es/docs/templates/) con un alias y versiones, renderizadas con [Temple](/es/docs/templates/temple/) |
| Webhooks por dominio | [Webhooks](/es/docs/webhooks/) por espacio de trabajo |
| Rutas de entrada | [Emails entrantes](/es/docs/inbound/), con el webhook `email.received` o la [automatización](/es/docs/inbound/forward-with-automations/) **Forward received email** |
| Suppressions por dominio: rebotes duros, quejas por spam, bajas, blocklist | Una [lista de direcciones bloqueadas](/es/docs/suppressions/) por espacio de trabajo |
| Lista on hold | No es necesaria. Emailit reintenta los rebotes blandos y notifica cada intento como `email.attempted`. |
| Activity | **Email API → Emails** y **Email API → Logs** |
| Etiquetas | `meta` |
| Verificación de emails | [Verificación de emails](/es/docs/email-verification/) |
| IP dedicadas | [IP dedicadas](/es/docs/deliverability/dedicated-ips/) bajo solicitud |

## Actualizar las llamadas a la API

`POST /v1/email` de MailerSend pasa a ser `POST /v2/emails`. Los dos reciben un token bearer y JSON, pero en Emailit las direcciones son cadenas simples en lugar de objetos:

```bash title="Antes: MailerSend"
curl https://api.mailersend.com/v1/email \
  -H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<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>"
  }'
```

| MailerSend | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` | `Authorization: Bearer secret_…` |
| `from: { email, name }` | `from: "Name "` |
| `to[]`, `cc[]`, `bcc[]` con `email` y `name` | `to`, `cc`, `bcc` como cadena o como array de hasta 50 cada uno |
| `reply_to: { email, name }` | `reply_to` |
| `subject`, `text`, `html` | Igual |
| `headers: [{ "name": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `list_unsubscribe` | `headers` con `List-Unsubscribe` y `List-Unsubscribe-Post`. Consulta [Cabeceras y metadatos](/es/docs/email-api/headers-and-metadata/). |
| `attachments[]` con `content`, `filename`, `disposition` e `id` | `attachments[]` con `content`, `filename` y `content_type`, o una `url` en lugar de `content`. Usa `content_id` para las imágenes en línea. |
| `template_id` | `template`, un ID o alias de plantilla |
| `personalization: [{ "email": "…", "data": { … } }]` | `variables`, con una petición por destinatario cuando los valores son distintos |
| `tags` | `meta`, que se devuelve en los eventos de webhook |
| `send_at` (tiempo Unix o ISO 8601) | `scheduled_at` (ISO 8601 o lenguaje natural en inglés). Convierte antes los tiempos Unix a ISO 8601. |
| `settings.track_opens`, `settings.track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `POST /v1/bulk-email` | No disponible. Envía una petición por mensaje. |
| `202 Accepted` con una cabecera `x-message-id` y el cuerpo vacío | `200` con un cuerpo JSON: `id` (`em_…`), `status: "accepted"` y, con varios destinatarios, `ids` con un ID para cada uno |

Cada destinatario de una petición a Emailit se convierte en un email independiente con su propio ID. MailerSend responde `202` aunque todos los destinatarios estén bloqueados, con una advertencia en el cuerpo. Emailit también acepta los destinatarios con un bloqueo de tipo `recipient` y asigna a cada uno el estado `suppressed`. Añade una cabecera `Idempotency-Key` para que los reintentos sean seguros. Consulta [Enviar un email](/es/docs/email-api/send-email/).

## Cambiar la configuración SMTP

| Ajuste | MailerSend | Emailit |
| --- | --- | --- |
| Host | `smtp.mailersend.net` | `smtp.emailit.com` |
| Puerto | `587` (STARTTLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Usuario | El nombre de usuario generado para el usuario SMTP | `emailit` |
| Contraseña | La contraseña del usuario SMTP | Tu clave de API de Emailit |

Emailit no lee la cabecera `X-MailerSend-Tags`. Elimínala. A diferencia de MailerSend, Emailit entrega sin cambios el resto de tus cabeceras personalizadas. Consulta [Configuración SMTP](/es/docs/smtp/settings/).

## Equivalencias de los eventos de webhook

| Evento de MailerSend | Evento de Emailit |
| --- | --- |
| `activity.sent` | `email.accepted` (solo API) |
| `activity.delivered` | `email.delivered` |
| `activity.deferred` | `email.attempted` |
| `activity.soft_bounced` | `email.attempted` mientras Emailit reintenta, y después `email.bounced` si fallan todos los reintentos |
| `activity.hard_bounced` | `email.bounced` |
| `activity.suppressed` | `email.suppressed` |
| `activity.opened`, `activity.opened_unique` | `email.loaded`, que se envía con cada carga |
| `activity.clicked`, `activity.clicked_unique` | `email.clicked`, que se envía con cada clic |
| `activity.spam_complaint` | `email.complained` |
| `activity.unsubscribed` | `email.unsubscribed`, solo para los emails de campaña |
| Ruta de entrada que reenvía a un webhook | `email.received`; después, obtén el contenido con [`GET /emails/{id}`](/es/docs/api-reference/emails/get/) |

El formato de las peticiones cambia:

- MailerSend envía un evento por petición. Emailit envía un array JSON de hasta 100 eventos, así que recorre el cuerpo.
- En los dos, el nombre del evento está en `type`. En Emailit, el email está en `data.object`: usa `data.object.id`, el ID `em_` de la respuesta de envío, en lugar de `data.message_id` (`data.email.message.id` en los webhooks de la versión 1), y `data.object.to` en lugar de `data.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`.
- La cabecera `Signature` de MailerSend es un HMAC-SHA256 del cuerpo en bruto. La cabecera `X-Emailit-Signature` de Emailit es un HMAC-SHA256 de `<timestamp>.<raw body>` con tu secreto `whsec_` como clave, así que lee también `X-Emailit-Timestamp`. 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. En MailerSend, exporta las listas **Hard bounces**, **Spam complaints**, **Unsubscribes** y **Blocklist** de cada dominio, desde las páginas de suppressions o con la API (`/v1/suppressions/hard-bounces`, `/spam-complaints`, `/unsubscribes` y `/blocklist`). La lista on hold es temporal, así que puedes omitirla.

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

```csv
email,type,reason
old-address@example.com,recipient,mailersend hard bounce
angry@example.com,recipient,mailersend spam complaint
```

   Usa el tipo `recipient` para las direcciones que nunca deben recibir emails. Bloquea los envíos por API, por SMTP y de campañas. Para las personas que solo se dieron de baja del email de marketing, usa el tipo `unsubscribe`, que detiene las campañas pero sigue dejando pasar los emails transaccionales.

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 tiene una lista de direcciones bloqueadas por espacio de trabajo, así que las direcciones de todos tus dominios de MailerSend van a la misma lista. Los bloqueos son direcciones exactas: los patrones de la blocklist, como `.*@example.com`, no tienen equivalente. Consulta [Gestionar las direcciones bloqueadas](/es/docs/suppressions/manage/).

## Trasladar las plantillas

Copia el HTML de cada plantilla desde el editor de MailerSend y después impórtalo en **Email Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/). Asígnale un alias, como `receipt`, y envíala con `"template": "receipt"` y `variables`.

La personalización de MailerSend es una versión limitada de Twig. Temple cubre lo más habitual:

| MailerSend | Emailit (Temple) |
| --- | --- |
| `{{ name }}`, `{{ user.name }}` | `{{name}}`, `{{user.name}}` |
| `{{ name\|default('there') }}` | `{{name\|"there"}}` |
| `{% if plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if plan == "pro" %}`, `{% elseif %}` | No compatible. Pasa un booleano como `is_pro` y usa `{{#if is_pro}}`. |
| `{% for item in items %}…{% endfor %}` | No compatible. Genera la lista en tu código y pásala como una sola variable. |
| `{{ name\|upper }}` y otros filtros | No compatibles. Da formato al valor en tu código. |
| `personalization[].data` | `variables` |

MailerSend elimina la mayor parte del HTML de los valores de personalización. Temple nunca escapa ni elimina el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos. 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 los registros DKIM `ms1._domainkey` y `ms2._domainkey` de MailerSend, su CNAME de return-path `mta` ni su CNAME de seguimiento `email`. Conserva tu registro DMARC. Consulta [Registros DNS de los dominios de envío](/es/docs/domains/dns-records/).

El enrutamiento de entrada de MailerSend también usa por defecto un subdominio `inbound`. Si el tuyo lo usa, asigna otro subdominio a los emails entrantes de Emailit con `inbound_key`, o cambia el registro MX cuando traslades el correo entrante. Consulta [Configurar el email entrante](/es/docs/inbound/set-up/).

Después del cambio definitivo, elimina los registros DKIM, de return-path y de seguimiento de MailerSend, y quita `include:_spf.mailersend.net` de 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/mailersend/
