Von Amazon SES migrieren

Diese Anleitung ordnet Konzepte, API-Aufrufe, Event-Benachrichtigungen, Sperrungen und Vorlagen von Amazon SES ihren Entsprechungen in Emailit zu. Lesen Sie zuerst Zu Emailit migrieren für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

Konzepte

API-Aufrufe anpassen

SES-Aufrufe werden mit Ihren AWS-Zugangsdaten signiert, daher erfolgen sie meist über ein AWS-SDK. Bei Emailit senden Sie eine JSON-Anfrage mit einem API-Schlüssel oder nutzen das Emailit-SDK für Ihre Sprache. 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 unterstützt außerdem Planung mit scheduled_at und sichere Wiederholungen mit einem Header Idempotency-Key, was SES beim Senden nicht bietet. Siehe E-Mail senden.

SMTP-Einstellungen umstellen

Emailit liest keine SES-Header wie X-SES-CONFIGURATION-SET. Entfernen Sie sie. Siehe SMTP-Einstellungen.

Event-Benachrichtigungen zuordnen

SES veröffentlicht Events über Konfigurationssätze an SNS, EventBridge oder Firehose. Emailit sendet sie als Webhooks direkt an Ihren HTTPS-Endpunkt, es gibt also kein Topic zu abonnieren oder zu bestätigen.

Auch der Payload ändert sich:

• Jede Anfrage von Emailit ist ein JSON-Array mit bis zu 100 Events, mit dem Namen in type und der E-Mail in data.object.
• Verwenden Sie data.object.id, die em_-ID aus der Antwort auf den Versand, statt der messageId von SES. Ihre meta-Werte stehen in data.object.meta.
• Statt SNS-Nachrichtensignaturen zu prüfen, verifizieren Sie X-Emailit-Signature anhand von X-Emailit-Timestamp und Ihrem whsec_-Secret. Siehe Anfragesignatur.

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

Sperrungen umziehen

1. Exportieren Sie die Sperrliste auf Kontoebene von SES mit der AWS CLI. Enthält die Ausgabe ein NextToken, wiederholen Sie den Befehl mit --next-token, bis Sie alle Seiten haben.

   Terminal

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

   Das schreibt eine CSV-Datei mit den Spalten email,type,reason. Jede Zeile verwendet den Typ recipient, der Versände per API, SMTP und Kampagne an die Adresse blockiert.

2. Wenn Sie eine eigene Liste von Bounces und Beschwerden aus SNS-Benachrichtigungen führen, fügen Sie diese Adressen ebenfalls hinzu.

3. Wählen Sie unter Email API›Suppressions die Option Import und laden Sie die Datei hoch. Jede Datei darf bis zu 10.000 Zeilen haben und höchstens 8 MB groß sein. Duplikate werden übersprungen.

Siehe Sperrungen verwalten.

Vorlagen umziehen

Holen Sie jede Vorlage mit aws sesv2 get-email-template --template-name <name> ab und importieren Sie dann ihr HTML unter Email Marketing›Templates oder erstellen Sie sie mit der Vorlagen-API. Verwenden Sie den SES-Vorlagennamen als Alias in Emailit, sofern er dem Alias-Format aus Kleinbuchstaben, Ziffern, - und _ entspricht.

SES-Vorlagen verwenden Tags im Handlebars-Stil. Temple deckt die üblichen Teile ab:

Temple maskiert HTML nie. Maskieren Sie Benutzereingaben daher, bevor Sie sie übergeben. Siehe Temple.

DNS ändern

Fügen Sie Ihre Domain unter Email API›Domains hinzu und legen Sie die Einträge von Emailit an. Sie verwenden eigene Namen (emailit._domainkey, emailit.<domain> und optional go und inbound) und kollidieren daher nicht mit den Easy-DKIM-CNAMEs von SES oder einer eigenen MAIL-FROM-Subdomain. Behalten Sie Ihren DMARC-Eintrag. Siehe DNS-Einträge.

Entfernen Sie nach der Umstellung die DKIM-CNAMEs von SES und die Einträge der eigenen MAIL-FROM-Domain und löschen Sie die Identitäten in SES. Wenn Sie E-Mails mit SES-Empfangsregeln empfangen, verlagern Sie das zuerst auf eine Inbound-Subdomain von Emailit.

Nächste Schritte

• Go-live-Checkliste
• Webhook einrichten
• Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen