# Přechod z Mandrillu

> Přejděte z Mandrillu (Mailchimp Transactional) na Emailit. Namapujte API klíče a subaccounts, převeďte volání messages/send, vyměňte nastavení SMTP a hlavičky X-MC, ověřujte webhooky a přesuňte rejection denylist.

Tento průvodce mapuje pojmy, volání API, webhooky, rejection denylist a šablony z Mandrillu (Mailchimp Transactional Email) 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í. Pokud z Mailchimpu posíláte i kampaně, viz [Přechod z Mailchimpu](/cs/docs/migrate/mailchimp/).

## Principy

| Mandrill | Emailit |
| --- | --- |
| Tarif Mailchimpu Standard nebo Premium s bloky transakčních e-mailů | Účet v Emailitu. K odesílání transakčních e-mailů nepotřebujete marketingový tarif. |
| Subaccounts | [Workspace](/cs/docs/workspaces/), každý s vlastními doménami, klíči, limity a kredity |
| API keys | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| Test API keys | Testovací režim neexistuje. Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a mohou odesílat jen členům workspace. |
| Sending domains a ověření DKIM/SPF | [Odesílací domény](/cs/docs/domains/) |
| Tracking domains | [Subdoména pro měření](/cs/docs/tracking/), například `go.acme.com` |
| Templates s oblastmi `mc:edit` | [Šablony](/cs/docs/templates/) s aliasem a verzemi vykreslované jazykem [Temple](/cs/docs/templates/temple/) |
| Webhooks | [Webhooky](/cs/docs/webhooks/) |
| Inbound domains a routes | [Příchozí e-maily](/cs/docs/inbound/) |
| Rejection denylist | [Blokované adresy](/cs/docs/suppressions/) |
| Rejection allowlist | Není dostupné |
| Merge languages: Mailchimp a Handlebars | [Temple](/cs/docs/templates/temple/) |
| Tags a metadata | `meta` |
| Outbound activity | **Email API → Emails** a **Email API → Logs** |
| Dedicated IPs a IP pools | [Dedikované IP adresy](/cs/docs/deliverability/dedicated-ips/) na vyžádání |

## Upravte volání API

`POST /messages/send` v Mandrillu přijímá API klíč v těle JSON a e-mail vnořuje do `message`. `POST /v2/emails` v Emailitu přijímá bearer token a ploché tělo:

```bash title="Před: Mandrill"
curl https://mandrillapp.com/api/1.0/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "key": "'"$MANDRILL_API_KEY"'",
    "message": {
      "from_email": "hello@acme.com",
      "from_name": "Acme",
      "to": [{ "email": "ada@example.com", "type": "to" }],
      "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>"
  }'
```

| Mandrill | Emailit |
| --- | --- |
| `key` v těle požadavku | Hlavička `Authorization: Bearer secret_…` |
| `message.from_email` a `from_name` | `from: "Name "` |
| `message.to[]` s `type` `to`, `cc` nebo `bcc` | `to`, `cc`, `bcc`, každé až 50 |
| `message.headers["Reply-To"]` | `reply_to` |
| `message.subject`, `html`, `text` | `subject`, `html`, `text` |
| `message.headers` | `headers` |
| `message.attachments[]` s `type`, `name`, `content` | `attachments[]` s `content_type`, `filename`, `content` |
| `message.images[]` pro vložené obrázky | `attachments[]` s `content_id`, na které se v HTML odkazujete přes `cid:` |
| `message.metadata`, `message.tags` | `meta`, objekt s řetězcovými hodnotami, který se vrací v událostech webhooků |
| `message.track_opens`, `track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `message.global_merge_vars` | `variables` |
| `message.merge_vars` (pro každého příjemce) | Jeden požadavek na příjemce, každý s vlastními `variables` |
| `message.subaccount` | Použijte API klíč z odpovídajícího workspace |
| `send_at` | `scheduled_at` (ISO 8601 nebo běžná angličtina) |
| `async` | Není potřeba. Emailit každý e-mail zařadí do fronty k doručení a odpoví, aniž by na doručení čekal. |
| `POST /messages/send-template` s `template_name` | Stejný `POST /v2/emails` s `template` (alias nebo ID) a `variables` |
| Odpověď: pole s `email`, `status` a `_id` pro každého příjemce | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

Mandrill hlásí problémy v odpovědi pro každého příjemce zvlášť, se stavy jako `rejected` nebo `invalid`. Emailit validuje celý požadavek a na neplatný vstup vrací chybu HTTP. Příjemci s blokací typu `recipient` se přijmou a pak dostanou stav `suppressed`. Přidejte hlavičku `Idempotency-Key`, aby bylo opakování bezpečné. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Změňte nastavení SMTP

| Nastavení | Mandrill | Emailit |
| --- | --- | --- |
| Server | `smtp.mandrillapp.com` | `smtp.emailit.com` |
| Port | `587`, `2525` nebo `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | Libovolná hodnota | `emailit` |
| Heslo | API klíč Mandrillu | Váš API klíč Emailitu |

Emailit nečte hlavičky `X-MC-*`, například `X-MC-Template`, `X-MC-MergeVars`, `X-MC-Tags`, `X-MC-Metadata` nebo `X-MC-Track`. Odstraňte je. Měření nastavte na doméně, a když potřebujete šablony nebo metadata, použijte API. Viz [Nastavení SMTP](/cs/docs/smtp/settings/).

## Namapujte události webhooků

| Událost Mandrillu | Událost Emailitu |
| --- | --- |
| `send` | `email.accepted` (jen API) |
| `delivered` | `email.delivered` |
| `deferral` | `email.attempted` |
| `hard_bounce` | `email.bounced` |
| `soft_bounce` | `email.attempted`, dokud Emailit opakuje doručení, pak `email.bounced`, pokud selžou všechny pokusy |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `spam` | `email.complained` |
| `unsub` | `email.unsubscribed`, jen u e-mailů z kampaní |
| `reject` | `email.suppressed`, když má adresa blokaci typu `recipient`. Jiné důvody odmítnutí, například `unsigned`, jsou v Emailitu chyby API. |
| Události synchronizace rejection denylistu | `suppression.created`, `suppression.deleted` u blokací, které přidáte nebo odeberete |
| `inbound` | `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:

- Mandrill posílá pole formuláře `mandrill_events`, které obsahuje pole JSON s až 1 000 událostmi. Emailit posílá pole JSON jako tělo požadavku, s až 100 událostmi.
- Název události je v `type` a e-mail v `data.object`. Místo `_id` používejte `data.object.id`, ID `em_` z odpovědi na odeslání, a místo `msg.email` používejte `data.object.to`. Vaše hodnoty `meta` 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`.
- Mandrill podepisuje URL a pole formuláře pomocí HMAC-SHA1 v kódování base64 v hlavičce `X-Mandrill-Signature`. Emailit podepisuje `<timestamp>.<raw body>` pomocí HMAC-SHA256: 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 celý rejection denylist tlačítkem **Export Full Denylist** na stránce **Rejection Denylist** v Mandrillu, nebo voláním API `/exports/rejects`. `/rejects/list` vrací nejvýše 1 000 záznamů, proto ho k tomu nepoužívejte. Export je soubor ZIP s `rejects.csv` a pokrývá všechny subaccounts.

2. Sestavte jedno CSV se sloupci `email,type,reason`. Záznamy, které už vypršely, přeskočte a typ zvolte podle sloupce `reason`:

   | Důvod v Mandrillu | Typ v Emailitu |
   | --- | --- |
   | `hard-bounce`, `spam`, `custom` | `recipient` |
   | `unsub` | `unsubscribe`, který zastaví kampaně, ale transakční e-maily propustí. Pokud chcete blokovat všechny e-maily jako Mandrill, použijte `recipient`. |
   | `soft-bounce` | Vynechte je. Tyto záznamy vyprší po jednom dni. |

```csv
email,type,reason
old-address@example.com,recipient,mandrill hard-bounce
angry@example.com,recipient,mandrill spam
```

   Typ `recipient` blokuje odeslání přes API, SMTP i kampaně. Pokud jste používali subaccounts, rozdělte soubor podle sloupce se subaccount a každou část naimportujte do odpovídajícího workspace.

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

Rejection allowlist z Mandrillu nemá ekvivalent. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte šablony

Získejte kód šablon z Mandrillu: jedno volání `/templates/list` vrátí všechny šablony s jejich `slug` a publikovaným HTML v `publish_code`. Pak každou naimportujte v **Email Marketing → Templates**, nebo ji vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/). Jako alias použijte slug z Mandrillu, pokud odpovídá formátu aliasu: malá písmena, číslice, `-` a `_`.

Šablony s oblastmi `mc:edit`, které vyplňoval `template_content`, potřebují tyto oblasti převést na proměnné. Názvy slučovacích proměnných v Mandrillu nerozlišují velká a malá písmena, v Temple ano: `{{FNAME}}` odpovídá jen proměnné s názvem `FNAME`. Převeďte slučovací značky do jazyka Temple:

| Mandrill | Emailit (Temple) |
| --- | --- |
| `*\|FNAME\|*` (merge language Mailchimp) | `{{FNAME}}`, nebo ji přejmenujte na `{{first_name}}` |
| `{{fname}}` (merge language Handlebars) | `{{fname}}` |
| `*\|IF:FNAME\|*…*\|ELSE:\|*…*\|END:IF\|*` | `{{#if FNAME}}…{{else}}…{{/if}}` |
| `*\|IF:PLAN=pro\|*` nebo porovnání uvnitř `{{#if}}` v Handlebars | Nepodporuje se. Předejte logickou hodnotu, například `is_pro`, a použijte `{{#if is_pro}}`. |
| `*\|DATE:d/m/y\|*`, `*\|CURRENT_YEAR\|*`, helpery jako `{{upper name}}` | Nepodporuje se. Hodnotu naformátujte ve svém kódu a předejte ji. |
| `*\|UNSUB:https://…\|*`, `{{unsub "…"}}` | Vlastní odkaz pro odhlášení. Viz [Odhlášení](/cs/docs/audiences/unsubscribes/#transactional-email-and-unsubscribes). |
| `{{#if plan}}…{{else}}…{{/if}}` | Stejně |
| `{{#each items}}…{{/each}}` | Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
| `…` s `template_content` | `{{body}}`, předaná ve `variables` |
| `global_merge_vars` | `variables` |

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](/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 s CNAME záznamy `mte1._domainkey` a `mte2._domainkey` Mandrillu ani s jeho TXT záznamem `mandrill_verify`. 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 DKIM a ověřovací záznamy Mandrillu, případné vlastní CNAME záznamy pro měření nebo return path a `include:spf.mandrillapp.com`, pokud ho váš záznam SPF obsahuje. Pokud přijímáte poštu přes inbound routes v Mandrillu, přesuňte ji nejdřív na [příchozí subdoménu](/cs/docs/inbound/set-up/) Emailitu.

## 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/mandrill/
