Přejít na obsah
Dokumentace

Průvodce

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

Aktualizováno 23. 10. 2026

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

Principy

SMTP2GO Emailit
Master account a subaccounts Účet a workspace. 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: 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
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 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í 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 s aliasem a verzemi vykreslované jazykem Temple
Webhooks Webhooky
Suppressions adres a domén Blokace adres
Reports a activity Email APIEmails a Email APILogs
Dedicated IPs a IP pools Dedikované IP adresy 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ě 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.

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 a Hlavičky a odpovědi SMTP.

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

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

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

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

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

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

Děkujeme za zpětnou vazbu.

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