Guía
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 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:
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>"
}'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
eventatype, y el email está endata.object. Usadata.object.id, el IDem_de la respuesta de envío o de la respuesta SMTP, en lugar deemail_id, ydata.object.toen lugar dercpt. Los valores que pasaste enmetaestán endata.object.meta. - Para
email.loadedyemail.clicked,data.objectes la carga o el clic. Usadata.object.email_idpara el ID del email, ydata.object.email.rcpt_toydata.object.email.metapara el destinatario y tus valores demeta. - SMTP2GO no firma los webhooks. Emailit firma todas las peticiones: verifica
X-Emailit-SignatureconX-Emailit-Timestampy tu secretowhsec_. Consulta Verificar las firmas de los webhooks.
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
-
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 indiquesstart_date, así que indícalo para cubrir todo tu historial. -
Crea un único CSV con las columnas
email,type,reason:Motivo en SMTP2GO Tipo en Emailit bounce,spam,manualrecipient, que bloquea los envíos por API, por SMTP y de campañasunsubscribeunsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales. Usarecipientsi la persona se dio de baja de todo lo que envías.email,type,reason old-address@example.com,recipient,smtp2go bounce left@example.com,unsubscribe,smtp2go unsubscribe -
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
- Lista de comprobación para pasar a producción
- Solución de problemas de SMTP
- Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo