Přechod z Amazon SES

Tento průvodce mapuje pojmy, volání API, oznámení o událostech, blokované adresy a šablony z Amazon SES na jejich ekvivalenty v Emailitu. Celkové pořadí a souběžný provoz obou poskytovatelů popisuje stránka Přechod na Emailit, přečtěte si ji jako první.

Principy

Upravte volání API

Volání SES se podepisují vašimi přístupovými údaji AWS, takže je obvykle provádíte přes AWS SDK. V Emailitu odešlete požadavek JSON s API klíčem, nebo použijete SDK Emailitu pro svůj jazyk. V 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 navíc podporuje plánování přes scheduled_at a bezpečné opakování požadavků s hlavičkou Idempotency-Key, což SES při odesílání nenabízí. Viz Odeslání e-mailu.

Změňte nastavení SMTP

Emailit nečte hlavičky SES, například X-SES-CONFIGURATION-SET. Odstraňte je. Viz Nastavení SMTP.

Namapujte oznámení o událostech

SES publikuje události přes configuration sets do SNS, EventBridge nebo Firehose. Emailit je posílá přímo na váš endpoint HTTPS jako webhooky, takže není potřeba odebírat ani potvrzovat žádné téma.

Mění se i obsah událostí:

• Každý požadavek Emailitu je pole JSON s až 100 událostmi, s názvem v type a e-mailem v data.object.
• Místo messageId ze SES používejte data.object.id, ID em_ z odpovědi na odeslání. Vaše hodnoty meta jsou v data.object.meta.
• Místo kontroly podpisů zpráv SNS ověřujte X-Emailit-Signature vůči X-Emailit-Timestamp a vašemu tajnému klíči whsec_. Viz Podpis požadavku.

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

Přesuňte blokované adresy

1. Vyexportujte account-level suppression list ze SES pomocí AWS CLI. Pokud výstup obsahuje NextToken, opakujte příkaz s --next-token, dokud nebudete mít všechny stránky.

   Terminal

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

   Tím vznikne CSV se sloupci email,type,reason. Každý řádek používá typ recipient, který blokuje odeslání přes API, SMTP i kampaně na danou adresu.

2. Pokud si vedete vlastní seznam nedoručení a stížností z oznámení SNS, přidejte i tyto adresy.

3. V Email API›Suppressions vyberte Import a nahrajte soubor. Každý soubor může mít až 10 000 řádků a nejvýše 8 MB. Duplicity se přeskočí.

Viz Správa blokovaných adres.

Přesuňte šablony

Každou šablonu načtěte příkazem aws sesv2 get-email-template --template-name <name> a pak naimportujte její HTML v Email Marketing›Templates, nebo ji vytvořte přes API pro šablony. Jako alias v Emailitu použijte název šablony ze SES, pokud odpovídá formátu aliasu: malá písmena, číslice, - a _.

Šablony SES používají značky ve stylu Handlebars. Temple pokrývá běžné části:

Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte dřív, než je předáte. Viz Temple.

Změňte DNS

Přidejte doménu v Email API›Domains a publikujte záznamy Emailitu. Používají vlastní názvy (emailit._domainkey, emailit.<domain> a volitelně go a inbound), takže nejsou v konfliktu s CNAME záznamy Easy DKIM ze SES ani se subdoménou custom MAIL FROM. Záznam DMARC ponechte. Viz DNS záznamy odesílacích domén.

Po přepnutí provozu odstraňte CNAME záznamy DKIM ze SES a záznamy custom MAIL FROM a smažte identity v SES. Pokud přijímáte poštu přes receipt rules v SES, přesuňte ji nejdřív na příchozí subdoménu Emailitu.

Další kroky

• Kontrolní seznam před ostrým provozem
• Nastavení webhooku
• Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi