Saltar al contenido
Docs

Guía

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.

Actualizado el 23 oct 2026

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 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. 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: 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
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 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 por dominio de envío. Emailit no añade un pie de baja a los emails enviados por API o por SMTP.
Plantillas Plantillas con un alias y versiones, renderizadas con Temple
Webhooks Webhooks
Bloqueos de direcciones y de dominios Bloqueos de direcciones
Informes y actividad Email APIEmails y Email APILogs
IP dedicadas y pools de IP IP dedicadas 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 de Emailit, que añaden las cabeceras por ti. En las campañas, añade el enlace visible con {{unsubscribe_url}}. Consulta Cabeceras SMTP.

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 y Cabeceras y respuestas SMTP.

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:

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

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

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.

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 MarketingTemplates o crea la plantilla con la API de plantillas, 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 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 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.

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

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.