# Migrar desde Mandrill

> Pasa de Mandrill (Mailchimp Transactional) a Emailit. Equivalencias de claves de API y subcuentas, conversión de las llamadas a messages/send, cambio de SMTP y de las cabeceras X-MC, verificación de los webhooks y traslado de los rechazos.

Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, la rejection denylist y las plantillas de Mandrill (Mailchimp Transactional Email) 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. Si también envías campañas desde Mailchimp, consulta [Migrar desde Mailchimp](/es/docs/migrate/mailchimp/).

## Conceptos

| Mandrill | Emailit |
| --- | --- |
| Un plan Standard o Premium de Mailchimp con bloques transaccionales | Una cuenta de Emailit. No necesitas un plan de marketing para enviar emails transaccionales. |
| Subcuentas | [Espacios de trabajo](/es/docs/workspaces/), cada uno con sus propios dominios, claves, límites y créditos |
| Claves de API | [Claves de API](/es/docs/developers/api-keys/): **Full Access**, o **Sending Only** limitada opcionalmente a un dominio |
| Claves de API de prueba | No hay modo de prueba. 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. |
| Dominios de envío y verificación DKIM/SPF | [Dominios de envío](/es/docs/domains/) |
| Dominios de seguimiento | [Subdominio de seguimiento](/es/docs/tracking/), como `go.acme.com` |
| Plantillas con regiones `mc:edit` | [Plantillas](/es/docs/templates/) con un alias y versiones, renderizadas con [Temple](/es/docs/templates/temple/) |
| Webhooks | [Webhooks](/es/docs/webhooks/) |
| Dominios de entrada y rutas | [Emails entrantes](/es/docs/inbound/) |
| Rejection denylist | [Direcciones bloqueadas](/es/docs/suppressions/) |
| Rejection allowlist | No disponible |
| Lenguajes de combinación: Mailchimp y Handlebars | [Temple](/es/docs/templates/temple/) |
| Etiquetas y metadatos | `meta` |
| Outbound activity | **Email API → Emails** y **Email API → Logs** |
| IP dedicadas y pools de IP | [IP dedicadas](/es/docs/deliverability/dedicated-ips/) bajo solicitud |

## Actualizar las llamadas a la API

`POST /messages/send` de Mandrill recibe la clave de API en el cuerpo JSON y anida el email en `message`. `POST /v2/emails` de Emailit recibe un token bearer y un cuerpo plano:

```bash title="Antes: Mandrill"
curl https://mandrillapp.com/api/1.0/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "key": "'"$MANDRILL_API_KEY"'",
    "message": {
      "from_email": "hello@acme.com",
      "from_name": "Acme",
      "to": [{ "email": "ada@example.com", "type": "to" }],
      "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>"
  }'
```

| Mandrill | Emailit |
| --- | --- |
| `key` en el cuerpo de la petición | Cabecera `Authorization: Bearer secret_…` |
| `message.from_email` y `from_name` | `from: "Name "` |
| `message.to[]` con `type` `to`, `cc` o `bcc` | `to`, `cc`, `bcc`, hasta 50 cada uno |
| `message.headers["Reply-To"]` | `reply_to` |
| `message.subject`, `html`, `text` | `subject`, `html`, `text` |
| `message.headers` | `headers` |
| `message.attachments[]` con `type`, `name`, `content` | `attachments[]` con `content_type`, `filename`, `content` |
| `message.images[]` para las imágenes en línea | `attachments[]` con un `content_id`, al que se hace referencia como `cid:` en el HTML |
| `message.metadata`, `message.tags` | `meta`, un objeto de valores de cadena que se devuelve en los eventos de webhook |
| `message.track_opens`, `track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `message.global_merge_vars` | `variables` |
| `message.merge_vars` (por destinatario) | Una petición por destinatario, cada una con sus propias `variables` |
| `message.subaccount` | Usa una clave de API del espacio de trabajo correspondiente |
| `send_at` | `scheduled_at` (ISO 8601 o lenguaje natural en inglés) |
| `async` | No es necesario. Emailit pone en cola todos los emails para su entrega y responde sin esperar a la entrega. |
| `POST /messages/send-template` con `template_name` | El mismo `POST /v2/emails` con `template` (un alias o ID) y `variables` |
| Respuesta: un array con `email`, `status` y `_id` por cada destinatario | `200` con `id` (`em_…`), `status: "accepted"` y, con varios destinatarios, `ids` con un ID para cada uno |

Mandrill informa de los problemas por destinatario en la respuesta, con estados como `rejected` o `invalid`. Emailit valida toda la petición y devuelve un error HTTP si los datos no son válidos. Los destinatarios con un bloqueo de tipo `recipient` se aceptan y después reciben 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 | Mandrill | Emailit |
| --- | --- | --- |
| Host | `smtp.mandrillapp.com` | `smtp.emailit.com` |
| Puerto | `587`, `2525` o `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Usuario | Cualquier valor | `emailit` |
| Contraseña | Una clave de API de Mandrill | Tu clave de API de Emailit |

Emailit no lee las cabeceras `X-MC-*`, como `X-MC-Template`, `X-MC-MergeVars`, `X-MC-Tags`, `X-MC-Metadata` o `X-MC-Track`. Elimínalas. Configura el seguimiento en el dominio y usa la API cuando necesites plantillas o metadatos. Consulta [Configuración SMTP](/es/docs/smtp/settings/).

## Equivalencias de los eventos de webhook

| Evento de Mandrill | Evento de Emailit |
| --- | --- |
| `send` | `email.accepted` (solo API) |
| `delivered` | `email.delivered` |
| `deferral` | `email.attempted` |
| `hard_bounce` | `email.bounced` |
| `soft_bounce` | `email.attempted` mientras Emailit reintenta, y después `email.bounced` si fallan todos los reintentos |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `spam` | `email.complained` |
| `unsub` | `email.unsubscribed`, solo para los emails de campaña |
| `reject` | `email.suppressed` cuando la dirección tiene un bloqueo de tipo `recipient`. Los demás motivos de rechazo, como `unsigned`, son errores de la API en Emailit. |
| Eventos de sincronización de la rejection denylist | `suppression.created`, `suppression.deleted`, para los bloqueos que añades o eliminas |
| `inbound` | `email.received`; después, obtén el contenido con [`GET /emails/{id}`](/es/docs/api-reference/emails/get/) |

El formato de las peticiones cambia:

- Mandrill envía por POST un campo de formulario, `mandrill_events`, que contiene un array JSON de hasta 1000 eventos. Emailit envía el array JSON como cuerpo de la petición, con hasta 100 eventos.
- El nombre del evento está en `type` y el email, en `data.object`. Usa `data.object.id`, el ID `em_` de la respuesta de envío, en lugar de `_id`, y `data.object.to` en lugar de `msg.email`. 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`.
- Mandrill firma la URL y los campos del formulario con HMAC-SHA1, codificado en base64, en `X-Mandrill-Signature`. Emailit firma `<timestamp>.<raw body>` con HMAC-SHA256: verifica `X-Emailit-Signature` con `X-Emailit-Timestamp` y tu secreto `whsec_`. 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 toda la rejection denylist con **Export Full Denylist** en la página **Rejection Denylist** de Mandrill, o con la llamada `/exports/rejects` de la API. `/rejects/list` devuelve como máximo 1000 entradas, así que no la uses para esto. La exportación es un archivo ZIP con `rejects.csv` e incluye todas las subcuentas.

2. Crea un único CSV con las columnas `email,type,reason`. Omite las entradas que ya hayan caducado y usa la columna `reason` para elegir el tipo:

   | Motivo en Mandrill | Tipo en Emailit |
   | --- | --- |
   | `hard-bounce`, `spam`, `custom` | `recipient` |
   | `unsub` | `unsubscribe`, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usa `recipient` para bloquear todos los emails, como hacía Mandrill. |
   | `soft-bounce` | Déjalas fuera. Caducan al cabo de un día. |

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

   El tipo `recipient` bloquea los envíos por API, por SMTP y de campañas. Si usabas subcuentas, divide el archivo según su columna de subcuenta e importa cada parte en el espacio de trabajo correspondiente.

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.

La rejection allowlist de Mandrill no tiene equivalente. Consulta [Gestionar las direcciones bloqueadas](/es/docs/suppressions/manage/).

## Trasladar las plantillas

Obtén el código de tus plantillas desde Mandrill: una sola llamada a `/templates/list` devuelve todas las plantillas con su `slug` y su HTML publicado en `publish_code`. Después, importa cada una en **Email Marketing → Templates** o créala con la [API de plantillas](/es/docs/api-reference/templates/create/). Usa el slug de Mandrill como alias si se ajusta al formato de los alias: letras minúsculas, números, `-` y `_`.

Las plantillas que usaban regiones `mc:edit` rellenadas con `template_content` necesitan que esas regiones se conviertan en variables. Los nombres de las variables de combinación de Mandrill no distinguen mayúsculas y minúsculas, pero los de Temple sí: `{{FNAME}}` solo coincide con una variable llamada `FNAME`. Convierte las etiquetas de combinación a Temple:

| Mandrill | Emailit (Temple) |
| --- | --- |
| `*\|FNAME\|*` (lenguaje de combinación de Mailchimp) | `{{FNAME}}`, o cámbiale el nombre a `{{first_name}}` |
| `{{fname}}` (lenguaje de combinación Handlebars) | `{{fname}}` |
| `*\|IF:FNAME\|*…*\|ELSE:\|*…*\|END:IF\|*` | `{{#if FNAME}}…{{else}}…{{/if}}` |
| `*\|IF:PLAN=pro\|*`, o una comparación dentro de un `{{#if}}` de Handlebars | No compatible. Pasa un booleano como `is_pro` y usa `{{#if is_pro}}`. |
| `*\|DATE:d/m/y\|*`, `*\|CURRENT_YEAR\|*`, helpers como `{{upper name}}` | No compatible. Da formato al valor en tu código y pásalo. |
| `*\|UNSUB:https://…\|*`, `{{unsub "…"}}` | Tu propio enlace de baja. Consulta [Bajas](/es/docs/audiences/unsubscribes/#transactional-email-and-unsubscribes). |
| `{{#if plan}}…{{else}}…{{/if}}` | Igual |
| `{{#each items}}…{{/each}}` | No compatible. Genera la lista en tu código y pásala como una sola variable. |
| `…` con `template_content` | `{{body}}`, que se pasa en `variables` |
| `global_merge_vars` | `variables` |

Temple nunca escapa el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos. Un valor que falta se renderiza como una cadena vacía, salvo que añadas un valor por defecto, como `{{name|"there"}}`. Consulta [Lenguaje de plantillas Temple](/es/docs/templates/temple/).

## 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 CNAME `mte1._domainkey` y `mte2._domainkey` de Mandrill ni con su registro TXT `mandrill_verify`. 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 y de verificación de Mandrill, los CNAME personalizados de seguimiento o de return-path que tengas, y también `include:spf.mandrillapp.com` si tu registro SPF lo incluye. Si recibes correo con las rutas de entrada de Mandrill, trasládalo antes a un [subdominio de entrada](/es/docs/inbound/set-up/) de Emailit.

## 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/mandrill/
