# Migrar desde SMTP2GO

> Pasa de SMTP2GO a Emailit. Cambio de los usuarios y hosts SMTP, conversión de las llamadas a la API email/send y de las plantillas, y traslado de webhooks, direcciones bloqueadas y dominios de remitente.

Esta guía relaciona los conceptos, la configuración SMTP, las llamadas a la API, los webhooks, las direcciones bloqueadas y las plantillas de SMTP2GO 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

| SMTP2GO | Emailit |
| --- | --- |
| Cuenta principal y subcuentas | Cuenta y [espacios de trabajo](/es/docs/workspaces/). Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Usuarios SMTP | Tu clave de API, usada como contraseña SMTP. Crea una clave por aplicación o servidor. |
| Claves de API con permisos por endpoint | [Claves de API](/es/docs/developers/api-keys/): **Full Access**, o **Sending Only** limitada opcionalmente a un dominio |
| Autenticación por IP y por dirección | No disponible. Todas las conexiones SMTP se autentican con una clave de API. |
| Dominios de remitente | [Dominios de envío](/es/docs/domains/) |
| Direcciones de remitente individuales | No disponible. Todas las direcciones del remitente deben pertenecer a un dominio verificado. |
| Estado sandbox de un usuario SMTP o de una clave de API | 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. |
| Ajustes de seguimiento y del pie de baja por usuario SMTP o clave de API | [Seguimiento](/es/docs/tracking/) por dominio de envío. Emailit no añade un pie de baja a los emails enviados por API o por SMTP. |
| Plantillas | [Plantillas](/es/docs/templates/) con un alias y versiones, renderizadas con [Temple](/es/docs/templates/temple/) |
| Webhooks | [Webhooks](/es/docs/webhooks/) |
| Bloqueos de direcciones y de dominios | [Bloqueos](/es/docs/suppressions/) de direcciones |
| Informes y actividad | **Email API → Emails** y **Email API → Logs** |
| IP dedicadas y pools de IP | [IP dedicadas](/es/docs/deliverability/dedicated-ips/) bajo solicitud |

Si dependes del pie de baja de SMTP2GO para tus newsletters, añade tu propio enlace de baja y las cabeceras `List-Unsubscribe`, o envíalas como [campañas](/es/docs/campaigns/) de Emailit, que añaden las cabeceras por ti. En las campañas, añade el enlace visible con `{{unsubscribe_url}}`. Consulta [Cabeceras SMTP](/es/docs/smtp/headers/#add-list-unsubscribe-yourself).

## Cambiar la configuración SMTP

| Ajuste | SMTP2GO | Emailit |
| --- | --- | --- |
| Host | `mail.smtp2go.com`, o un host regional como `mail-eu.smtp2go.com` | `smtp.emailit.com` |
| Puerto | `2525`, `587`, `25`, `8025` o `80` (STARTTLS), `465`, `8465` o `443` (TLS) | `587`, `2587`, `2525` o `25` (STARTTLS), `465` (TLS) |
| Usuario | El nombre de usuario del usuario SMTP | `emailit` |
| Contraseña | La contraseña del usuario SMTP | Tu clave de API de Emailit |

Emailit no escucha en los puertos `80`, `443`, `8025` ni `8465`. Si tu red bloquea `25` y `587`, usa `2525` o `2587`. En Emailit, cada destinatario se convierte en un email independiente, y la respuesta `250` enumera sus ID, o solo el primer ID cuando hay muchos destinatarios. Consulta [Configuración SMTP](/es/docs/smtp/settings/) y [Cabeceras y respuestas SMTP](/es/docs/smtp/headers/).

## Actualizar las llamadas a la API

`POST /v3/email/send` de SMTP2GO pasa a ser `POST /v2/emails`. Las direcciones siguen siendo cadenas, pero los nombres de los campos cambian:

```bash title="Antes: SMTP2GO"
curl https://api.smtp2go.com/v3/email/send \
  -H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Your receipt",
    "text_body": "Thanks for your order.",
    "html_body": "<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>"
  }'
```

| SMTP2GO | Emailit |
| --- | --- |
| Cabecera `X-Smtp2go-Api-Key`, `api_key` en el cuerpo, o `Authorization: Bearer api-…` | `Authorization: Bearer secret_…` |
| `sender` | `from` |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc`, hasta 50 cada uno |
| `custom_headers` con `Reply-To` | `reply_to` |
| `custom_headers: [{ "header": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `subject` | `subject` |
| `text_body`, `html_body` | `text`, `html` |
| `attachments[]` con `filename`, `fileblob` o `url`, y `mimetype` | `attachments[]` con `filename`, `content` o `url`, y `content_type` |
| `inlines[]` | `attachments[]` con un `content_id`, al que se hace referencia como `cid:` en el HTML |
| `template_id` y `template_data` | `template` (un alias o ID) y `variables` |
| `schedule` (hasta 3 días de antelación) | `scheduled_at` (ISO 8601 o lenguaje natural en inglés) |
| `fastaccept` | No es necesario. Emailit pone en cola todos los emails para su entrega y responde sin esperar a que se entreguen. |
| `POST /v3/email/batch` (hasta 1000 emails) | No disponible. Envía una petición por mensaje. |
| `POST /v3/email/mime` | Envía el mensaje MIME a través del [SMTP relay](/es/docs/smtp/) |
| `200` con `email_id`, `succeeded`, `failed` y `failures` | `200` con `id` (`em_…`), `status: "accepted"` y, con varios destinatarios, `ids` con un ID para cada uno. Los errores usan códigos de estado HTTP. |

SMTP2GO no tiene metadatos ni ajustes de seguimiento por email. En Emailit, añade `meta` para recibir tus propios valores en los eventos de webhook, y `tracking: { "loads": true, "clicks": true }` para sustituir la configuración de seguimiento del dominio. Añade una cabecera `Idempotency-Key` para que los reintentos sean seguros. Consulta [Enviar un email](/es/docs/email-api/send-email/).

## Equivalencias de los eventos de webhook

| Evento de SMTP2GO | Evento de Emailit |
| --- | --- |
| `processed` | `email.accepted` (solo API) |
| `delivered` | `email.delivered` |
| `bounce` con `bounce` `soft` | `email.attempted` mientras Emailit reintenta, y después `email.bounced` si fallan todos los reintentos |
| `bounce` con `bounce` `hard` | `email.bounced` |
| `reject` | `email.suppressed` cuando la dirección tiene un bloqueo de tipo `recipient`. Los demás rechazos, como un remitente sin verificar, son errores en la respuesta de la API o en la respuesta SMTP. |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, solo para los emails de campaña |

El formato de las peticiones cambia:

- SMTP2GO envía un evento por petición, como campos de formulario por defecto o como JSON plano. Emailit 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 o de la respuesta SMTP, en lugar de `email_id`, y `data.object.to` en lugar de `rcpt`. Los valores que pasaste en `meta` 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`.
- SMTP2GO no firma los webhooks. Emailit firma todas las peticiones: verifica `X-Emailit-Signature` con `X-Emailit-Timestamp` y tu secreto `whsec_`. 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 bloqueadas desde **Reports > Suppressions** con **Export**, o recorre las páginas de `POST /v3/suppression/view`. La API devuelve aproximadamente los últimos 30 días salvo que indiques `start_date`, así que indícalo para cubrir todo tu historial.

2. Crea un único CSV con las columnas `email,type,reason`:

   | Motivo en SMTP2GO | Tipo en Emailit |
   | --- | --- |
   | `bounce`, `spam`, `manual` | `recipient`, que bloquea los envíos por API, por SMTP y de campañas |
   | `unsubscribe` | `unsubscribe`, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usa `recipient` si la persona se dio de baja de todo lo que envías. |

```csv
email,type,reason
old-address@example.com,recipient,smtp2go bounce
left@example.com,unsubscribe,smtp2go unsubscribe
```

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.

Emailit bloquea direcciones exactas, así que los bloqueos de dominios no se pueden importar. Repite la exportación con cada subcuenta e impórtala en el espacio de trabajo correspondiente. Consulta [Gestionar las direcciones bloqueadas](/es/docs/suppressions/manage/).

## Trasladar las plantillas

Obtén el HTML de cada plantilla con `POST /v3/template/view`, que devuelve `html_body`, `text_body` y `subject`, o cópialo desde **Settings > Templates**. Impórtalo en **Email Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/), y usa el ID de la plantilla de SMTP2GO como alias si se ajusta al formato de los alias: letras minúsculas, números, `-` y `_`.

SMTP2GO ignora `subject` cuando envías una plantilla. Emailit usa el asunto de la plantilla salvo que la petición incluya uno, así que omite `subject` para conservar el de la plantilla.

Las plantillas de SMTP2GO usan Handlebars. Temple cubre lo más habitual:

| SMTP2GO (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{ username }}`, `{{ user.name }}` | `{{username}}`, `{{user.name}}` |
| `{{{ html_block }}}` | `{{html_block}}`. Temple nunca escapa el HTML, así que escapa tú los datos que introducen los usuarios. |
| `{{#if plan}}…{{else}}…{{/if}}` | Igual |
| `{{#each items}}…{{/each}}` | No compatible. Genera la lista en tu código y pásala como una sola variable. |
| Sin valor por defecto integrado | `{{username\|"there"}}` añade un valor alternativo |
| `template_data` | `variables` |

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 CNAME de DKIM `s<number>._domainkey` de SMTP2GO, su CNAME de return-path `em<number>` ni su CNAME de seguimiento `link`. 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 CNAME de SMTP2GO, y `include:spf.smtp2go.com` si tu registro SPF todavía lo tiene.

## Próximos pasos

- [Lista de comprobación para pasar a producción](/es/docs/get-started/go-live/)
- [Solución de problemas de SMTP](/es/docs/smtp/troubleshooting/)
- [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/smtp2go/
