# 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](/es/docs/migrate/) 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](/es/docs/workspaces/). Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Claves de API con niveles de acceso | [Claves de API](/es/docs/developers/api-keys/): **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](/es/docs/domains/). Las direcciones de remitente individuales no están disponibles. |
| Canales y valores de postback | `meta` |
| Plantillas, identificadas por su nombre | [Plantillas](/es/docs/templates/) con un alias y versiones |
| Campos de combinación y scripting de plantillas | [Temple](/es/docs/templates/temple/): variables, valores por defecto y condicionales |
| Notificaciones web HTTP | [Webhooks](/es/docs/webhooks/) |
| Rutas de entrada | [Emails entrantes](/es/docs/inbound/) |
| Suppressions y estados de contacto que bloquean el envío | [Direcciones bloqueadas](/es/docs/suppressions/) |
| Contactos y listas | [Contactos](/es/docs/contacts/) y [listas de contactos](/es/docs/audiences/) |
| 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) |
| Formularios | [Formularios](/es/docs/forms/) (acceso anticipado), o la [URL de suscripción](/es/docs/audiences/subscribe-url/) de una lista de contactos |
| Verificación de emails | [Verificación de emails](/es/docs/email-verification/) |
| IP privadas y pools de IP | [IP dedicadas](/es/docs/deliverability/dedicated-ips/) 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](/es/docs/campaigns/) 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](/es/docs/email-api/headers-and-metadata/#add-list-unsubscribe-to-bulk-mail).

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

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

```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>"
  }'
```

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

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

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

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](/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

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

Consulta [Gestionar las direcciones bloqueadas](/es/docs/suppressions/manage/).

## 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 Marketing → Contacts** 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](/es/docs/contacts/custom-fields/) 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](/es/docs/contacts/import-export/).

Vuelve a crear tus campañas y automatizaciones en **Email Marketing → Campaigns** 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 Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/), 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](/es/docs/contacts/global-values/) |
| 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](/es/docs/campaigns/merge-tags/) y [Lenguaje de plantillas Temple](/es/docs/templates/temple/).

## 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 `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](/es/docs/domains/dns-records/).

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](/es/docs/inbound/set-up/) 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](/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/elastic-email/
