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.
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:
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." }
]
}
}'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
statusatype, y el email está endata.object. Usadata.object.id, el IDem_de la respuesta de envío, en lugar demessageid, ydata.object.toen lugar deto. Tus valores demeta, que sustituyen achannelypostback, está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. - Emailit firma todas las peticiones. Verifica
X-Emailit-Signature, el HMAC-SHA256 en hexadecimal de<timestamp>.<raw body>, conX-Emailit-Timestampy tu secretowhsec_. La firma opcional de Elastic Email también usa secretoswhsec_, pero firma otra cadena, así que actualiza tu código de verificación. 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 las direcciones que bloquea Elastic Email, desde Suppressions en el panel de control o con la API (
/v4/suppressions/bounces,/complaintsy/unsubscribes). -
Crea un único CSV con las columnas
email,type,reason:Estado en Elastic Email Tipo en Emailit Invalid ( Bounced)recipientComplaint ( Abuse)recipientUnsubscribed unsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usarecipientpara bloquear todos los emails.email,type,reason old-address@example.com,recipient,elastic email bounced left@example.com,unsubscribe,elastic email unsubscribed -
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
- 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