Migra da Amazon SES

Questa guida fa corrispondere concetti, chiamate API, notifiche di eventi, soppressioni e template di Amazon SES ai loro equivalenti in Emailit. Leggi prima Passa a Emailit per l’ordine generale e per sapere come usare entrambi i provider in parallelo.

Concetti

Aggiorna le chiamate API

Le chiamate SES sono firmate con le tue credenziali AWS, quindi di solito le fai tramite un SDK AWS. Con Emailit invii una richiesta JSON con una chiave API, oppure usi l’SDK di Emailit per il tuo linguaggio. In 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 supporta anche la programmazione con scheduled_at e i nuovi tentativi sicuri con un header Idempotency-Key, che SES non offre per l’invio. Vedi Invia un’email.

Cambia le impostazioni SMTP

Emailit non legge gli header di SES come X-SES-CONFIGURATION-SET. Rimuovili. Vedi Impostazioni SMTP.

Fai corrispondere le notifiche di eventi

SES pubblica gli eventi tramite i configuration sets su SNS, EventBridge o Firehose. Emailit li invia direttamente al tuo endpoint HTTPS come webhook, quindi non c’è nessun topic da sottoscrivere o confermare.

Cambia anche il payload:

• Ogni richiesta di Emailit è un array JSON di massimo 100 eventi, con il nome in type e l’email in data.object.
• Usa data.object.id, l’ID em_ della risposta all’invio, al posto del messageId di SES. I tuoi valori meta sono in data.object.meta.
• Invece di controllare le firme dei messaggi SNS, verifica X-Emailit-Signature rispetto a X-Emailit-Timestamp e al tuo secret whsec_. Vedi Verifica le firme dei webhook.

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);
}

Sposta le soppressioni

1. Esporta l’account-level suppression list di SES con la AWS CLI. Se l’output include un NextToken, ripeti il comando con --next-token finché non hai tutte le pagine.

   Terminal

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

   Questo comando scrive un CSV con le colonne email,type,reason. Ogni riga usa il tipo recipient, che blocca gli invii via API, SMTP e campagne all’indirizzo.

2. Se tieni una tua lista di bounce e segnalazioni ricavata dalle notifiche SNS, aggiungi anche quegli indirizzi.

3. In Email API›Suppressions, seleziona Import e carica il file. Ogni file può avere fino a 10.000 righe e pesare al massimo 8 MB. I duplicati vengono saltati.

Vedi Gestisci le soppressioni.

Sposta i template

Recupera ogni template con aws sesv2 get-email-template --template-name <name>, poi importa il suo HTML in Email Marketing›Templates o crealo con l’API dei template. Usa il nome del template SES come alias in Emailit, se rispetta il formato degli alias: lettere minuscole, numeri, - e _.

I template SES usano tag in stile Handlebars. Temple copre le parti più comuni:

Temple non applica mai l’escape all’HTML, quindi esegui l’escape dell’input degli utenti prima di passarlo. Vedi Temple.

Cambia i DNS

Aggiungi il dominio in Email API›Domains e pubblica i record di Emailit. Usano nomi propri (emailit._domainkey, emailit.<domain> e, facoltativamente, go e inbound), quindi non entrano in conflitto con i CNAME di Easy DKIM di SES né con un sottodominio Custom MAIL FROM. Mantieni il record DMARC. Vedi Record DNS.

Dopo il passaggio, rimuovi i CNAME DKIM di SES e i record Custom MAIL FROM, ed elimina le identità in SES. Se ricevi posta con le receipt rules di SES, spostala prima su un sottodominio di ricezione di Emailit.

Passaggi successivi

• Checklist per andare in produzione
• Configura un webhook
• Migrazione prioritaria: lascia che i tecnici di Emailit facciano la migrazione insieme a te