# Přechod z Elastic Emailu

> Přejděte z Elastic Emailu na Emailit. Namapujte volání API v4 a v2, přístupové údaje k SMTP a oznámení, převeďte slučovací pole a přesuňte blokované adresy, kontakty a kampaně.

Tento průvodce mapuje pojmy, volání API, oznámení, blokované adresy, šablony a kontakty z Elastic Emailu na jejich ekvivalenty v Emailitu. 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

| Elastic Email | Emailit |
| --- | --- |
| Účet a subaccounts | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| API keys s úrovněmi přístupu | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| SMTP credentials | Váš API klíč použitý jako heslo k SMTP |
| Ověřené domény a ověřené adresy odesílatelů | [Odesílací domény](/cs/docs/domains/). Jednotlivé adresy odesílatelů nejsou dostupné. |
| Channels a postback values | `meta` |
| Templates, na které se odkazuje názvem | [Šablony](/cs/docs/templates/) s aliasem a verzemi |
| Merge fields a template scripting | [Temple](/cs/docs/templates/temple/): proměnné, výchozí hodnoty a podmínky |
| HTTP web notifications | [Webhooky](/cs/docs/webhooks/) |
| Inbound routes | [Příchozí e-maily](/cs/docs/inbound/) |
| Suppressions a blokující stavy kontaktů | [Blokované adresy](/cs/docs/suppressions/) |
| Contacts a lists | [Kontakty](/cs/docs/contacts/) a [seznamy kontaktů](/cs/docs/audiences/) |
| Segments | V každé kampani vyberte zahrnuté a vyloučené seznamy kontaktů. [Segmenty](/cs/docs/segments/) jsou v alfaverzi a otevřené jen týmu Emailitu. |
| Campaigns a automations | [Kampaně](/cs/docs/campaigns/) a [automatizace](/cs/docs/automations/) (betaverze) |
| Forms | [Formuláře](/cs/docs/forms/) (předběžný přístup), nebo [URL pro přihlášení](/cs/docs/audiences/subscribe-url/) seznamu kontaktů |
| Email verification | [Ověřování e-mailů](/cs/docs/email-verification/) |
| Private IPs a IP pools | [Dedikované IP adresy](/cs/docs/deliverability/dedicated-ips/) na vyžádání |

Elastic Email přidává odkaz pro odhlášení do každého e-mailu, včetně e-mailů odeslaných přes API a SMTP. Emailit přidává hlavičky `List-Unsubscribe` jen do [kampaní](/cs/docs/campaigns/) a do marketingových e-mailů z automatizací a viditelný odkaz přidáte sami pomocí `{{unsubscribe_url}}`. Pokud přes API nebo SMTP odesíláte newslettery nebo jinou hromadnou poštu, přidejte vlastní odkaz a hlavičky `List-Unsubscribe`. Viz [Hlavičky a metadata](/cs/docs/email-api/headers-and-metadata/#add-list-unsubscribe-to-bulk-mail).

## Upravte volání API

Z `POST /v4/emails/transactional` v Elastic Emailu se stane `POST /v2/emails`. Tělo je ploché, názvy polí jsou malými písmeny a klíč se přesune do hlavičky `Authorization`:

```bash title="Před: Elastic Email"
curl https://api.elasticemail.com/v4/emails/transactional \
  -H "X-ElasticEmail-ApiKey: $ELASTICEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Recipients": { "To": ["ada@example.com"] },
    "Content": {
      "From": "Acme <hello@acme.com>",
      "Subject": "Your receipt",
      "Body": [
        { "ContentType": "HTML", "Content": "<p>Thanks for your order.</p>" },
        { "ContentType": "PlainText", "Content": "Thanks for your order." }
      ]
    }
  }'
```

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

| Elastic Email (API v4) | Emailit |
| --- | --- |
| Hlavička `X-ElasticEmail-ApiKey` | `Authorization: Bearer secret_…` |
| `Content.From` | `from` |
| `Recipients.To`, `CC`, `BCC` | `to`, `cc`, `bcc`, každé až 50 |
| `Content.ReplyTo` | `reply_to` |
| `Content.Subject` | `subject` |
| `Content.Body[]` s `ContentType` `HTML` a `PlainText` | `html` a `text` |
| `Content.Headers` | `headers` |
| `Content.Attachments[]` s `BinaryContent`, `Name`, `ContentType` | `attachments[]` s `content`, `filename`, `content_type` |
| `Content.AttachFiles` (dříve nahrané soubory) | `attachments[]` s `url`, odkud Emailit soubor stáhne |
| `Content.TemplateName` | `template`, alias nebo ID šablony |
| `Content.Merge` | `variables` |
| `Options.ChannelName`, `Content.Postback` | `meta`, vrací se v událostech webhooků |
| `Options.TrackOpens`, `Options.TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `Options.TimeOffset` (minuty) | `scheduled_at` (ISO 8601 nebo běžná angličtina) |
| `Options.PoolName` | Není potřeba. Dedikovaná IP adresa odesílá všechny e-maily svého workspace. |
| `Content.Utm` | Přidejte do svých odkazů UTM parametry. Kampaně je přidávají za vás. |
| `POST /v4/emails` s `Recipients[].Fields` (hromadné slučování) | Jeden požadavek na příjemce, každý s vlastními `variables` |
| Hlavička `Idempotency-Key` | Hlavička `Idempotency-Key`, uchovává se 24 hodin |
| Odpověď s `TransactionID` a `MessageID` | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

Pokud stále používáte API v2 (`/v2/email/send` s parametrem `apikey`), namapujte jeho pole formuláře stejně: z `from` a `fromName` se stane `from`, z `bodyHtml` a `bodyText` se stanou `html` a `text`, z polí `merge_*` se stanou `variables` a z `template` se stane `template`. Ve v2 dostane každá adresa v `to` samostatnou zprávu, podobně jako u skryté kopie. V Emailitu se příjemci z `to` navzájem vidí v hlavičce `To`, proto pro každého příjemce odešlete samostatný požadavek, aby zůstali oddělení. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Změňte nastavení SMTP

| Nastavení | Elastic Email | Emailit |
| --- | --- | --- |
| Server | `smtp.elasticemail.com` | `smtp.emailit.com` |
| Port | `2525`, `587` nebo `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | Název přístupových údajů SMTP, e-mailová adresa | `emailit` |
| Heslo | Token přístupových údajů SMTP | Váš API klíč Emailitu |

Emailit nečte řídicí hlavičky Elastic Emailu, například `X-ElasticEmail-Channel`, `X-ElasticEmail-Postback`, `IsTransactional`, `trackopens` nebo `trackclicks`. Odstraňte je a měření místo toho nastavte na doméně. Viz [Nastavení SMTP](/cs/docs/smtp/settings/).

## Namapujte události webhooků

| Oznámení Elastic Emailu | Událost Emailitu |
| --- | --- |
| `Sent` (server příjemce zprávu přijal) | `email.delivered` |
| `Opened` | `email.loaded` |
| `Clicked` | `email.clicked` |
| `Error` | `email.bounced` u trvalých selhání. Při dočasných selháních se posílá `email.attempted`, dokud Emailit opakuje doručení. |
| `AbuseReport` | `email.complained` |
| `Unsubscribed` | `email.unsubscribed`, jen u e-mailů z kampaní |
| Inbound route, která posílá oznámení na URL | `email.received`, pak načtěte obsah přes [`GET /emails/{id}`](/cs/docs/api-reference/emails/get/) |

Emailit navíc posílá `email.accepted`, když API e-mail přijme, a `email.suppressed`, když blokace typu `recipient` zablokuje adresu. Viz [Typy událostí](/cs/docs/webhooks/event-types/).

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

- Elastic Email posílá jednu událost na požadavek, v parametrech dotazu nebo jako plochý objekt JSON. Emailit posílá pole JSON s až 100 událostmi, proto tělo procházejte ve smyčce.
- Název události se přesune ze `status` do `type` a e-mail je v `data.object`. Místo `messageid` používejte `data.object.id`, ID `em_` z odpovědi na odeslání, a místo `to` používejte `data.object.to`. Vaše hodnoty `meta`, které nahrazují `channel` a `postback`, 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`.
- Emailit podepisuje každý požadavek. Ověřujte `X-Emailit-Signature`, hexadecimální HMAC-SHA256 z `<timestamp>.<raw body>`, vůči `X-Emailit-Timestamp` a vašemu tajnému klíči `whsec_`. Volitelné podepisování Elastic Emailu také používá tajné klíče `whsec_`, ale podepisuje jiný řetězec, proto upravte svůj ověřovací kód. 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 adresy, které Elastic Email blokuje, ze stránky **Suppressions** v ovládacím panelu nebo přes API (`/v4/suppressions/bounces`, `/complaints` a `/unsubscribes`).

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

   | Stav v Elastic Emailu | Typ v Emailitu |
   | --- | --- |
   | Invalid (`Bounced`) | `recipient` |
   | Complaint (`Abuse`) | `recipient` |
   | Unsubscribed | `unsubscribe`, který zastaví kampaně, ale transakční e-maily propustí. Pokud chcete blokovat všechny e-maily, použijte `recipient`. |

```csv
email,type,reason
old-address@example.com,recipient,elastic email bounced
left@example.com,unsubscribe,elastic email unsubscribed
```

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](/cs/docs/suppressions/manage/).

## Přesuňte kontakty a kampaně

Vyexportujte kontakty z **Contacts** (vyberte je a pak **More actions > Export**) nebo přes `POST /v4/contacts/export` a vyexportujte každý seznam, kterému posíláte kampaně. Pak je přeneste podle stavu:

| Stav v Elastic Emailu | Kam patří |
| --- | --- |
| Engaged, Active | Naimportujte je přes **Import** do odpovídajícího seznamu kontaktů v **Email Marketing → Contacts**. |
| Transactional | Do seznamů kontaktů je nezařazujte. K odběru vašich marketingových e-mailů se nikdy nepřihlásili. |
| Invalid, Complaint, Unsubscribed | Na seznam blokovaných adres, jak je popsáno výše. |
| Inactive, Stale, Not Confirmed | Vynechte je. |

Před importem vytvořte [vlastní pole](/cs/docs/contacts/custom-fields/) pro pole svých kontaktů a soubory rozdělte na části nejvýše po 2 500 řádcích. Import přidá všechny lidi v souboru jako přihlášené odběratele, proto importujte jen ty, kteří mají dostávat vaše kampaně. Viz [Import a export kontaktů](/cs/docs/contacts/import-export/).

Kampaně a automatizace znovu vytvořte v **Email Marketing → Campaigns** a **Automations** a vyjděte přitom z naimportovaných šablon.

## Přesuňte šablony

Zkopírujte HTML každé šablony přes **Edit as HTML** v Elastic Emailu, nebo ho načtěte přes `GET /v4/templates/{name}`, který ho vrací v `Body`. Naimportujte ho v **Email Marketing → Templates**, nebo šablonu vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/), a jako alias použijte název šablony, pokud odpovídá formátu aliasu: malá písmena, číslice, `-` a `_`.

Slučovací pole Elastic Emailu používají jednoduché složené závorky, Temple dvojité. Pole s jednoduchými závorkami, která v šabloně zůstanou, se odešlou jako prostý text, proto je převeďte všechna:

| Elastic Email | Emailit (Temple) |
| --- | --- |
| `{firstname}`, `{lastname}`, `{email}` | `{{first_name}}`, `{{last_name}}`, `{{email}}` v kampaních. Při odesílání přes API názvy, které předáte ve `variables`. |
| `{firstname:friend}` | `{{first_name\|"friend"}}` |
| `{company}` nebo jiné vlastní pole | `{{cf.company}}` v kampaních |
| `{unsubscribe}` | `{{unsubscribe_url}}` v kampaních |
| `{contactprofile}` | `{{manage_subscriptions_url}}` v kampaních |
| `{view}` | `{{webview_url}}` v kampaních |
| `{accountaddress}` a další pole účtu | Napište je přímo do šablony, nebo je uložte jako [globální hodnoty](/cs/docs/contacts/global-values/) |
| Template scripting v `{{ … }}` | Nepodporuje se. Hodnoty vypočítejte ve svém kódu a pro podmíněný obsah použijte `{{#if}}`. |

Viz [Slučovací značky](/cs/docs/campaigns/merge-tags/) a [Temple](/cs/docs/templates/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 Elastic Emailu `api._domainkey`, s jeho CNAME záznamem `tracking` ani s vlastní doménou pro zprávy o nedoručení. Záznam DMARC ponechte. Viz [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Po přepnutí provozu odstraňte záznamy Elastic Emailu pro DKIM a měření a ze záznamu SPF odeberte `include:_spf.elasticemail.com`. Pokud přijímáte poštu přes inbound routes v Elastic Emailu, přesuňte ji nejdřív na [příchozí subdoménu](/cs/docs/inbound/set-up/) Emailitu. Emailit přijímá na subdoméně, například `inbound.acme.com`, takže se přijímací adresy změní.

## 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/elastic-email/
