Migrar desde Postmark

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

Para mantener separadas la reputación transaccional y la de marketing, envía cada tipo desde dominios o subdominios distintos, como mail.acme.com para los recibos y news.acme.com para las newsletters.

Actualizar las llamadas a la API

POST /email de Postmark con un X-Postmark-Server-Token pasa a ser POST /v2/emails con un token bearer. Los nombres de los campos pasan de PascalCase a snake_case:

curl https://api.postmarkapp.com/email \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Server-Token: $POSTMARK_SERVER_TOKEN" \
  -d '{
    "From": "Acme <hello@acme.com>",
    "To": "ada@example.com",
    "Subject": "Your receipt",
    "TextBody": "Thanks for your order.",
    "HtmlBody": "<p>Thanks for your order.</p>",
    "MessageStream": "outbound"
  }'

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

Emailit no tiene endpoint de envío por lotes. Envía una petición por mensaje, cada una con hasta 50 destinatarios, y añade una cabecera Idempotency-Key para que los reintentos sean seguros. Consulta Enviar un email.

Cambiar la configuración SMTP

Emailit no lee las cabeceras X-PM-*, como X-PM-Message-Stream o X-PM-Tag. Elimínalas y configura el seguimiento en el dominio. Consulta Configuración SMTP.

Equivalencias de los eventos de webhook

Emailit también envía email.accepted cuando la API acepta un email, algo para lo que Postmark no tiene webhook.

El formato de las peticiones cambia:

• Postmark envía un registro por petición y lo identifica en RecordType. Emailit envía un array JSON de hasta 100 eventos, con el nombre en type y el email en data.object.
• Usa data.object.id, el ID em_ de la respuesta de envío, en lugar de MessageID. Tus valores de meta están en data.object.meta.
• Los webhooks de Postmark suelen protegerse con credenciales de autenticación básica en la URL. Emailit, en cambio, firma todas las peticiones: verifica X-Emailit-Signature con X-Emailit-Timestamp y tu secreto whsec_. 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

1. Exporta las suppressions de cada message stream de Postmark desde el que envías, desde la página de suppressions del stream o con la API de volcado de suppressions. Incluye los rebotes duros, las quejas por spam y los bloqueos manuales.

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

   CSV

   email,type,reason
   old-address@example.com,recipient,postmark hard bounce
   angry@example.com,recipient,postmark spam complaint

   Usa el tipo recipient para las direcciones que nunca deben recibir emails. Bloquea los envíos por API, por SMTP y de campañas. Para las personas que solo se dieron de baja de tus broadcasts, usa el tipo unsubscribe, que detiene las campañas pero sigue dejando pasar los emails transaccionales.

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.

Trasladar las plantillas

Copia el HTML de cada plantilla de Postmark, incluido su layout, y después impórtalo en Email Marketing›Templates o crea la plantilla con la API de plantillas. Emailit no tiene layouts, así que combina el layout y el contenido en una sola plantilla. Usa el mismo alias que usabas en Postmark para que los cambios en tu código sean mínimos.

Las plantillas de Postmark usan Mustachio. Temple cubre los valores simples y las condiciones:

Temple nunca escapa el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos. Un valor que falta se renderiza como una cadena vacía, salvo que añadas un valor por defecto, como {{name|"there"}}. Consulta Lenguaje de plantillas 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 de Postmark ni con su CNAME de return-path pm-bounces. Conserva tu registro DMARC. Después del cambio definitivo, elimina los registros de Postmark. Consulta Registros DNS de los dominios de envío.

Si procesas correo entrante con Postmark, trasládalo a un subdominio de entrada de Emailit y actualiza las direcciones que facilita tu aplicación. Consulta Configurar el email entrante.

Próximos pasos

• Lista de comprobación para pasar a producción
• Configurar un webhook
• Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo