Saltar al contenido
Docs

Guía

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.

Actualizado el 23 oct 2026

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

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, cada uno con sus propios dominios, claves, límites y créditos
Claves de API Claves de API: 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 y solo pueden enviar a los miembros del espacio de trabajo.
Dominios de envío y verificación DKIM/SPF Dominios de envío
Dominios de seguimiento Subdominio de seguimiento, como go.acme.com
Plantillas con regiones mc:edit Plantillas con un alias y versiones, renderizadas con Temple
Webhooks Webhooks
Dominios de entrada y rutas Emails entrantes
Rejection denylist Direcciones bloqueadas
Rejection allowlist No disponible
Lenguajes de combinación: Mailchimp y Handlebars Temple
Etiquetas y metadatos meta
Outbound activity Email APIEmails y Email APILogs
IP dedicadas y pools de IP IP dedicadas 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:

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>"
    }
  }'
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 <email>"
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.

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.

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}

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

La rejection allowlist de Mandrill no tiene equivalente. Consulta Gestionar las direcciones bloqueadas.

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 MarketingTemplates o créala con la API de plantillas. 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.
{{#if plan}}…{{else}}…{{/if}} Igual
{{#each items}}…{{/each}} No compatible. Genera la lista en tu código y pásala como una sola variable.
<div mc:edit="body">…</div> 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.

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

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 de Emailit.

Próximos pasos

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.