# Přechod ze SMTP2GO

> Přejděte ze SMTP2GO na Emailit. Vyměňte uživatele SMTP a servery, převeďte volání API email/send a šablony a přesuňte webhooky, blokované adresy a domény odesílatelů.

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

| SMTP2GO | Emailit |
| --- | --- |
| Master account a subaccounts | Účet a [workspace](/cs/docs/workspaces/). Každý workspace má vlastní domény, klíče, členy a kredity. |
| SMTP users | Váš API klíč použitý jako heslo k SMTP. Pro každou aplikaci nebo server vytvořte jeden klíč. |
| API keys s oprávněními pro endpointy | [API klíče](/cs/docs/developers/api-keys/): **Full Access**, nebo **Sending Only**, volitelně omezený na jednu doménu |
| Autentizace podle IP a adresy | Není dostupné. Každé připojení SMTP se autentizuje API klíčem. |
| Sender domains | [Odesílací domény](/cs/docs/domains/) |
| Single sender emails | Není dostupné. Každá adresa odesílatele musí být na ověřené doméně. |
| Stav sandbox u uživatele SMTP nebo API klíče | Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a doručují jen členům workspace. |
| Nastavení měření a patičky pro odhlášení u každého uživatele SMTP nebo API klíče | [Měření](/cs/docs/tracking/) pro každou odesílací doménu. Emailit nepřidává patičku pro odhlášení do e-mailů z API ani SMTP. |
| Templates | [Šablony](/cs/docs/templates/) s aliasem a verzemi vykreslované jazykem [Temple](/cs/docs/templates/temple/) |
| Webhooks | [Webhooky](/cs/docs/webhooks/) |
| Suppressions adres a domén | [Blokace](/cs/docs/suppressions/) adres |
| Reports a 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í |

Pokud u newsletterů spoléháte na patičku pro odhlášení ze SMTP2GO, přidejte vlastní odkaz pro odhlášení a hlavičky `List-Unsubscribe`, nebo je odesílejte jako [kampaně](/cs/docs/campaigns/) Emailitu, které hlavičky přidají za vás. V kampaních přidejte viditelný odkaz pomocí `{{unsubscribe_url}}`. Viz [Hlavičky a odpovědi SMTP](/cs/docs/smtp/headers/#add-list-unsubscribe-yourself).

## Změňte nastavení SMTP

| Nastavení | SMTP2GO | Emailit |
| --- | --- | --- |
| Server | `mail.smtp2go.com`, nebo regionální server, například `mail-eu.smtp2go.com` | `smtp.emailit.com` |
| Port | `2525`, `587`, `25`, `8025` nebo `80` (STARTTLS), `465`, `8465` nebo `443` (TLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | Uživatelské jméno uživatele SMTP | `emailit` |
| Heslo | Heslo uživatele SMTP | Váš API klíč Emailitu |

Emailit nenaslouchá na portech `80`, `443`, `8025` ani `8465`. Pokud vaše síť blokuje `25` a `587`, použijte `2525` nebo `2587`. Každý příjemce se v Emailitu stane samostatným e-mailem a odpověď `250` uvádí jejich ID, nebo při velkém počtu příjemců jen první ID. Viz [Nastavení SMTP](/cs/docs/smtp/settings/) a [Hlavičky a odpovědi SMTP](/cs/docs/smtp/headers/).

## Upravte volání API

Z `POST /v3/email/send` v SMTP2GO se stane `POST /v2/emails`. Adresy zůstávají řetězci, ale mění se názvy polí:

```bash title="Před: SMTP2GO"
curl https://api.smtp2go.com/v3/email/send \
  -H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Your receipt",
    "text_body": "Thanks for your order.",
    "html_body": "<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>"
  }'
```

| SMTP2GO | Emailit |
| --- | --- |
| Hlavička `X-Smtp2go-Api-Key`, `api_key` v těle nebo `Authorization: Bearer api-…` | `Authorization: Bearer secret_…` |
| `sender` | `from` |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc`, každé až 50 |
| `custom_headers` s `Reply-To` | `reply_to` |
| `custom_headers: [{ "header": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `subject` | `subject` |
| `text_body`, `html_body` | `text`, `html` |
| `attachments[]` s `filename`, `fileblob` nebo `url` a `mimetype` | `attachments[]` s `filename`, `content` nebo `url` a `content_type` |
| `inlines[]` | `attachments[]` s `content_id`, na který v HTML odkazujete jako `cid:` |
| `template_id` a `template_data` | `template` (alias nebo ID) a `variables` |
| `schedule` (nejvýše 3 dny dopředu) | `scheduled_at` (ISO 8601 nebo běžná angličtina) |
| `fastaccept` | Není potřeba. Emailit každý e-mail zařadí do fronty k doručení a odpoví, aniž by na doručení čekal. |
| `POST /v3/email/batch` (až 1 000 e-mailů) | Není dostupné. Odešlete jeden požadavek na zprávu. |
| `POST /v3/email/mime` | Odešlete zprávu MIME přes [SMTP relay](/cs/docs/smtp/) |
| `200` s `email_id`, `succeeded`, `failed` a `failures` | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého. Chyby používají stavové kódy HTTP. |

SMTP2GO nemá metadata ani nastavení měření pro jednotlivé e-maily. V Emailitu přidejte `meta`, aby se vám vlastní hodnoty vracely v událostech webhooků, a `tracking: { "loads": true, "clicks": true }`, pokud chcete přepsat nastavení měření domény. Přidejte hlavičku `Idempotency-Key`, aby bylo opakování bezpečné. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Namapujte události webhooků

| Událost SMTP2GO | Událost Emailitu |
| --- | --- |
| `processed` | `email.accepted` (jen API) |
| `delivered` | `email.delivered` |
| `bounce`, kde `bounce` je `soft` | `email.attempted`, dokud Emailit opakuje doručení, pak `email.bounced`, pokud selžou všechny pokusy |
| `bounce`, kde `bounce` je `hard` | `email.bounced` |
| `reject` | `email.suppressed`, když má adresa blokaci typu `recipient`. Jiná odmítnutí, například neověřený odesílatel, jsou chyby v odpovědi API nebo v odpovědi SMTP. |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, jen u e-mailů z kampaní |

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

- SMTP2GO posílá jednu událost na požadavek, ve výchozím nastavení jako pole formuláře, nebo jako plochý 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 z `event` do `type` a e-mail je v `data.object`. Místo `email_id` používejte `data.object.id`, ID `em_` z odpovědi na odeslání nebo z odpovědi SMTP, a místo `rcpt` používejte `data.object.to`. Hodnoty, které jste předali v `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`.
- SMTP2GO webhooky nepodepisuje. 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 blokované adresy z **Reports > Suppressions** přes **Export**, nebo je načtěte po stránkách přes `POST /v3/suppression/view`. Pokud nenastavíte `start_date`, API vrací zhruba posledních 30 dní, proto ho nastavte tak, aby pokrylo celou vaši historii.

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

   | Důvod v SMTP2GO | Typ v Emailitu |
   | --- | --- |
   | `bounce`, `spam`, `manual` | `recipient`, který blokuje odeslání přes API, SMTP i kampaně |
   | `unsubscribe` | `unsubscribe`, který zastaví kampaně, ale transakční e-maily propustí. Pokud se člověk odhlásil ze všeho, co posíláte, použijte `recipient`. |

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

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 blokuje přesné adresy, takže blokace domén naimportovat nelze. Export zopakujte pro každý podúčet a naimportujte ho do odpovídajícího workspace. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte šablony

HTML každé šablony získáte přes `POST /v3/template/view`, který vrací `html_body`, `text_body` a `subject`, nebo ho zkopírujte z **Settings > Templates**. 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 ID šablony ze SMTP2GO, pokud odpovídá formátu aliasu: malá písmena, číslice, `-` a `_`.

SMTP2GO při odeslání šablony ignoruje `subject`. Emailit použije předmět šablony, pokud ho požadavek neobsahuje, proto `subject` vynechte, pokud chcete zachovat předmět šablony.

Šablony SMTP2GO používají Handlebars. Temple pokrývá běžné části:

| SMTP2GO (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{ username }}`, `{{ user.name }}` | `{{username}}`, `{{user.name}}` |
| `{{{ html_block }}}` | `{{html_block}}`. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte sami. |
| `{{#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. |
| Bez vestavěné výchozí hodnoty | `{{username\|"there"}}` přidá náhradní hodnotu |
| `template_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 s CNAME záznamem DKIM SMTP2GO `s<number>._domainkey`, s jeho CNAME záznamem return path `em<number>` ani s jeho CNAME záznamem pro měření `link`. Záznam DMARC ponechte. Viz [DNS záznamy odesílacích domén](/cs/docs/domains/dns-records/).

Po přepnutí provozu odstraňte CNAME záznamy SMTP2GO a ze záznamu SPF odeberte `include:spf.smtp2go.com`, pokud ho ještě obsahuje.

## Další kroky

- [Kontrolní seznam před ostrým provozem](/cs/docs/get-started/go-live/)
- [Řešení problémů se SMTP](/cs/docs/smtp/troubleshooting/)
- [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/smtp2go/
