# Přechod ze ZeptoMailu

> Přejděte ze ZeptoMailu (dnes Zoho CPaaS) na Emailit. Namapujte Agents a send mail tokeny, převeďte volání API a šablony Mustache, vyměňte nastavení SMTP a přesuňte webhooky a blokované adresy.

Tento průvodce mapuje pojmy, volání API, webhooky, blokované adresy a šablony ze ZeptoMailu na jejich ekvivalenty v Emailitu. V září 2026 byl ZeptoMail přejmenován na Zoho CPaaS. Stávající tokeny, hostitelé a nastavení SMTP dál fungují, proto tento průvodce používá názvy ZeptoMailu, které najdete ve svém kódu. 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

| ZeptoMail (Zoho CPaaS) | Emailit |
| --- | --- |
| Account | Účet |
| Agents (dříve Mail Agents) | [Workspace](/cs/docs/workspaces/), nebo jeden workspace s několika odesílacími doménami |
| Send mail token Agenta | [API klíč](/cs/docs/developers/api-keys/) s oprávněním **Sending Only**, volitelně omezený na jednu doménu |
| Tokeny Zoho OAuth pro API ke správě | API klíč s oprávněním **Full Access**. Stejný druh klíče odesílá e-maily i spravuje váš workspace. |
| Domény přiřazené k Agents | [Odesílací domény](/cs/docs/domains/) |
| Sandbox Agents | Nové workspace jsou v [režimu sandbox](/cs/docs/workspaces/production-access/) a doručují jen členům workspace. Režim, který e-maily přijme, ale nedoručí je, neexistuje. |
| Templates pro každého Agenta s klíčem a aliasem | [Šablony](/cs/docs/templates/) pro celý workspace, s aliasem a verzemi |
| Webhooky pro každého Agenta | [Webhooky](/cs/docs/webhooks/) pro celý workspace |
| Suppression list se záznamy e-mailových adres a domén | [Seznam blokovaných adres](/cs/docs/suppressions/) s e-mailovými adresami |
| Processed emails a email logs | **Email API → Emails** a **Email API → Logs** |
| `client_reference` | `meta` |
| File cache | Přílohy přes `url` |

ZeptoMail odesílá jen transakční e-maily. V Emailitu má stejný workspace také [kampaně](/cs/docs/campaigns/), [seznamy kontaktů](/cs/docs/audiences/) a [automatizace](/cs/docs/automations/), pokud chcete přesunout i newslettery.

## Upravte volání API

Z `POST /v1.1/email` ve ZeptoMailu se stane `POST /v2/emails`. Mění se schéma autorizace a adresy jsou prosté řetězce:

```bash title="Před: ZeptoMail"
curl https://api.zeptomail.com/v1.1/email \
  -H "Authorization: Zoho-enczapikey $ZEPTOMAIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "address": "hello@acme.com", "name": "Acme" },
    "to": [{ "email_address": { "address": "ada@example.com" } }],
    "subject": "Your receipt",
    "textbody": "Thanks for your order.",
    "htmlbody": "<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>"
  }'
```

| ZeptoMail | Emailit |
| --- | --- |
| `Authorization: Zoho-enczapikey <token>` | `Authorization: Bearer secret_…` |
| Regionální hostitelé, například `api.zeptomail.eu` nebo `cpaas.zoho.eu` | Jeden hostitel, `api.emailit.com` |
| `from: { address, name }` | `from: "Name "` |
| `to[]`, `cc[]`, `bcc[]` s `email_address: { address, name }` | `to`, `cc`, `bcc` jako řetězec nebo pole, každé až 50 adres |
| `reply_to: [{ address, name }]` | `reply_to` |
| `subject` | `subject` |
| `htmlbody`, `textbody` | `html`, `text` |
| `mime_headers` | `headers` |
| `attachments[]` s `content`, `mime_type`, `name` | `attachments[]` s `content`, `content_type`, `filename` |
| `attachments[]` s `file_cache_key` | `attachments[]` s `url`, ze kterého Emailit soubor stáhne, nebo s `content` v base64 |
| `inline_images[]` s `cid` | `attachments[]` s `content_id`, na které se v HTML odkazujete přes `cid:` |
| `client_reference` | `meta`, například `meta: { "reference": "order-12345" }`, vrací se v událostech webhooků |
| `track_opens`, `track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `POST /v1.1/email/template` s `template_key` nebo `template_alias` a `merge_info` | Stejný `POST /v2/emails` s `template` (alias nebo ID) a `variables` |
| `POST /v1.1/email/batch` a `/email/template/batch` | Není dostupné. Pro každého příjemce odešlete samostatný požadavek s vlastními `variables`. |
| Odpověď s `request_id` a `email_reference` pro každý e-mail ve webhoocích a logech | `200` s `id` (`em_…`), `status: "accepted"` a u více příjemců `ids` s jedním ID pro každého |

Emailit navíc podporuje plánování přes `scheduled_at` a bezpečné opakování požadavků s hlavičkou `Idempotency-Key`, což ZeptoMail při odesílání nenabízí. Viz [Odeslání e-mailu](/cs/docs/email-api/send-email/).

## Změňte nastavení SMTP

| Nastavení | ZeptoMail | Emailit |
| --- | --- | --- |
| Server | `smtp.zeptomail.com` nebo regionální server | `smtp.emailit.com` |
| Port | `587` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` nebo `25` (STARTTLS), `465` (TLS) |
| Uživatelské jméno | `emailapikey` | `emailit` |
| Heslo | Send mail token Agenta bez `Zoho-enczapikey` | Váš API klíč Emailitu |

Emailit nečte hlavičky `X-TM-*`, například `X-TM-CLIENT-REF`, `X-TM-OPEN-TRACK`, `X-TM-CLICK-TRACK` nebo `X-TM-FILE-KEY`. Odstraňte je. 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 ZeptoMailu | Událost Emailitu |
| --- | --- |
| Delivered | `email.delivered` |
| Soft bounce (`softbounce`) | `email.attempted`, dokud Emailit opakuje doručení, pak `email.bounced`, pokud selžou všechny pokusy |
| Hard bounce (`hardbounce`) | `email.bounced` |
| Open (`email_open`), jen první otevření | `email.loaded`, posílá se při každém načtení |
| Click (`email_link_click`) | `email.clicked`, posílá se při každém prokliku |
| Feedback loop (`fbl_complaint`) | `email.complained` |

Emailit navíc posílá události, pro které ZeptoMail žádný webhook nemá, například `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:

- ZeptoMail posílá `event_name` a seznam `event_message`, s e-mailem v `email_info` a podrobnostmi v `event_data`. Emailit posílá pole JSON s až 100 událostmi, každou s názvem v `type` a e-mailem v `data.object`.
- Místo `email_reference` nebo `request_id` používejte `data.object.id`, ID `em_` z odpovědi na odeslání. Každý e-mail v Emailitu má jednoho příjemce, `data.object.to`, takže `bounced_recipient` nepotřebujete. 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`.
- ZeptoMail podepisuje pomocí HMAC-SHA256 v hlavičce `producer-signature`, která obsahuje `ts` a `s` v base64. Emailit posílá `X-Emailit-Timestamp` v sekundách a `X-Emailit-Signature`, hexadecimální HMAC-SHA256 z `<timestamp>.<raw body>`, jehož klíčem je váš tajný klíč `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 svůj suppression list. Export z webového rozhraní ZeptoMailu pokrývá posledních 60 dní s nejvýše 5 000 záznamy na soubor, proto pro starší záznamy použijte API pro suppressions (`GET /v1.1/suppressions/email`).

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

```csv
email,type,reason
old-address@example.com,recipient,zeptomail hard bounce
blocked@example.com,recipient,zeptomail suppression
```

   Pro adresy s akcí `suppress` nebo `reject` použijte typ `recipient`. Blokuje odeslání přes API, SMTP i kampaně. Záznamy s `suppress_tracking` nemají ekvivalent, proto je vynechte.

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 záznamy domén, například `example.com`, naimportovat nelze. Viz [Správa blokovaných adres](/cs/docs/suppressions/manage/).

## Přesuňte šablony

Zkopírujte HTML každé šablony z editoru ZeptoMailu, nebo ho získejte z API pro šablony, které ho vrací v `htmlbody`. Naimportujte ho v **Email Marketing → Templates**, nebo šablonu vytvořte přes [API pro šablony](/cs/docs/api-reference/templates/create/). Jako alias v Emailitu použijte alias šablony ze ZeptoMailu, pokud odpovídá formátu aliasu: malá písmena, číslice, `-` a `_`.

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

| ZeptoMail (Mustache) | Emailit (Temple) |
| --- | --- |
| `{{name}}`, `{{order.total}}` | Stejně |
| `{{{html_block}}}` | `{{html_block}}`. Temple nikdy neescapuje HTML, proto vstupy od uživatelů escapujte sami. |
| `{{#plan}}…{{/plan}}` | `{{#if plan}}…{{/if}}` |
| `{{^plan}}…{{/plan}}` | `{{#if plan}}{{else}}…{{/if}}` |
| `{{#items}}…{{/items}}` nad seznamem | Nepodporuje se. Vykreslete seznam ve svém kódu a předejte ho jako jednu proměnnou. |
| Bez vestavěné výchozí hodnoty | `{{name\|"there"}}` přidá náhradní hodnotu |
| `merge_info` | `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 ZeptoMailu, s jeho CNAME záznamem pro bounce ani s CNAME záznamem pro měř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 DKIM, bounce a měření ZeptoMailu a také `include:zeptomail.net`, pokud jste ho přidali do záznamu SPF.

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