De Amazon SES a Postal, con SES por debajo

Antes de cambiar nada, enumera lo que tu sistema usa en SES. Cada elemento tiene un lugar en Postal. Las identidades de SES valen para una sola región, así que anota las regiones desde las que envías.

Añade el dominio en Dominios (o con POST /domains), elige la región y publica los registros que muestra Postal. Ella comprueba el DNS sola durante hasta 72 horas, muestra el estado de cada registro y explica qué está mal. El dominio puede seguir verificado en SES al mismo tiempo: los nombres de los registros son diferentes.

• Si tu Return-Path en SES ya se llama postal, elige otro nombre en Postal con custom_return_path, para no mezclar los registros.
• Para migrar poco a poco, usa un subdominio solo de correo, como mail.exemplo.com.br.
• Postal avisa por el webhook domain.updated cuando el dominio pasa a verified. Consulta Dominios y DNS.

Crea una clave de API (acceso total, o solo de envío y restringida al dominio) y cambia el SendEmail del SDK de AWS por POST /emails. La respuesta trae el id del correo electrónico, en lugar del MessageId.

- import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2'- - const ses = new SESv2Client({ region: 'us-east-1' })- await ses.send(new SendEmailCommand({-   FromEmailAddress: 'Aurora Cosméticos <[email protected]>',-   Destination: { ToAddresses: ['[email protected]'] },-   Content: { Simple: {-     Subject: { Data: 'Tu pedido salió para la entrega' },-     Body: { Html: { Data: '<p>El pedido #10482 está en camino.</p>' } },-   } },-   EmailTags: [{ Name: 'category', Value: 'shipping' }],- }))+ await fetch('https://api.postal.so/emails', {+   method: 'POST',+   headers: {+     Authorization: `Bearer ${process.env.POSTAL_API_KEY}`,+     'Content-Type': 'application/json',+   },+   body: JSON.stringify({+     from: 'Aurora Cosméticos <[email protected]>',+     to: ['[email protected]'],+     subject: 'Tu pedido salió para la entrega',+     html: '<p>El pedido #10482 está en camino.</p>',+     tags: [{ name: 'category', value: 'shipping' }],+   }),+ })

• Los errores llegan con el estado HTTP y un JSON {statusCode, name, message}. La cuota responde 429 y la pausa por reputación, 403 sending_paused.
• ¿Prefieres un SDK? Los de Postal (Node.js, PHP y Laravel) y el de Resend, apuntando a Postal, usan la misma API. Consulta SDKs y CLI y la referencia de correos.

Los sistemas que hablan SMTP, como WordPress, los ERP y las plataformas de tienda, cambian cuatro campos: servidor, puerto, usuario y contraseña. La contraseña deja de ser la contraseña SMTP derivada de una clave de IAM y pasa a ser una clave de API de Postal.

- MAIL_HOST=email-smtp.us-east-1.amazonaws.com- MAIL_PORT=587- MAIL_USERNAME=<usuario SMTP de SES>- MAIL_PASSWORD=<contraseña SMTP de SES>+ MAIL_HOST=smtp.postal.so+ MAIL_PORT=587+ MAIL_USERNAME=postal+ MAIL_PASSWORD=ps_sua_chave

• TLS es obligatorio en ambos. En Postal, la autenticación (AUTH PLAIN o AUTH LOGIN) viene siempre después de TLS.
• El SMTP de Postal no tiene etiquetas, programación ni plantillas: para eso, usa la API. Si tu sistema manda los encabezados X-SES-CONFIGURATION-SET o X-SES-MESSAGE-TAGS, quítalos, porque son de SES.
• Los envíos por SMTP siguen las mismas reglas de la API (dominio verificado, cuotas y supresión) y aparecen en Correos y Registros. Cada mensaje aceptado puede tener hasta 40 MB y 50 destinatarios. Consulta la guía de SMTP.

En SES, el camino de los eventos es tuyo: configuration set, destino de evento, tema de SNS y una suscripción que tu código debe recibir. En Postal registras una URL HTTPS en Webhooks y eliges los eventos. Cada entrega se firma con el signing_secret del endpoint y se repite si falla.

- const message = JSON.parse(body.Message)- if (message.eventType === 'Bounce') {-   const kind = message.bounce.bounceType-   const id = message.mail.messageId- }+ const event = resend.webhooks.verify({ payload: rawBody, headers, webhookSecret })+ if (event.type === 'email.bounced') {+   const kind = event.data.bounce.type+   const id = event.data.email_id+ }

• El identificador que guardas pasa a ser el id devuelto por POST /emails (data.email_id en el webhook), y no el MessageId de SES.
• Las etiquetas vuelven en data.tags como objeto, por ejemplo {"category": "shipping"}.
• Postal tiene además eventos que SES no tiene, como email.scheduled, email.suppressed, email.received y domain.updated.
• Cualquier respuesta 2xx confirma la entrega. Quita el tema de SNS solo después de pasar todo el tráfico, porque los correos electrónicos que aún salen por SES siguen generando eventos allí. Consulta Webhooks.

Quien ya tuvo un rebote permanente o se quejó en SES no debe recibir de nuevo. Exporta la lista de supresión de tu cuenta e impórtala en Postal antes del primer envío y antes de importar contactos, porque una dirección suprimida nunca se convierte en contacto.

aws sesv2 list-suppressed-destinations --region us-east-1 > supressoes-ses.json
# se a resposta trouxer "NextToken", repita com --next-token "<valor>"

jq -r '.SuppressedDestinationSummaries[].EmailAddress' supressoes-ses.json \
  | tr 'A-Z' 'a-z' | sort -u > emails.txt

import { readFileSync } from 'node:fs'

const emails = readFileSync('emails.txt', 'utf8').split('\n').filter(Boolean)
const headers = {
  Authorization: `Bearer ${process.env.POSTAL_API_KEY}`,
  'Content-Type': 'application/json',
}

for (let i = 0; i < emails.length; i += 100) {
  const res = await fetch('https://api.postal.so/suppressions/batch/add', {
    method: 'POST',
    headers,
    body: JSON.stringify({ emails: emails.slice(i, i + 100) }),
  })
  if (!res.ok) throw new Error(await res.text())
  await new Promise((resolve) => setTimeout(resolve, 250)) // respeita o limite do plano
}

• La lista de SES vale para la cuenta y para la región. Expórtala una vez por cada región en la que enviabas. En la consola, está en Configuration > Suppression list.
• SES guarda la dirección exactamente como entró, con mayúsculas y minúsculas. Postal compara sin distinguir, así que el comando de arriba pasa todo a minúsculas y quita los repetidos.
• En Postal, las direcciones entran con el origen manual: la diferencia entre BOUNCE y COMPLAINT de SES no se guarda.
• Necesita una clave de acceso total. Para pocas direcciones, el panel acepta una por vez en Supresiones. Consulta la referencia de supresiones.

Pasa un flujo a la vez. Empieza por las direcciones de prueba y por ti mismo, sigue en Correos y Registros y solo entonces pasa el resto. Mantén SES activo hasta que lleguen los eventos de los últimos correos electrónicos antiguos.

• Las direcciones de prueba (delivered@, bounced@, complained@, suppressed@ y [email protected]) no usan la cuota ni pesan en la reputación. Dependen del plan.
• Consulta los valores actuales en Precios y en Límites.