# Přechod z MailerSendu

> Přejděte z MailerSendu na Emailit. Namapujte domény, tokeny a uživatele SMTP, převeďte volání API a personalizaci, změňte nastavení SMTP a přesuňte webhooky, blokované adresy a šablony.

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

| MailerSend | Emailit |
| --- | --- |
| Účet | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| Domains | [Odesílací domény](/cs/docs/domains/) |
| Sender identities | Není dostupné. Každá adresa odesílatele musí být na ověřené doméně. |
| API tokens s oprávněními | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| SMTP users | Váš API klíč použitý jako heslo k SMTP |
| Testovací doména a režim sandbox | Sdílená testovací doména neexistuje. Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a mohou odesílat jen členům workspace. |
| Templates | [Šablony](/cs/docs/templates/) s aliasem a verzemi vykreslované jazykem [Temple](/cs/docs/templates/temple/) |
| Webhooky pro každou doménu | [Webhooky](/cs/docs/webhooks/) pro celý workspace |
| Inbound routes | [Příchozí e-maily](/cs/docs/inbound/) s webhookem `email.received`, nebo [automatizace](/cs/docs/inbound/forward-with-automations/) **Forward received email** |
| Suppressions pro každou doménu: hard bounces, spam complaints, unsubscribes, blocklist | Jeden [seznam blokovaných adres](/cs/docs/suppressions/) pro každý workspace |
| On hold list | Není potřeba. Emailit po dočasném nedoručení opakuje doručení a každý pokus hlásí jako `email.attempted`. |
| Activity | **Email API → Emails** a **Email API → Logs** |
| Tags | `meta` |
| Email verification | [Ověřování e-mailů](/cs/docs/email-verification/) |
| Dedicated IPs | [Dedikované IP adresy](/cs/docs/deliverability/dedicated-ips/) na vyžádání |

## Upravte volání API

Z `POST /v1/email` v MailerSendu se stane `POST /v2/emails`. Oba přijímají bearer token a JSON, ale adresy jsou v Emailitu prosté řetězce místo objektů:

```bash title="Před: MailerSend"
curl https://api.mailersend.com/v1/email \
  -H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "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>"
  }'
```

| MailerSend | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` | `Authorization: Bearer secret_…` |
| `from: { email, name }` | `from: "Name "` |
| `to[]`, `cc[]`, `bcc[]` s `email` a `name` | `to`, `cc`, `bcc` jako řetězec nebo pole, každé až 50 adres |
| `reply_to: { email, name }` | `reply_to` |
| `subject`, `text`, `html` | Stejně |
| `headers: [{ "name": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `list_unsubscribe` | `headers` s `List-Unsubscribe` a `List-Unsubscribe-Post`. Viz [Hlavičky a metadata](/cs/docs/email-api/headers-and-metadata/). |
| `attachments[]` s `content`, `filename`, `disposition` a `id` | `attachments[]` s `content`, `filename` a `content_type`, nebo s `url` místo `content`. U vložených obrázků použijte `content_id`. |
| `template_id` | `template`, ID nebo alias šablony |
| `personalization: [{ "email": "…", "data": { … } }]` | `variables`, s jedním požadavkem na příjemce, když se hodnoty liší |
| `tags` | `meta`, vrací se v událostech webhooků |
| `send_at` (unixový čas nebo ISO 8601) | `scheduled_at` (ISO 8601 nebo běžná angličtina). Unixový čas nejdřív převeďte na ISO 8601. |
| `settings.track_opens`, `settings.track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `POST /v1/bulk-email` | Není dostupné. Odešlete jeden požadavek na zprávu. |
| `202 Accepted` s hlavičkou `x-message-id` a prázdným tělem | `200` s tělem JSON: `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

Každý příjemce v požadavku Emailitu se stane samostatným e-mailem s vlastním ID. MailerSend odpoví `202`, i když jsou všichni příjemci zablokovaní, a v těle uvede varování. Emailit příjemce s blokací typu `recipient` také přijme a každému z nich dá 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í | MailerSend | Emailit |
| --- | --- | --- |
| Server | `smtp.mailersend.net` | `smtp.emailit.com` |
| Port | `587` (STARTTLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | Vygenerované uživatelské jméno uživatele SMTP | `emailit` |
| Heslo | Heslo uživatele SMTP | Váš API klíč Emailitu |

Emailit nečte hlavičku `X-MailerSend-Tags`. Odstraňte ji. Na rozdíl od MailerSendu Emailit vaše ostatní vlastní hlavičky doručí beze změny. Viz [Nastavení SMTP](/cs/docs/smtp/settings/).

## Namapujte události webhooků

| Událost MailerSendu | Událost Emailitu |
| --- | --- |
| `activity.sent` | `email.accepted` (jen API) |
| `activity.delivered` | `email.delivered` |
| `activity.deferred` | `email.attempted` |
| `activity.soft_bounced` | `email.attempted`, dokud Emailit opakuje doručení, pak `email.bounced`, pokud selžou všechny pokusy |
| `activity.hard_bounced` | `email.bounced` |
| `activity.suppressed` | `email.suppressed` |
| `activity.opened`, `activity.opened_unique` | `email.loaded`, posílá se při každém načtení |
| `activity.clicked`, `activity.clicked_unique` | `email.clicked`, posílá se při každém prokliku |
| `activity.spam_complaint` | `email.complained` |
| `activity.unsubscribed` | `email.unsubscribed`, jen u e-mailů z kampaní |
| Inbound route, která přeposílá na 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:

- MailerSend posílá jednu událost na požadavek. Emailit posílá pole JSON s až 100 událostmi, proto tělo procházejte ve smyčce.
- Název události je u obou v `type`. E-mail je v Emailitu v `data.object`: místo `data.message_id` (`data.email.message.id` u webhooků verze 1) používejte `data.object.id`, ID `em_` z odpovědi na odeslání, a místo `data.recipient` 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`.
- Hlavička `Signature` v MailerSendu je HMAC-SHA256 ze surového těla požadavku. Hlavička `X-Emailit-Signature` v Emailitu je HMAC-SHA256 z `<timestamp>.<raw body>`, jehož klíčem je váš tajný klíč `whsec_`, proto čtěte i `X-Emailit-Timestamp`. 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. V MailerSendu vyexportujte **Hard bounces**, **Spam complaints**, **Unsubscribes** a **Blocklist** každé domény, ze stránek suppressions nebo přes API (`/v1/suppressions/hard-bounces`, `/spam-complaints`, `/unsubscribes` a `/blocklist`). On hold list je dočasný, takže ho můžete vynechat.

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

```csv
email,type,reason
old-address@example.com,recipient,mailersend hard bounce
angry@example.com,recipient,mailersend 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 marketingových e-mailů, 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čí.

Emailit má jeden seznam blokovaných adres pro každý workspace, takže adresy ze všech vašich domén v MailerSendu půjdou do stejného seznamu. Blokace platí pro přesné adresy: vzory z blocklistu, například `.*@example.com`, nemají ekvivalent. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte šablony

Zkopírujte HTML každé šablony z editoru MailerSendu a pak ho naimportujte v **Email Marketing → Templates**, nebo šablonu vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/). Dejte jí alias, například `receipt`, a odesílejte ji s `"template": "receipt"` a `variables`.

Personalizace v MailerSendu je omezená verze jazyka Twig. Temple pokrývá běžné části:

| MailerSend | Emailit (Temple) |
| --- | --- |
| `{{ name }}`, `{{ user.name }}` | `{{name}}`, `{{user.name}}` |
| `{{ name\|default('there') }}` | `{{name\|"there"}}` |
| `{% if plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if plan == "pro" %}`, `{% elseif %}` | Nepodporuje se. Předejte logickou hodnotu, například `is_pro`, a použijte `{{#if is_pro}}`. |
| `{% for item in items %}…{% endfor %}` | Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
| `{{ name\|upper }}` a další filtry | Nepodporuje se. Hodnotu naformátujte ve svém kódu. |
| `personalization[].data` | `variables` |

MailerSend z hodnot personalizace odstraňuje většinu HTML. Temple HTML nikdy neescapuje ani neodstraňuje, proto vstupy od uživatelů escapujte dřív, než je předáte. 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áznamy DKIM MailerSendu `ms1._domainkey` a `ms2._domainkey`, s jeho CNAME záznamem return path `mta` ani s jeho CNAME záznamem pro měření `email`. Záznam DMARC ponechte. Viz [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Příchozí routing MailerSendu ve výchozím nastavení také používá subdoménu `inbound`. Pokud ji používá i ten váš, nastavte příchozí poště Emailitu jinou subdoménu přes `inbound_key`, nebo MX záznam přepněte, až budete příchozí poštu přesouvat. Viz [Nastavení příchozích e-mailů](/cs/docs/inbound/set-up/).

Po přepnutí provozu odstraňte záznamy MailerSendu pro DKIM, return path a měření a ze záznamu SPF odeberte `include:_spf.mailersend.net`.

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