Přechod z Postmarku

Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy a šablony z Postmarku 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

Pokud chcete oddělit reputaci transakční a marketingové pošty, odesílejte je z různých domén nebo subdomén, například mail.acme.com pro účtenky a news.acme.com pro newslettery.

Upravte volání API

Z POST /email s X-Postmark-Server-Token v Postmarku se stane POST /v2/emails s bearer tokenem. Názvy polí se mění z PascalCase na snake_case:

curl https://api.postmarkapp.com/email \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Server-Token: $POSTMARK_SERVER_TOKEN" \
  -d '{
    "From": "Acme <hello@acme.com>",
    "To": "ada@example.com",
    "Subject": "Your receipt",
    "TextBody": "Thanks for your order.",
    "HtmlBody": "<p>Thanks for your order.</p>",
    "MessageStream": "outbound"
  }'

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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 nemá endpoint pro dávky. Odešlete jeden požadavek na zprávu, každý až s 50 příjemci, a přidejte hlavičku Idempotency-Key, aby bylo opakování bezpečné. Viz Odeslání e-mailu.

Změňte nastavení SMTP

Emailit nečte hlavičky X-PM-*, například X-PM-Message-Stream nebo X-PM-Tag. Odstraňte je a měření místo toho nastavte na doméně. Viz Nastavení SMTP.

Namapujte události webhooků

Emailit navíc posílá email.accepted, když API e-mail přijme, pro což Postmark žádný webhook nemá.

Mění se formát požadavku:

• Postmark posílá jeden záznam na požadavek a jeho typ uvádí v RecordType. Emailit posílá pole JSON s až 100 událostmi, s názvem v type a e-mailem v data.object.
• Místo MessageID používejte data.object.id, ID em_ z odpovědi na odeslání. Vaše hodnoty meta jsou v data.object.meta.
• Webhooky Postmarku se obvykle chrání přístupovými údaji pro základní autentizaci v URL. Emailit místo toho podepisuje každý požadavek: 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 suppressions každého message streamu v Postmarku, ze kterého odesíláte, ze stránky suppressions daného streamu nebo přes suppressions dump API. Zahrňte hard bounces, spam complaints i ruční blokace.

2. Sestavte jedno CSV se sloupci email,type,reason:

   CSV

   email,type,reason
   old-address@example.com,recipient,postmark hard bounce
   angry@example.com,recipient,postmark spam complaint

   Pro adresy, které nikdy nesmí dostat e-mail, použijte typ recipient. Blokuje odeslání přes API, SMTP i kampaně. Pro lidi, kteří se odhlásili jen z vašich rozesílek, použijte typ unsubscribe, který zastaví kampaně, ale transakční e-maily propustí.

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

Zkopírujte HTML každé šablony z Postmarku včetně jejího layoutu a pak ho naimportujte v Email Marketing›Templates, nebo šablonu vytvořte přes API pro šablony. Emailit layouty nemá, proto layout a obsah slučte do jedné šablony. Použijte stejný alias jako v Postmarku, aby změny v kódu zůstaly malé.

Šablony Postmarku používají Mustachio. Temple pokrývá jednoduché hodnoty a podmínky:

Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte dřív, než je předáte. Chybějící hodnota se vykreslí jako prázdný řetězec, pokud nepřidáte výchozí hodnotu, například {{name|"there"}}. 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 se záznamem DKIM Postmarku ani s jeho CNAME záznamem return path pm-bounces. Záznam DMARC ponechte. Po přepnutí provozu záznamy Postmarku odstraňte. Viz DNS záznamy odesílacích domén.

Pokud zpracováváte příchozí poštu přes Postmark, přesuňte ji na příchozí subdoménu Emailitu a aktualizujte adresy, které vaše aplikace rozdává. Viz Nastavení příchozích e-mailů.

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