Saltar al contenido
Docs

Guía

Migrar desde Elastic Email

Pasa de Elastic Email a Emailit. Equivalencias de las llamadas a las API v4 y v2, las credenciales SMTP y las notificaciones, conversión de los campos de combinación, y traslado de direcciones bloqueadas, contactos y campañas.

Actualizado el 23 oct 2026

Esta guía relaciona los conceptos, las llamadas a la API, las notificaciones, las direcciones bloqueadas, las plantillas y los contactos de Elastic 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.

Conceptos

Elastic Email Emailit
Cuenta y subcuentas Cuenta y espacios de trabajo. Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos.
Claves de API con niveles de acceso Claves de API: Full Access, o Sending Only limitada opcionalmente a un dominio
Credenciales SMTP Tu clave de API, usada como contraseña SMTP
Dominios verificados y direcciones de remitente verificadas Dominios de envío. Las direcciones de remitente individuales no están disponibles.
Canales y valores de postback meta
Plantillas, identificadas por su nombre Plantillas con un alias y versiones
Campos de combinación y scripting de plantillas Temple: variables, valores por defecto y condicionales
Notificaciones web HTTP Webhooks
Rutas de entrada Emails entrantes
Suppressions y estados de contacto que bloquean el envío Direcciones bloqueadas
Contactos y listas Contactos y listas de contactos
Segmentos Elige y excluye listas de contactos en cada campaña. Los segmentos están en alfa y solo están abiertos al equipo de Emailit.
Campañas y automatizaciones Campañas y automatizaciones (beta)
Formularios Formularios (acceso anticipado), o la URL de suscripción de una lista de contactos
Verificación de emails Verificación de emails
IP privadas y pools de IP IP dedicadas bajo solicitud

Elastic Email añade un enlace de baja a todos los emails, incluidos los que se envían por API y por SMTP. Emailit solo añade las cabeceras List-Unsubscribe a las campañas y a los emails de marketing de las automatizaciones, y el enlace visible lo añades tú con {{unsubscribe_url}}. Si envías newsletters u otro correo masivo por la API o por SMTP, añade tu propio enlace y las cabeceras List-Unsubscribe. Consulta Cabeceras y metadatos.

Actualizar las llamadas a la API

POST /v4/emails/transactional de Elastic Email pasa a ser POST /v2/emails. El cuerpo es plano, los nombres de los campos van en minúsculas y la clave pasa a una cabecera Authorization:

Antes: Elastic Email
curl https://api.elasticemail.com/v4/emails/transactional \
  -H "X-ElasticEmail-ApiKey: $ELASTICEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Recipients": { "To": ["ada@example.com"] },
    "Content": {
      "From": "Acme <hello@acme.com>",
      "Subject": "Your receipt",
      "Body": [
        { "ContentType": "HTML", "Content": "<p>Thanks for your order.</p>" },
        { "ContentType": "PlainText", "Content": "Thanks for your order." }
      ]
    }
  }'
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>"
  }'
Elastic Email (API v4) Emailit
Cabecera X-ElasticEmail-ApiKey Authorization: Bearer secret_…
Content.From from
Recipients.To, CC, BCC to, cc, bcc, hasta 50 cada uno
Content.ReplyTo reply_to
Content.Subject subject
Content.Body[] con ContentType HTML y PlainText html y text
Content.Headers headers
Content.Attachments[] con BinaryContent, Name, ContentType attachments[] con content, filename, content_type
Content.AttachFiles (archivos subidos antes) attachments[] con una url que Emailit descarga
Content.TemplateName template, un alias o ID de plantilla
Content.Merge variables
Options.ChannelName, Content.Postback meta, que se devuelve en los eventos de webhook
Options.TrackOpens, Options.TrackClicks tracking: { "loads": true, "clicks": true }
Options.TimeOffset (minutos) scheduled_at (ISO 8601 o lenguaje natural en inglés)
Options.PoolName No es necesario. Una IP dedicada envía todo el correo de su espacio de trabajo.
Content.Utm Añade parámetros UTM a tus enlaces. Las campañas los añaden por ti.
POST /v4/emails con Recipients[].Fields (combinación masiva) Una petición por destinatario, cada una con sus propias variables
Cabecera Idempotency-Key Cabecera Idempotency-Key, que se conserva durante 24 horas
Respuesta con TransactionID y MessageID 200 con id (em_…), status: "accepted" y, con varios destinatarios, ids con un ID para cada uno

Si todavía usas la API v2 (/v2/email/send con un parámetro apikey), asigna sus campos de formulario de la misma manera: from y fromName pasan a ser from, bodyHtml y bodyText pasan a ser html y text, los campos merge_* pasan a ser variables, y template pasa a ser template. En la v2, cada dirección de to recibe un mensaje independiente, como con CCO. En Emailit, los destinatarios de to se ven entre sí en la cabecera To, así que envía una petición por destinatario para mantenerlos separados. Consulta Enviar un email.

Cambiar la configuración SMTP

Ajuste Elastic Email Emailit
Host smtp.elasticemail.com smtp.emailit.com
Puerto 2525, 587 o 25 (STARTTLS), 465 (TLS) 587, 2587, 2525 o 25 (STARTTLS), 465 (TLS)
Usuario El nombre de la credencial SMTP, una dirección de email emailit
Contraseña El token de la credencial SMTP Tu clave de API de Emailit

Emailit no lee las cabeceras de control de Elastic Email, como X-ElasticEmail-Channel, X-ElasticEmail-Postback, IsTransactional, trackopens o trackclicks. Elimínalas y configura el seguimiento en el dominio. Consulta Configuración SMTP.

Equivalencias de los eventos de webhook

Notificación de Elastic Email Evento de Emailit
Sent (el servidor del destinatario aceptó el mensaje) email.delivered
Opened email.loaded
Clicked email.clicked
Error email.bounced para los fallos permanentes. Los fallos temporales envían email.attempted mientras Emailit reintenta.
AbuseReport email.complained
Unsubscribed email.unsubscribed, solo para los emails de campaña
Ruta de entrada que notifica a una URL email.received; después, obtén el contenido con GET /emails/{id}

Emailit también envía email.accepted cuando la API acepta un email, y email.suppressed cuando un bloqueo de tipo recipient impide el envío a una dirección. Consulta Tipos de eventos.

El formato de las peticiones cambia:

  • Elastic Email envía un evento por petición, en la cadena de consulta o como un objeto JSON plano. Emailit envía un array JSON de hasta 100 eventos, así que recorre el cuerpo.
  • El nombre del evento pasa de status a type, y el email está en data.object. Usa data.object.id, el ID em_ de la respuesta de envío, en lugar de messageid, y data.object.to en lugar de to. Tus valores de meta, que sustituyen a channel y postback, 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.
  • Emailit firma todas las peticiones. Verifica X-Emailit-Signature, el HMAC-SHA256 en hexadecimal de <timestamp>.<raw body>, con X-Emailit-Timestamp y tu secreto whsec_. La firma opcional de Elastic Email también usa secretos whsec_, pero firma otra cadena, así que actualiza tu código de verificación. 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 las direcciones que bloquea Elastic Email, desde Suppressions en el panel de control o con la API (/v4/suppressions/bounces, /complaints y /unsubscribes).

  2. Crea un único CSV con las columnas email,type,reason:

    Estado en Elastic Email Tipo en Emailit
    Invalid (Bounced) recipient
    Complaint (Abuse) recipient
    Unsubscribed unsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usa recipient para bloquear todos los emails.
    CSV
    email,type,reason
    old-address@example.com,recipient,elastic email bounced
    left@example.com,unsubscribe,elastic email unsubscribed
  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.

Consulta Gestionar las direcciones bloqueadas.

Trasladar los contactos y las campañas

Exporta tus contactos desde Contacts (selecciónalos y después usa More actions > Export) o con POST /v4/contacts/export, y exporta cada lista a la que envías campañas. Después, trasládalos según su estado:

Estado en Elastic Email Destino
Engaged, Active Impórtalos en la lista de contactos correspondiente en Email MarketingContacts con Import.
Transactional Déjalos fuera de las listas de contactos. Nunca se suscribieron a tu email de marketing.
Invalid, Complaint, Unsubscribed La lista de direcciones bloqueadas, como se explica arriba.
Inactive, Stale, Not Confirmed Déjalos fuera.

Crea campos personalizados para los campos de tus contactos antes de importar, y divide los archivos en partes de hasta 2500 filas. La importación añade como suscritas a todas las personas del archivo, así que importa solo a quienes deban recibir tus campañas. Consulta Importar y exportar contactos.

Vuelve a crear tus campañas y automatizaciones en Email MarketingCampaigns y en Automations, a partir de las plantillas importadas.

Trasladar las plantillas

Copia el HTML de cada plantilla con Edit as HTML en Elastic Email, u obtenlo con GET /v4/templates/{name}, que lo devuelve en Body. Impórtalo en Email MarketingTemplates o crea la plantilla con la API de plantillas, y usa el nombre de la plantilla como alias si se ajusta al formato de los alias: letras minúsculas, números, - y _.

Los campos de combinación de Elastic Email usan llaves simples, y Temple usa dobles llaves. Los campos con llaves simples que queden en una plantilla se envían como texto plano, así que conviértelos todos:

Elastic Email Emailit (Temple)
{firstname}, {lastname}, {email} {{first_name}}, {{last_name}}, {{email}} en las campañas. En los envíos por API, los nombres que pases en variables.
{firstname:friend} {{first_name|"friend"}}
{company} u otro campo personalizado {{cf.company}} en las campañas
{unsubscribe} {{unsubscribe_url}} en las campañas
{contactprofile} {{manage_subscriptions_url}} en las campañas
{view} {{webview_url}} en las campañas
{accountaddress} y otros campos de la cuenta Escríbelos en la plantilla, o guárdalos en valores globales
Scripting de plantillas en {{ … }} No compatible. Calcula los valores en tu código y usa {{#if}} para el contenido condicional.

Consulta Etiquetas de combinación y 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 el registro DKIM api._domainkey de Elastic Email, su CNAME tracking ni un dominio de rebotes personalizado. Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.

Después del cambio definitivo, elimina los registros DKIM y de seguimiento de Elastic Email, y quita include:_spf.elasticemail.com de tu registro SPF. Si recibes correo con las rutas de entrada de Elastic Email, trasládalo antes a un subdominio de entrada de Emailit. Emailit recibe en un subdominio, como inbound.acme.com, así que las direcciones de recepción cambian.

Próximos pasos

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.