Guía
Migrar desde Mailjet
Pasa de Mailjet a Emailit. Equivalencias de los pares de claves de API y los remitentes, conversión de las llamadas a la Send API v3.1 y del lenguaje de plantillas, cambio de SMTP, y traslado de webhooks, exclusiones y listas de contactos.
Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, las direcciones bloqueadas, las plantillas y los contactos de Mailjet 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
| Mailjet | Emailit |
|---|---|
| Clave de API principal y claves de API de subcuentas | Cuenta y espacios de trabajo. Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Par de claves de API (clave pública y clave secreta) | Clave de API: Full Access, o Sending Only limitada opcionalmente a un dominio |
| Remitentes: direcciones individuales y dominios completos | Dominios de envío. Las direcciones de remitente individuales no están disponibles. |
SandboxMode |
No hay modo de prueba. Los espacios de trabajo nuevos están en modo sandbox y solo entregan a los miembros del espacio de trabajo. |
| Plantillas y el lenguaje de plantillas de Mailjet | Plantillas con un alias y versiones, renderizadas con Temple |
| Event API, una URL por tipo de evento | Webhooks: un endpoint puede recibir todos los tipos de eventos |
| Parse API | Emails entrantes |
| Lista de exclusión, contactos que se quejaron por spam y direcciones bloqueadas | Direcciones bloqueadas |
| Contactos, listas de contactos y propiedades de contacto | Contactos, listas de contactos y campos personalizados |
| 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) |
CustomID, EventPayload, CustomCampaign |
meta |
| Estadísticas e historial de mensajes | Email APIEmails, Email APILogs e informes de campañas |
Actualizar las llamadas a la API
POST /v3.1/send de Mailjet recibe autenticación básica y una lista Messages con campos en PascalCase. POST /v2/emails de Emailit recibe un token bearer y un solo mensaje con campos en minúsculas:
curl https://api.mailjet.com/v3.1/send \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
-H "Content-Type: application/json" \
-d '{
"Messages": [{
"From": { "Email": "hello@acme.com", "Name": "Acme" },
"To": [{ "Email": "ada@example.com" }],
"Subject": "Your receipt",
"TextPart": "Thanks for your order.",
"HTMLPart": "<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>"
}'| Mailjet (Send API v3.1) | Emailit |
|---|---|
| Autenticación básica con la clave pública y la secreta | Authorization: Bearer secret_… |
api.mailjet.com, o api.us.mailjet.com para las cuentas de EE. UU. |
Un único host, api.emailit.com |
Messages[], hasta 50 por llamada |
Un mensaje por petición |
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 |
ReplyTo |
reply_to |
Subject, TextPart, HTMLPart |
subject, text, html |
Headers |
headers |
Attachments[] con ContentType, Filename, Base64Content |
attachments[] con content_type, filename, content |
InlinedAttachments[] con ContentID |
attachments[] con un content_id, al que se hace referencia como cid: en el HTML |
CustomID, EventPayload, CustomCampaign |
meta, por ejemplo meta: { "custom_id": "order-123" }, que se devuelve en los eventos de webhook |
TemplateID, TemplateLanguage: true y Variables |
template (un alias o ID) y variables |
TrackOpens, TrackClicks |
tracking: { "loads": true, "clicks": true } |
URLTags |
Añade parámetros UTM a tus enlaces. Las campañas los añaden por ti. |
Globals |
No disponible. Repite los campos comunes en cada petición. |
Respuesta con MessageUUID y MessageID para cada destinatario |
200 con id (em_…), status: "accepted" y, con varios destinatarios, ids con un ID para cada uno |
Los ID de Emailit son cadenas, así que ya no tienes que gestionar los valores enteros grandes de MessageID de Mailjet. Emailit también admite la programación con scheduled_at y los reintentos seguros con una cabecera Idempotency-Key. Consulta Enviar un email.
Cambiar la configuración SMTP
| Ajuste | Mailjet | Emailit |
|---|---|---|
| Host | in-v3.mailjet.com |
smtp.emailit.com |
| Puerto | 587, 588, 2525, 25 o 80 (STARTTLS), 465 (TLS) |
587, 2587, 2525 o 25 (STARTTLS), 465 (TLS) |
| Usuario | Tu clave de API pública | emailit |
| Contraseña | Tu clave de API secreta | Tu clave de API de Emailit |
Emailit no lee las cabeceras de Mailjet, como X-Mailjet-Campaign, X-MJ-CustomID, X-MJ-EventPayload, X-Mailjet-TrackOpen, X-Mailjet-TrackClick, X-MJ-TemplateID o X-MJ-Vars. 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 Mailjet | Evento de Emailit |
|---|---|
sent |
email.delivered |
bounce |
email.bounced. Emailit también envía email.attempted por cada intento fallido que reintenta. |
blocked |
email.suppressed cuando la dirección tiene un bloqueo de tipo recipient |
spam |
email.complained |
open |
email.loaded |
click |
email.clicked |
unsub |
email.unsubscribed, solo para los emails de campaña |
| Ruta de la Parse API | 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. Consulta Tipos de eventos.
El formato de las peticiones cambia:
- Mailjet necesita una URL por cada tipo de evento y envía un evento por petición, salvo que agrupes los eventos. Un webhook de Emailit puede suscribirse a muchos tipos de eventos y envía un array JSON de hasta 100 eventos, así que recorre el cuerpo.
- El nombre del evento pasa de
eventatype, y el email está endata.object. Usadata.object.id, el IDem_de la respuesta de envío, en lugar deMessageIDoMessage_GUID, ydata.object.toen lugar deemail. Tus valores demeta, que sustituyen aCustomIDyPayload, 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. - Mailjet no firma sus peticiones. Emailit las firma todas: verifica
X-Emailit-SignatureconX-Emailit-Timestampy tu secretowhsec_y, si quieres, quita de tu URL las credenciales de autenticación básica. 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
Mailjet no tiene una única lista de direcciones bloqueadas, así que reúne las direcciones de varios sitios:
-
Reúne las direcciones que bloquea Mailjet:
Mailjet Cómo exportarlas Tipo en Emailit Lista de exclusión La descarga de la lista de exclusión en el panel de control, o GET /v3/REST/contact?IsExcludedFromCampaigns=trueunsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales, como la lista de exclusión de MailjetContactos que se quejaron por spam Los contactos con IsSpamComplainingactivado, desdeGET /v3/REST/contactrecipientRebotes duros Los eventos bounceque guardaron tus webhooks, o tus informes de campañasrecipient -
Crea un único CSV con las columnas
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintEl tipo
recipientbloquea los envíos por API, por SMTP y de campañas. -
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.
Si usabas varias claves de API de Mailjet, repite este proceso con cada una. Consulta Gestionar las direcciones bloqueadas.
Trasladar los contactos
Exporta cada lista de contactos desde Contacts en Mailjet, o con GET /v3/REST/listrecipient?ContactsList={id}, que incluye el indicador IsUnsubscribed de cada miembro. Las propiedades de los contactos se obtienen con GET /v3/REST/contactdata.
-
Prepara Emailit. Crea un campo personalizado por cada propiedad de contacto que uses, y una lista de contactos por cada lista.
-
Importa los miembros suscritos. En Email MarketingContacts, selecciona Import, asigna las columnas y elige la lista de contactos correspondiente. Divide los archivos en partes de hasta 2500 filas. Consulta Importar y exportar contactos.
-
Bloquea al resto. La importación añade como suscritas a todas las personas del archivo, así que deja fuera del archivo a los miembros dados de baja. Añádelos en su lugar a tu archivo de direcciones bloqueadas con el tipo
unsubscribe, y deja fuera a los contactos cuyo opt-in sigue pendiente. Un bloqueo de tipounsubscribedetiene todas las campañas, así que no lo añadas para las personas que siguen suscritas a otra lista que estás trasladando.
Vuelve a crear tus campañas y automatizaciones en Email MarketingCampaigns y en Automations, a partir de las plantillas importadas.
Trasladar las plantillas
Obtén el HTML de cada plantilla con GET /v3/REST/template/{id}/detailcontent, que devuelve Html-part y Text-part, o cópialo desde el editor de Mailjet. Impórtalo en Email MarketingTemplates o crea la plantilla con la API de plantillas, y asígnale un alias, como receipt.
Convierte el lenguaje de plantillas de Mailjet a Temple:
| Mailjet | Emailit (Temple) |
|---|---|
{{var:name}}, {{var:order.total}} |
{{name}}, {{order.total}} |
{{var:name:"there"}} |
{{name|"there"}} |
{{data:firstname}} (una propiedad de contacto) |
{{first_name}} o {{cf.<key>}} en las campañas. En los envíos por API, pasa el valor en variables. |
{% if var:plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if var:plan == "pro" %}, {% elseif %} |
No compatible. Pasa un booleano como is_pro y usa {{#if is_pro}}. |
{% for item in var:items %}…{% endfor %} |
No compatible. Genera la lista en tu código y pásala como una sola variable. |
Funciones como Upper() o FormatNumber() |
No compatibles. Da formato al valor en tu código. |
{{mj:unsub_link}} |
{{unsubscribe_url}} en las campañas |
Variables |
variables |
Temple nunca escapa 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 el registro DKIM mailjet._domainkey de Mailjet ni con su registro TXT de verificación de propiedad. Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.
Si tu host de seguimiento personalizado de Mailjet ya es go, elige otro nombre para el de Emailit con tracking_key. Consulta Dominio de seguimiento personalizado.
Después del cambio definitivo, elimina los registros DKIM, de verificación de propiedad, de seguimiento y de return-path de Mailjet, y quita include:spf.mailjet.com de tu registro SPF. Si recibes correo con la Parse API en tu propio dominio, 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