# Přechod ze SparkPostu

> Přejděte ze SparkPostu (dnes Bird Email) na Emailit. Převeďte transmissions a substitution data, vyměňte nastavení SMTP_Injection a přesuňte event webhooks, blokované adresy, šablony a DNS.

Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy a šablony ze SparkPostu na jejich ekvivalenty v Emailitu. SparkPost je dnes součástí společnosti Bird a prodává se jako Bird Email, API SparkPostu na `api.sparkpost.com` ale dál funguje. Tento průvodce popisuje toto API. Celkové pořadí a souběžný provoz obou poskytovatelů popisuje stránka [Přechod na Emailit](/cs/docs/migrate/), přečtěte si ji jako první.

## Principy

| SparkPost | Emailit |
| --- | --- |
| Primary account a subaccounts | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| Účty v USA a EU na samostatných hostitelích API | Jeden hostitel API, `api.emailit.com` |
| API keys s grants | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| Sending domains | [Odesílací domény](/cs/docs/domains/) |
| Bounce domains | Return path `emailit.<your domain>`, který má každá doména |
| Tracking domains | [Subdoména pro měření](/cs/docs/tracking/), například `go.acme.com` |
| Transmissions | [E-maily](/cs/docs/email-api/), jeden požadavek na zprávu |
| Stored recipient lists | [Seznamy kontaktů](/cs/docs/audiences/) a [kampaně](/cs/docs/campaigns/) |
| Templates a snippets | [Šablony](/cs/docs/templates/) s aliasem a verzemi. Snippets neexistují. |
| Event webhooks | [Webhooky](/cs/docs/webhooks/) |
| Inbound domains a relay webhooks | [Příchozí e-maily](/cs/docs/inbound/) |
| Suppression list | [Blokované adresy](/cs/docs/suppressions/) |
| `metadata`, `tags`, `campaign_id` | `meta` |
| `options.sandbox` | Testovací režim neexistuje. Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a doručují jen členům workspace. |
| IP pools | [Dedikované IP adresy](/cs/docs/deliverability/dedicated-ips/) na vyžádání |

## Upravte volání API

Z `POST /api/v1/transmissions` ve SparkPostu se stane `POST /v2/emails`. Obsah se přesune na nejvyšší úroveň a z příjemců se stanou `to`, `cc` a `bcc`:

```bash title="Před: SparkPost"
curl https://api.sparkpost.com/api/v1/transmissions \
  -H "Authorization: $SPARKPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": [{ "address": { "email": "ada@example.com" } }],
    "content": {
      "from": { "email": "hello@acme.com", "name": "Acme" },
      "subject": "Your receipt",
      "text": "Thanks for your order.",
      "html": "<p>Thanks for your order.</p>"
    }
  }'
```

```bash title="Po: Emailit"
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>"
  }'
```

| SparkPost | Emailit |
| --- | --- |
| `Authorization: ` bez `Bearer` | `Authorization: Bearer secret_…` |
| `content.from`, řetězec nebo `{ email, name }` | `from: "Name "` |
| `recipients[].address` | `to`, řetězec nebo pole až 50 adres |
| Kopie a skrytá kopie jako další příjemci s `header_to` a hlavičkou `CC` | `cc` a `bcc` |
| `content.reply_to` | `reply_to` |
| `content.subject`, `content.text`, `content.html` | `subject`, `text`, `html` |
| `content.headers` | `headers` |
| `content.attachments[]` s `name`, `type`, `data` | `attachments[]` s `filename`, `content_type`, `content` |
| `content.inline_images[]` | `attachments[]` s `content_id`, na které se v HTML odkazujete přes `cid:` |
| `content.template_id` | `template`: alias odešle publikovanou verzi a ID `tem_` odešle přesně tuto verzi, i když je to koncept |
| `substitution_data` | `variables` |
| `metadata`, `recipients[].tags`, `campaign_id` | `meta`, objekt s řetězcovými hodnotami, který se vrací v událostech webhooků |
| `options.open_tracking`, `options.click_tracking` | `tracking: { "loads": true, "clicks": true }` |
| `options.start_time` (nejvýše 3 dny dopředu) | `scheduled_at` (ISO 8601 nebo běžná angličtina) |
| `options.transactional` | Není potřeba. E-maily z API nikdy nedostanou hlavičky `List-Unsubscribe`, pokud je nepřidáte. |
| `content.email_rfc822` | Odešlete zprávu MIME přes [SMTP relay](/cs/docs/smtp/) |
| `recipients: { "list_id": "…" }` | [Kampaň](/cs/docs/campaigns/) pro seznam kontaktů |
| Hlavička `Idempotency-Key` | Hlavička `Idempotency-Key`, uchovává se 24 hodin |
| Odpověď s `id` transmission a počty příjemců | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

SparkPost posílá každému příjemci transmission samostatnou zprávu a nikdo nevidí ostatní adresy. V Emailitu se všichni v `to` a `cc` objeví v hlavičkách každé kopie. Pokud chcete příjemce oddělit, nebo každému dát vlastní `substitution_data`, odešlete pro každého příjemce samostatný požadavek. ID e-mailů dostanete hned a nemusíte hledat ID zpráv v pozdějších událostech. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Změňte nastavení SMTP

| Nastavení | SparkPost | Emailit |
| --- | --- | --- |
| Server | `smtp.sparkpostmail.com` nebo `smtp.eu.sparkpostmail.com` | `smtp.emailit.com` |
| Port | `587` nebo `2525` (STARTTLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | `SMTP_Injection` | `emailit` |
| Heslo | API klíč s oprávněním **Send via SMTP** | Váš API klíč Emailitu |

Emailit nečte hlavičku `X-MSYS-API`. Odstraňte ji. Adresy pro kopii a skrytou kopii uveďte ve zprávě jako běžné příjemce, měření nastavte na doméně, a když potřebujete metadata, použijte API. Viz [Nastavení SMTP](/cs/docs/smtp/settings/).

## Namapujte události webhooků

| Událost SparkPostu | Událost Emailitu |
| --- | --- |
| `injection` | `email.accepted` (jen API) |
| `delivery` | `email.delivered` |
| `delay` | `email.attempted` |
| `bounce`, `out_of_band` | `email.bounced` |
| `policy_rejection` | `email.suppressed`, když má adresa blokaci typu `recipient` |
| `generation_failure`, `generation_rejection` | Žádná událost. Problémy, například neznámá šablona, jsou chyby v odpovědi API. |
| `spam_complaint` | `email.complained` |
| `open`, `initial_open` | `email.loaded` |
| `click` | `email.clicked` |
| `list_unsubscribe`, `link_unsubscribe` | `email.unsubscribed`, jen u e-mailů z kampaní |
| Relay webhook | `email.received`, pak načtěte obsah přes [`GET /emails/{id}`](/cs/docs/api-reference/emails/get/) |

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

- Oba posílají pole JSON s událostmi. SparkPost každou událost obaluje do `msys` a třídy, například `message_event`. Emailit dává název do `type` a e-mail do `data.object`, s až 100 událostmi na požadavek.
- Místo `message_id` a `transmission_id` používejte `data.object.id`, ID `em_` z odpovědi na odeslání, a místo `rcpt_to` používejte `data.object.to`. Vaše hodnoty `meta`, které nahrazují `rcpt_meta` a `rcpt_tags`, jsou v `data.object.meta`.
- U událostí `email.loaded` a `email.clicked` je v `data.object` načtení nebo proklik. Jako ID e-mailu používejte `data.object.email_id` a pro příjemce a vaše hodnoty `meta` používejte `data.object.email.rcpt_to` a `data.object.email.meta`.
- SparkPost chrání webhooky základní autentizací nebo OAuth 2.0, bez podpisu. Emailit 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](/cs/docs/webhooks/request-signature/).

```javascript
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 suppression list přes `GET /api/v1/suppression-list?per_page=10000&cursor=initial` a pokračujte podle kurzoru, dokud nebudete mít všechny stránky. Obsahuje i záznamy vašich subaccounts, každý se svým `subaccount_id`.

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

   | Záznam ve SparkPostu | Typ v Emailitu |
   | --- | --- |
   | `transactional` nebo oba typy | `recipient`, který blokuje odeslání přes API, SMTP i kampaně |
   | Jen `non_transactional` | `unsubscribe`, který zastaví kampaně, ale transakční e-maily propustí |
   | `open_tracking` | Vynechte ho. Odesílání neblokuje. |

```csv
email,type,reason
old-address@example.com,recipient,sparkpost bounce rule
left@example.com,unsubscribe,sparkpost unsubscribe link
```

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čí.

Pokud jste používali subaccounts, rozdělte soubor podle subaccounts a každou část naimportujte do odpovídajícího workspace. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte šablony

Každou publikovanou šablonu načtěte přes `GET /api/v1/templates/{id}?draft=false`, které vrací `content.html`, `content.text` a `content.subject`. Naimportujte ji v **Email Marketing → Templates**, nebo ji vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/). Jako alias použijte ID šablony ze SparkPostu, pokud odpovídá formátu aliasu: malá písmena, číslice, `-` a `_`.

Převeďte šablonovací jazyk SparkPostu na Temple:

| SparkPost | Emailit (Temple) |
| --- | --- |
| `{{name}}`, `{{order.total}}` | Stejně |
| `{{address.name}}`, `{{address.email}}` (příjemce) | Předejte je ve `variables`, například jako `name` a `email` |
| `{{{html_block}}}` | `{{html_block}}`. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte sami. |
| `{{name or 'Customer'}}` | `{{name\|"Customer"}}` |
| `{{if plan}}…{{else}}…{{end}}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{{if plan == 'pro'}}`, `{{elseif}}`, `and`, `or` | Nepodporuje se. Předejte logickou hodnotu, například `is_pro`, a použijte `{{#if is_pro}}`. |
| `{{each items}}…{{end}}` | Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
| `render_snippet()`, `render_dynamic_content()` | Nepodporuje se. Vložte obsah do šablony, nebo ho předejte jako proměnnou. |
| `substitution_data` | `variables` |

Viz [Temple](/cs/docs/templates/temple/) a [Import a export šablon](/cs/docs/templates/import-export/).

## 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 SparkPostu (se selektorem například `scph0316._domainkey`), s jeho CNAME záznamem bounce domény ani s CNAME záznamem domény pro měření. Záznam DMARC ponechte. Viz [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Pokud doména pro měření nebo inbound doména ve SparkPostu už používá název `go` nebo `inbound`, zvolte pro Emailit jiné názvy pomocí `tracking_key` a `inbound_key`. Viz [Nastavení vlastní domény pro měření](/cs/docs/tracking/custom-tracking-domain/) a [Nastavení příchozích e-mailů](/cs/docs/inbound/set-up/).

Po přepnutí provozu odstraňte záznamy DKIM, bounce a měření SparkPostu. Pokud přijímáte poštu přes relay webhooks, přesuňte ji nejdřív na příchozí subdoménu Emailitu a pak odstraňte MX záznamy `rx1`, `rx2` a `rx3` SparkPostu.

## Další kroky

- [Kontrolní seznam před ostrým provozem](/cs/docs/get-started/go-live/)
- [Nastavení webhooku](/cs/docs/webhooks/set-up/)
- [Prioritní migrace](/cs/docs/programs/priority-migration/): nechte inženýry Emailitu provést přechod s vámi

---
Zdroj: https://emailit.com/cs/docs/migrate/sparkpost/
