Guía
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 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:
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>"
}
}'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
typey el email, endata.object. Usadata.object.id, el IDem_de la respuesta de envío, en lugar de_id, ydata.object.toen lugar demsg.email. Tus valores demetaestán endata.object.meta. - Para
email.loadedyemail.clicked,data.objectes la carga o el clic. Usadata.object.email_idpara el ID del email, ydata.object.email.rcpt_toydata.object.email.metapara el destinatario y tus valores demeta. - 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: verificaX-Emailit-SignatureconX-Emailit-Timestampy tu secretowhsec_. Consulta Verificar las firmas de los webhooks.
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
-
Exporta toda la rejection denylist con Export Full Denylist en la página Rejection Denylist de Mandrill, o con la llamada
/exports/rejectsde la API./rejects/listdevuelve como máximo 1000 entradas, así que no la uses para esto. La exportación es un archivo ZIP conrejects.csve incluye todas las subcuentas. -
Crea un único CSV con las columnas
email,type,reason. Omite las entradas que ya hayan caducado y usa la columnareasonpara elegir el tipo:Motivo en Mandrill Tipo en Emailit hard-bounce,spam,customrecipientunsubunsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usarecipientpara bloquear todos los emails, como hacía Mandrill.soft-bounceDéjalas fuera. Caducan al cabo de un día. email,type,reason old-address@example.com,recipient,mandrill hard-bounce angry@example.com,recipient,mandrill spamEl tipo
recipientbloquea 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. -
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
- Lista de comprobación para pasar a producción
- Configurar un webhook
- Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo