Princip

Jak Emailit funguje

Jak o Emailitu přemýšlet, na jedné stránce. Workspace, domény a API klíče, způsoby odesílání a příjmu, životní cyklus e-mailu, kredity a režim sandbox.

Aktualizováno 1. 10. 2026

Tato stránka vysvětluje hlavní části Emailitu a jak do sebe zapadají. Přečtěte si ji jednou, než cokoli začnete stavět. Zbytek dokumentace předpokládá, že tyto pojmy znáte.

Účty a workspace

Váš účet jste vy: e-mailová adresa, heslo a volitelně dvoufázové ověření nebo přístupové klíče. Vše, co odesíláte, patří do nějakého workspace. Jeden účet může patřit do více workspace a mezi nimi přepínáte přepínačem workspace v horní části postranního panelu. Běžné je mít jeden workspace pro každý produkt nebo prostředí, například Acme a Acme Staging.

Každý workspace má vlastní:

Zdroj	Co to je
Odesílací domény	Domény, které ověříte DNS záznamy, aby za ně Emailit mohl odesílat. Každá adresa odesílatele musí být na ověřené odesílací doméně.
API klíče	Tajné údaje, které začínají na `secret_`. Autentizují REST API, MCP server a SMTP relay. Klíč má buď Full Access, nebo Sending Only.
Členové	Lidé, kteří mohou workspace otevřít, s rolí Admin, nebo Member. Administrátoři navíc spravují nastavení, API klíče, členy a fakturaci.
Fakturace	Tarif, zůstatek kreditů, nastavení automatického dobíjení a faktury.
Data	E-maily, události, logy, kontakty, seznamy kontaktů, šablony, webhooky a blokované adresy.

API klíče, domény, kontakty a kredity patří jednomu workspace. API klíč nikdy nefunguje v jiném workspace.

Způsoby odesílání a jeden způsob příjmu

Kanál	K čemu slouží	Jak
REST API	Transakční e-maily z vašeho kódu: registrace, obnovení hesla, potvrzení o platbě	`POST https://api.emailit.com/v2/emails` s API klíčem, nebo přes SDK
SMTP relay	Aplikace, frameworky a nástroje, které už umí SMTP	Hostitel `smtp.emailit.com`, uživatelské jméno `emailit`, API klíč jako heslo
Kampaně a automatizace	Newslettery, oznámení a uvítací sekvence pro vaše kontakty	Sestavují se ve webovém rozhraní v sekci Email Marketing
Příchozí e-maily	Příjem e-mailů na vaší doméně, pro odpovědi nebo podporu	MX záznam na `inbound.<your domain>`. Každá zpráva vyvolá `email.received`.

Všechny kanály používají stejné ověřené domény a stejný seznam blokovaných adres. API a SMTP relay navíc sdílejí API klíče, logy požadavků a jednu sadu limitů odesílání. Jak si mezi nimi vybrat, popisuje stránka Volba mezi API a SMTP.

Životní cyklus e-mailu

Každý e-mail prochází stejnou cestou, ať ho odešlete jakkoli:

Přijetí. API nebo SMTP relay zkontroluje požadavek: platný API klíč, adresu odesílatele na ověřené doméně, pravidla sandboxu, limity odesílání a kredity. Každý příjemce se stane samostatným e-mailem s vlastním ID em_ a stavem accepted, nebo scheduled, pokud jste nastavili čas odeslání. API vyvolá událost email.accepted, nebo email.scheduled.
Zařazení do fronty a kontrola. Doručovací proces e-mail převezme a znovu ho zkontroluje. Pokud je příjemce na vašem seznamu blokovaných adres, e-mail dostane stav suppressed. Pozastavená doména, zablokovaný workspace nebo nulový zůstatek kreditů mu dají stav held.
Podpis a hodnocení. Emailit zprávu podepíše DKIM pro vaši doménu a nastaví return path na emailit.<your domain>. Pokud je zapnuté měření, přepíše odkazy a přidá měřicí pixel. Pak provede kontrolu spamu. Zpráva se skóre 7 nebo vyšším dostane stav held a pravidla, která se na ni uplatnila, najdete v sekci Spam Checks na stránce e-mailu.
Pokusy o doručení. Emailit se připojí k poštovnímu serveru příjemce. Trvalé odmítnutí (odpověď 5xx) dá e-mailu stav bounced. Dočasná chyba (odpověď 4xx nebo vypršení časového limitu) mu dá stav attempted a Emailit to zkusí znovu až 7krát během asi 21 hodin, než to vzdá a označí ho jako bounced.
Doručení. Přijímající server zprávu přijal, takže e-mail má stav delivered. Zpráva o nedoručení, která dorazí později, ho ještě může změnit na bounced a stížnost na spam od poskytovatele schránky mu dá stav complained. Adresy, na které se e-mail nedoručil nebo jejichž příjemci si stěžovali, se mohou automaticky přidat na váš seznam blokovaných adres.
Otevření a prokliky. Pokud má doména ověřenou subdoménu pro měření, otevření dají e-mailu stav loaded a prokliky stav clicked.

Každá změna stavu se zaznamená jako událost. Události se zobrazují na stránce e-mailu a v Email APIEvents. Posílají se také na vaše webhooky jako podepsaný JSON, v dávkách až po 100 událostech na požadavek.

Skupina	Stavy
Na cestě	`accepted`, `scheduled`, `attempted`
Dorazil	`delivered`, `loaded`, `clicked`, `received` (příchozí)
Zastavený	`bounced`, `failed`, `rejected`, `suppressed`, `complained`, `canceled`, `held`

E-mail můžete zrušit, dokud je ve stavu scheduled, accepted nebo attempted. E-mail ve stavu held, bounced, failed nebo suppressed můžete po odstranění příčiny odeslat znovu. Význam jednotlivých stavů najdete na stránce Stavy e-mailů.

Kredity

Emailit účtuje v kreditech. Každý workspace má zůstatek, který tvoří kredity v ceně jeho tarifu na každý měsíc a kredity, které dokoupíte. Kredity v ceně tarifu se čerpají jako první. Zakoupené kredity nikdy nepropadají.

Akce	Kredity
E-mail odeslaný přes API nebo SMTP (za příjemce)	1
Přijatý e-mail	1
E-mail z kampaně (za příjemce)	2
Spuštění automatizace	3
Ověření e-mailu (za adresu)	5

Pokud zůstatek na odeslání nestačí, API vrátí 402 a nic se neodešle. E-maily, které se dostanou do doručovací fronty bez dostatku kreditů, dostanou stav held a po doplnění kreditů je můžete odeslat znovu. Zapněte automatické dobíjení, aby se produkční pošta nikdy nezastavila. Tarify a ceny najdete na stránce Kredity a v ceníku.

Sandbox a produkční přístup

Každý nový workspace začíná v režimu sandbox. V režimu sandbox můžete posílat jen na e-mailové adresy účtů členů workspace a kampaně jsou zablokované. Odeslání komukoli jinému selže: API vrátí 403 unverified_workspace_recipient a SMTP relay odpoví 550.

Pokud chcete posílat skutečným příjemcům, ověřte alespoň jednu odesílací doménu. Pak administrátor požádá o produkční přístup z banneru sandboxu, nebo v WorkspaceSettingsRequests. Žádost se ptá, co odesíláte, jaký očekáváte objem a jak se k vám lidé přihlašují. Tým Emailitu ji posoudí a odpoví ve stejném vlákně žádosti. Viz Produkční přístup (ověření workspace).

Každý workspace má také limity odesílání, společné pro API a SMTP. Nové workspace mohou odesílat 2 e-maily za sekundu a 5 000 e-mailů denně. Workspace s tarifem Pro a Business dostávají automatická navýšení podle kondice odesílání a každý workspace může požádat o víc v panelu Sending Limits na úvodní stránce webového rozhraní.

Webové rozhraní

Webové rozhraní na dash.emailit.com sleduje stejný model. Postranní panel má shora dolů tyto sekce:

Sekce	Stránka	K čemu slouží
Dashboard		Kontrolní seznam nastavení, rychlé akce, kredity, denní objem, kondice odesílání a limity odesílání
Email Marketing	Overview	Růst kontaktů a nedávná marketingová aktivita
	Audiences	Pojmenované seznamy odběratelů, na které se posílají kampaně
	Contacts	Všichni lidé ve workspace, s vlastními poli, importem a exportem
	Campaigns	Tvorba, testování, plánování a reporty kampaní
	Templates	Opakovaně použitelné návrhy pro API, automatizace a kampaně
	Forms	Přihlašovací formuláře (předběžný přístup)
	Automations	Workflow spouštěná kontakty, daty a událostmi e-mailů (betaverze)
Email API	Emails	Všechny odchozí a příchozí e-maily se stavem, obsahem a pokusy o doručení
	Analytics	Odeslání, nedoručení, stížnosti, otevření a prokliky v čase
	Domains	Přidávání domén, zveřejnění DNS záznamů, kontrola ověření a měření
	DMARC reports	Kdo odesílá poštu jménem vaší domény (tarif Pro a vyšší)
	Events	Proud událostí workspace, který přijímají webhooky
	Logs	Všechny požadavky přes API a SMTP se stavovými kódy a těly
	API Keys	Vytváření, přejmenování, nové vygenerování a mazání klíčů a nastavení SMTP
	Webhooks	Endpointy, výběr událostí a všechny pokusy o doručení
	Suppressions	Adresy, na které Emailit nebude odesílat, s importem a exportem CSV
Email Verification	Emails	Kontrola jedné adresy před odesláním
	Lists	Kontrola až 10 000 adres najednou
Workspace	Billing	Tarif, kredity, automatické dobíjení, doplňky a faktury
	Settings	Název, členové, vlastní pole, uchovávání dat, nastavení blokování adres a žádosti

Nastavení vašeho účtu (profil, heslo, dvoufázové ověření a přístupové klíče) a váš odkaz pro doporučení najdete v nabídce účtu v dolní části postranního panelu.

Další kroky

Rychlý začátek s API

Přidejte doménu, vytvořte klíč a odešlete první e-mail.

Rychlý začátek se SMTP

Připojte jakoukoli aplikaci nebo framework přes SMTP.

Volba mezi API a SMTP

Porovnejte dva způsoby odesílání transakčních e-mailů.

Kontrolní seznam před ostrým provozem

Vše, co udělat, než začnete posílat skutečným příjemcům.