Přejít na obsah
Dokumentace

Průvodce

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.

Aktualizováno 23. 10. 2026

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, přečtěte si ji jako první.

Principy

ZeptoMail (Zoho CPaaS) Emailit
Account Účet
Agents (dříve Mail Agents) Workspace, nebo jeden workspace s několika odesílacími doménami
Send mail token Agenta API klíč 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
Sandbox Agents Nové workspace jsou v režimu sandbox 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 pro celý workspace, s aliasem a verzemi
Webhooky pro každého Agenta Webhooky pro celý workspace
Suppression list se záznamy e-mailových adres a domén Seznam blokovaných adres s e-mailovými adresami
Processed emails a email logs Email APIEmails a Email APILogs
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ě, seznamy kontaktů a automatizace, 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:

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>"
  }'
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 <email>"
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.

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.

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

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.
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 APISuppressions 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.

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 MarketingTemplates, nebo šablonu vytvořte přes API pro šablony. 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 a Import a export šablon.

Změňte DNS

Přidejte doménu v Email APIDomains 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.

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

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.