Guía
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 para conocer el orden general y cómo usar los dos proveedores en paralelo.
Conceptos
| MailerSend | Emailit |
|---|---|
| Cuenta | Cuenta y espacios de trabajo. Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Dominios | Dominios de envío |
| Identidades de remitente | No disponible. Todas las direcciones del remitente deben pertenecer a un dominio verificado. |
| Tokens de API con permisos | Claves de API: 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 y solo pueden enviar a los miembros del espacio de trabajo. |
| Plantillas | Plantillas con un alias y versiones, renderizadas con Temple |
| Webhooks por dominio | Webhooks por espacio de trabajo |
| Rutas de entrada | Emails entrantes, con el webhook email.received o la automatización Forward received email |
| Suppressions por dominio: rebotes duros, quejas por spam, bajas, blocklist | Una lista de direcciones bloqueadas por espacio de trabajo |
| Lista on hold | No es necesaria. Emailit reintenta los rebotes blandos y notifica cada intento como email.attempted. |
| Activity | Email APIEmails y Email APILogs |
| Etiquetas | meta |
| Verificación de emails | Verificación de emails |
| IP dedicadas | IP dedicadas 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:
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>"
}'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 <email>" |
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. |
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.
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.
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} |
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á endata.object: usadata.object.id, el IDem_de la respuesta de envío, en lugar dedata.message_id(data.email.message.iden los webhooks de la versión 1), ydata.object.toen lugar dedata.recipient. 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. - La cabecera
Signaturede MailerSend es un HMAC-SHA256 del cuerpo en bruto. La cabeceraX-Emailit-Signaturede Emailit es un HMAC-SHA256 de<timestamp>.<raw body>con tu secretowhsec_como clave, así que lee tambiénX-Emailit-Timestamp. 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
-
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,/unsubscribesy/blocklist). La lista on hold es temporal, así que puedes omitirla. -
Crea un único CSV con las columnas
email,type,reason:email,type,reason old-address@example.com,recipient,mailersend hard bounce angry@example.com,recipient,mailersend spam complaintUsa el tipo
recipientpara 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 tipounsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales. -
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.
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.
Trasladar las plantillas
Copia el HTML de cada plantilla desde el editor de MailerSend y después impórtalo en Email MarketingTemplates o crea la plantilla con la API de plantillas. 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 e Importar, exportar y duplicar plantillas.
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 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.
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.
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
- Configurar un webhook
- Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo