# 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](/es/docs/migrate/) 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](/es/docs/workspaces/). 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](/es/docs/developers/api-keys/): **Full Access**, o **Sending Only** limitada opcionalmente a un dominio |
| Remitentes: direcciones individuales y dominios completos | [Dominios de envío](/es/docs/domains/). 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](/es/docs/workspaces/production-access/) y solo entregan a los miembros del espacio de trabajo. |
| Plantillas y el lenguaje de plantillas de Mailjet | [Plantillas](/es/docs/templates/) con un alias y versiones, renderizadas con [Temple](/es/docs/templates/temple/) |
| Event API, una URL por tipo de evento | [Webhooks](/es/docs/webhooks/): un endpoint puede recibir todos los tipos de eventos |
| Parse API | [Emails entrantes](/es/docs/inbound/) |
| Lista de exclusión, contactos que se quejaron por spam y direcciones bloqueadas | [Direcciones bloqueadas](/es/docs/suppressions/) |
| Contactos, listas de contactos y propiedades de contacto | [Contactos](/es/docs/contacts/), [listas de contactos](/es/docs/audiences/) y [campos personalizados](/es/docs/contacts/custom-fields/) |
| Segmentos | Elige y excluye listas de contactos en cada campaña. Los [segmentos](/es/docs/segments/) están en alfa y solo están abiertos al equipo de Emailit. |
| Campañas y automatizaciones | [Campañas](/es/docs/campaigns/) y [automatizaciones](/es/docs/automations/) (beta) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Estadísticas e historial de mensajes | **Email API → Emails**, **Email API → Logs** e [informes de campañas](/es/docs/campaigns/reports/) |

## 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:

```bash title="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>"
    }]
  }'
```

```bash title="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 "` |
| `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](/es/docs/email-api/send-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](/es/docs/smtp/settings/).

## 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}`](/es/docs/api-reference/emails/get/) |

Emailit también envía `email.accepted` cuando la API acepta un email. Consulta [Tipos de eventos](/es/docs/webhooks/event-types/).

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](/es/docs/webhooks/request-signature/).

```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 API → Suppressions**, 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](/es/docs/suppressions/manage/).

## 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](/es/docs/contacts/custom-fields/) por cada propiedad de contacto que uses, y una [lista de contactos](/es/docs/audiences/) por cada lista.

2. **Importa los miembros suscritos.** En **Email Marketing → Contacts**, 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](/es/docs/contacts/import-export/).

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 Marketing → Campaigns** 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 Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/), 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](/es/docs/templates/temple/) e [Importar, exportar y duplicar plantillas](/es/docs/templates/import-export/).

## Cambiar los DNS

Añade tu dominio en **Email API → Domains** 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](/es/docs/domains/dns-records/).

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](/es/docs/tracking/custom-tracking-domain/).

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](/es/docs/inbound/set-up/) de Emailit.

## Próximos pasos

- [Lista de comprobación para pasar a producción](/es/docs/get-started/go-live/)
- [Configurar un webhook](/es/docs/webhooks/set-up/)
- [Migración prioritaria](/es/docs/programs/priority-migration/): deja que los ingenieros de Emailit hagan la migración contigo

---
Fuente: https://emailit.com/es/docs/migrate/mailjet/
