Saltar al contenido
Docs

Guía

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.

Actualizado el 23 oct 2026

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:

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

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.