Migrar desde Amazon SES

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

Actualizar las llamadas a la API

Las llamadas a SES se firman con tus credenciales de AWS, así que normalmente las haces con un SDK de AWS. Con Emailit, envías una petición JSON con una clave de API, o usas el SDK de Emailit para tu lenguaje. En Node.js:

import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2';

const ses = new SESv2Client({ region: 'eu-west-1' });

await ses.send(new SendEmailCommand({
  FromEmailAddress: 'Acme <hello@acme.com>',
  Destination: { ToAddresses: ['ada@example.com'] },
  Content: {
    Simple: {
      Subject: { Data: 'Your receipt' },
      Body: {
        Text: { Data: 'Thanks for your order.' },
        Html: { Data: '<p>Thanks for your order.</p>' },
      },
    },
  },
}));

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

await emailit.emails.send({
  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 también admite la programación con scheduled_at y los reintentos seguros con una cabecera Idempotency-Key, que SES no ofrece al enviar. Consulta Enviar un email.

Cambiar la configuración SMTP

Emailit no lee las cabeceras de SES, como X-SES-CONFIGURATION-SET. Elimínalas. Consulta Configuración SMTP.

Equivalencias de las notificaciones de eventos

SES publica los eventos a través de configuration sets en SNS, EventBridge o Firehose. Emailit los envía directamente a tu endpoint HTTPS como webhooks, así que no hay ningún tema al que suscribirse ni que confirmar.

El payload también cambia:

• Cada petición de Emailit es 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 del messageId de SES. Tus valores de meta están en data.object.meta.
• En lugar de comprobar las firmas de los mensajes de SNS, 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 la lista de suppressions de la cuenta de SES con la AWS CLI. Si la salida incluye un NextToken, repite el comando con --next-token hasta tener todas las páginas.

   Terminal

   aws sesv2 list-suppressed-destinations --output json \
     | jq -r '(["email","type","reason"] | @csv),
              (.SuppressedDestinationSummaries[] | [.EmailAddress, "recipient", ("ses " + .Reason)] | @csv)' \
     > suppressions.csv

   Esto genera un CSV con las columnas email,type,reason. Todas las filas usan el tipo recipient, que bloquea los envíos por API, por SMTP y de campañas a la dirección.

2. Si mantienes tu propia lista de rebotes y quejas a partir de las notificaciones de SNS, añade también esas direcciones.

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

Obtén cada plantilla con aws sesv2 get-email-template --template-name <name> y después importa su HTML en Email Marketing›Templates o crea la plantilla con la API de plantillas. Usa el nombre de la plantilla de SES como alias en Emailit, si se ajusta al formato de los alias: letras minúsculas, números, - y _.

Las plantillas de SES usan etiquetas al estilo de Handlebars. Temple cubre lo más habitual:

Temple nunca escapa el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos. 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 los CNAME de Easy DKIM de SES ni con un subdominio MAIL FROM personalizado. Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.

Después del cambio definitivo, elimina los CNAME de DKIM de SES y los registros del MAIL FROM personalizado, y elimina las identidades en SES. Si recibes correo con las receipt rules de SES, trasládalo antes a un subdominio de entrada de Emailit.

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