Přechod ze SendGridu

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

Z POST /v3/mail/send v SendGridu se stane POST /v2/emails. Požadavek je plošší: nemá personalizations a adresy jsou prosté řetězce.

curl https://api.sendgrid.com/v3/mail/send \
  -H "Authorization: Bearer $SENDGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "personalizations": [{ "to": [{ "email": "ada@example.com" }] }],
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "subject": "Your receipt",
    "content": [
      { "type": "text/plain", "value": "Thanks for your order." },
      { "type": "text/html", "value": "<p>Thanks for your order.</p>" }
    ]
  }'

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>"
  }'

Každý příjemce v požadavku Emailitu se stane samostatným e-mailem s vlastním ID. Pokud chcete různým lidem poslat různé proměnné, což SendGrid řeší několika personalizations, odešlete pro každého příjemce samostatný požadavek. 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čku X-SMTPAPI. Odstraňte ji a měření místo toho nastavte na doméně. Viz Nastavení SMTP.

Namapujte události webhooků

Stejně jako SendGrid posílá Emailit pole JSON s událostmi. Liší se pole:

• Název události je v type a e-mail v data.object. Místo sg_message_id používejte data.object.id (ID em_ z odpovědi na odeslání) a místo email používejte data.object.to.
• Vaše hodnoty meta se vracejí v data.object.meta.
• Emailit podepisuje požadavky pomocí HMAC-SHA256 místo veřejného klíče ECDSA, který používá SendGrid. Ověřujte X-Emailit-Signature svým tajným klíčem 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. V SendGridu vyexportujte Bounces, Spam Reports, Invalid Emails a Global Unsubscribes, ze stránek suppressions nebo přes endpointy API /v3/suppression/*. Blocks jsou obvykle dočasné, takže je můžete vynechat.

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

   CSV

   email,type,reason
   old-address@example.com,recipient,sendgrid bounce
   angry@example.com,recipient,sendgrid spam report

   Pro adresy, které nikdy nesmí dostat e-mail, použijte typ recipient. Blokuje odeslání přes API, SMTP i kampaně. Typy bounce, complaint a unsubscribe zastavují jen kampaně.

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, takže větší seznamy rozdělte. Duplicity se přeskočí.

Lidi odhlášené přes group unsubscribes z marketingových e-mailů naimportujte jako kontakty s nastaveným unsubscribed, místo abyste je blokovali pro veškerou poštu. Viz Správa blokovaných adres.

Přesuňte šablony

Vyexportujte HTML každé dynamic template ze SendGridu a pak ho naimportujte v Email Marketing›Templates, nebo šablonu vytvořte přes API pro šablony. Dejte každé šabloně alias, například receipt, a odesílejte ji s "template": "receipt".

Oba jazyky používají dvojité složené závorky, ale Temple je menší než Handlebars:

Viz Temple a Import a export šablon.

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 domain authentication ani link branding ze SendGridu. Záznam DMARC ponechte. Po přepnutí provozu CNAME záznamy SendGridu odstraňte. Viz DNS záznamy odesílacích domén.

Pokud jste používali Inbound Parse, nasměrujte místo toho MX záznam svého názvu pro parse na Emailit. Pokud chcete ponechat stejný název, například parse.acme.com, nastavte přes API inbound_key domény na parse. 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