Saltar al contenido
Docs

Guía

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.

Actualizado el 23 oct 2026

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:

Antes: Mailjet
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>"
    }]
  }'
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>"
  }'
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 event 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 o Message_GUID, y data.object.to en lugar de email. Tus valores de meta, que sustituyen a CustomID y Payload, 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.
  • Mailjet no firma sus peticiones. Emailit las firma todas: verifica X-Emailit-Signature con X-Emailit-Timestamp y tu secreto whsec_ y, si quieres, quita de tu URL las credenciales de autenticación básica. 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

Mailjet no tiene una única lista de direcciones bloqueadas, así que reúne las direcciones de varios sitios:

  1. 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=true unsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales, como la lista de exclusión de Mailjet
    Contactos que se quejaron por spam Los contactos con IsSpamComplaining activado, desde GET /v3/REST/contact recipient
    Rebotes duros Los eventos bounce que guardaron tus webhooks, o tus informes de campañas recipient
  2. Crea un único CSV con las columnas email,type,reason:

    CSV
    email,type,reason
    excluded@example.com,unsubscribe,mailjet exclusion list
    angry@example.com,recipient,mailjet spam complaint

    El tipo recipient bloquea los envíos por API, por SMTP y de campañas.

  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.

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.

  1. Prepara Emailit. Crea un campo personalizado por cada propiedad de contacto que uses, y una lista de contactos por cada lista.

  2. 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.

  3. 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 tipo unsubscribe detiene 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

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.