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

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](/cs/docs/sdks/) |
| 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](/cs/docs/get-started/api-or-smtp/).

## Životní cyklus e-mailu

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

1. **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`.
2. **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](/cs/docs/suppressions/), e-mail dostane stav `suppressed`. Pozastavená doména, zablokovaný workspace nebo nulový zůstatek kreditů mu dají stav `held`.
3. **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.
4. **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`.
5. **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.
6. **Otevření a prokliky.** Pokud má doména ověřenou [subdoménu pro měření](/cs/docs/tracking/), 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 API → Events**. Posílají se také na vaše [webhooky](/cs/docs/webhooks/) 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ů](/cs/docs/logs/email-statuses/).

## 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í](/cs/docs/billing/auto-refill/), aby se produkční pošta nikdy nezastavila. Tarify a ceny najdete na stránce [Kredity](/cs/docs/billing/credits/) a v [ceníku](/pricing/).

## 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 **Workspace → Settings → Requests**. Žá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)](/cs/docs/workspaces/production-access/).

Každý workspace má také [limity odesílání](/cs/docs/limits/), 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](https://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](/cs/docs/quickstart/api/): Přidejte doménu, vytvořte klíč a odešlete první e-mail.
  - [Rychlý začátek se SMTP](/cs/docs/quickstart/smtp/): Připojte jakoukoli aplikaci nebo framework přes SMTP.
  - [Volba mezi API a SMTP](/cs/docs/get-started/api-or-smtp/): Porovnejte dva způsoby odesílání transakčních e-mailů.
  - [Kontrolní seznam před ostrým provozem](/cs/docs/get-started/go-live/): Vše, co udělat, než začnete posílat skutečným příjemcům.

---
Zdroj: https://emailit.com/cs/docs/get-started/how-emailit-works/