Průvodce
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, 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:
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>"
}'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_namea seznamevent_message, s e-mailem vemail_infoa podrobnostmi vevent_data. Emailit posílá pole JSON s až 100 událostmi, každou s názvem vtypea e-mailem vdata.object. - Místo
email_referenceneborequest_idpoužívejtedata.object.id, IDem_z odpovědi na odeslání. Každý e-mail v Emailitu má jednoho příjemce,data.object.to, takžebounced_recipientnepotřebujete. Vaše hodnotymetajsou vdata.object.meta. - U událostí
email.loadedaemail.clickedje vdata.objectnačtení nebo proklik. Jako ID e-mailu používejtedata.object.email_ida pro příjemce a vaše hodnotymetapoužívejtedata.object.email.rcpt_toadata.object.email.meta. - ZeptoMail podepisuje pomocí HMAC-SHA256 v hlavičce
producer-signature, která obsahujetsasv base64. Emailit posíláX-Emailit-Timestampv sekundách aX-Emailit-Signature, hexadecimální HMAC-SHA256 z<timestamp>.<raw body>, jehož klíčem je váš tajný klíčwhsec_. Viz Podpis požadavku.
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
-
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). -
Sestavte jedno CSV se sloupci
email,type,reason:email,type,reason old-address@example.com,recipient,zeptomail hard bounce blocked@example.com,recipient,zeptomail suppressionPro adresy s akcí
suppressneborejectpoužijte typrecipient. Blokuje odeslání přes API, SMTP i kampaně. Záznamy ssuppress_trackingnemají ekvivalent, proto je vynechte. -
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
- Kontrolní seznam před ostrým provozem
- Nastavení webhooku
- Prioritní migrace: nechte inženýry Emailitu provést přechod s vámi