Průvodce
Kontrolní seznam před ostrým provozem
Vše, co zkontrolovat, než začnete s Emailitem odesílat produkční e-maily, od DNS, produkčního přístupu a API klíčů po webhooky, blokované adresy, limity a zahřívání.
Aktualizováno 1. 10. 2026
Než začnete posílat e-maily skutečným příjemcům, projděte si tento kontrolní seznam. Většina bodů zabere pár minut. Produkční přístup a navýšení limitů posuzuje tým Emailitu, proto s nimi začněte jako první.
Domény a DNS
- Ověřte každou doménu, ze které odesíláte. V Email APIDomains by měla mít každá doména stav Verified a SPF, DKIM i Return Path ve stavu OK. Adresa odesílatele na jakékoli jiné doméně se odmítne. Viz Přidání odesílací domény a DNS záznamy.
- Zveřejněte DMARC záznam. Pokud vaše doména ještě nemá TXT záznam
_dmarc, začněte se záznamem navrženým na stránce domény,v=DMARC1; p=none;, a politiku zpřísněte, až budou reporty čisté. Gmail a Yahoo DMARC záznam očekávají od každého, kdo odesílá hromadně. Pokud už DMARC záznam máte, ponechte si ho. Pošta z Emailitu projde kontrolou DMARC díky DKIM zarovnanému s vaší doménou. Viz Nastavení DMARC. - Pokud měříte otevření nebo prokliky, nastavte subdoménu pro měření. Zveřejněte CNAME záznam z
go.<your domain>nago.emailitmail.coma pak na stránce domény zapněte Track loads a Track clicks. Bez ověřeného CNAME záznamu se pošta odesílá bez měření. Viz Vlastní doména pro měření. - Používejte adresy odesílatele, které lidé poznají, a zajistěte, aby se odpovědi k někomu dostaly: nastavte
reply_tona sledovanou schránku, nebo přijímejte odpovědi jako příchozí e-maily.
Workspace a přístup
- Požádejte o produkční přístup. Dokud není schválený, můžete posílat jen na e-mailové adresy účtů členů workspace a kampaně jsou zablokované. Administrátor přejde do WorkspaceSettingsRequests a vybere Request Verification. Potřebujete alespoň jednu ověřenou doménu. Viz Produkční přístup (ověření workspace).
- Zkontrolujte své limity odesílání. Nové workspace mohou odesílat 2 e-maily za sekundu a 5 000 e-mailů denně, společně pro API a SMTP. Pokud hned od prvního dne potřebujete víc, vyberte Request Increase v panelu Sending Limits na úvodní stránce webového rozhraní a popište svůj objem a odkud pochází váš seznam. Žádosti se obvykle posuzují do 24 hodin. Viz Limity a kvóty.
- Ujistěte se, že máte dost kreditů, a zapněte automatické dobíjení, aby se odesílání nezastavilo, když zůstatek klesne. Automatické dobíjení je ve výchozím stavu vypnuté. Viz Kredity.
- Zabezpečte tým. Dávejte lidem roli Member, pokud nepotřebují spravovat klíče, členy nebo fakturaci, a zapněte dvoufázové ověření. Viz Členové a role.
API klíče
- V produkčních aplikacích používejte klíč Sending Only. Klíč Sending Only umí e-maily odesílat, přeplánovat, rušit, odesílat znovu a přeposílat a nic jiného. Omezte ho na tu jednu doménu, ze které aplikace odesílá. Klíče Full Access si nechte pro nástroje, které čtou e-maily nebo spravují zdroje.
- Pro každou aplikaci a prostředí mějte jeden klíč, aby logy ukazovaly, kdo co odeslal, a abyste mohli vyměnit jeden klíč, aniž byste sahali na ostatní.
- Uchovávejte klíče v tajnosti. Ukládejte je ve správci tajných údajů nebo v proměnných prostředí, nikdy v kódu na straně klienta ani v repozitáři. Klíč vyměníte tlačítkem Regenerate. Starý tajný klíč okamžitě přestane fungovat. Viz API klíče.
Webhooky
- Vytvořte endpoint webhooku v Email APIWebhooks na URL s HTTPS. Nový webhook dostává všechny události. Omezte ho na události, na které reagujete, například
email.delivered,email.bounced,email.complainedaemail.suppressed. Viz Nastavení webhooku. - U každého požadavku ověřujte podpis.
X-Emailit-Signatureje hexadecimální HMAC-SHA256 z<timestamp>.<raw body>s celým tajným klíčem webhooku včetněwhsec_a časové razítko je vX-Emailit-Timestamp. Viz Ověření podpisu webhooků. - Zpracujte dávky a opakování. Tělo každého požadavku je pole JSON až se 100 událostmi. Do 30 sekund vraťte
2xxa události pak zpracujte na pozadí, přičemž přeskočte každéevent_id, které jste už viděli. Neúspěšné požadavky se opakují asi 3 dny a endpoint, který selhává 3 dny v kuse, se vypne. Viz Opakování a selhání. - Pošlete testovací událost tlačítkem Send test na stránce webhooku a zkontrolujte, že ji vaše obsluha přijme.
Kód pro odesílání
- S každým požadavkem na API posílejte
Idempotency-Key, aby opakování kvůli síti nikdy neodeslalo stejný e-mail dvakrát. Viz Idempotentní požadavky. - Ošetřete chyby. Odpovědi
429a5xxopakujte s rostoucím odstupem a respektujte hlavičkuretry-after. Ostatní odpovědi4xxneopakujte, dokud požadavek neopravíte. Viz Chyby a Limity rychlosti. - Ukládejte ID e-mailů z každé odpovědi (
idaids, když je příjemců víc), abyste mohli párovat webhookové události se svými záznamy.
Seznamy a soulad s předpisy
- Pokud přecházíte od jiného poskytovatele, naimportujte před prvním odesláním své stávající blokované adresy. Použijte Import v Email APISuppressions se souborem CSV ve tvaru
email,type,reason. Řádky s typemrecipientblokují všechny druhy odesílání. Viz Správa blokovaných adres. - Zkontrolujte automatické blokování adres v WorkspaceSettings v sekci Suppressions. Workspace s tarifem Pro a Business mohou změnit, která nedoručení a stížnosti se blokují.
- Do hromadné pošty přidejte hlavičky pro odhlášení. Kampaně přidávají hlavičky
List-Unsubscribea hlavičky pro odhlášení jedním kliknutím za vás. Pokud posíláte newslettery nebo propagační e-maily přes API nebo SMTP, přidejteList-UnsubscribeaList-Unsubscribe-Post: List-Unsubscribe=One-Clicksami a vyhovte každé žádosti. Viz Hlavičky a metadata. - Posílejte e-maily jen lidem, kteří o ně požádali. Nevyžádané e-maily nejsou povolené. Staré nebo koupené seznamy před importem zkontrolujte ověřováním e-mailů, nebo je raději vůbec neimportujte.
Postupné navyšování a sledování
- Zahřívejte postupně. Začněte s nejaktivnějšími příjemci a objem zvyšujte během dnů, ne hodin, zejména u nové domény nebo dedikované IP adresy. Viz Zahřívání.
- Sledujte kondici odesílání. Emailit hodnotí každou doménu a workspace podle míry nedoručení, jakmile odesílání zasáhne alespoň 100 unikátních příjemců. Nad 4 % je doména ohrožená, nad 5 % se odesílání z domény pozastaví a při 6 % a více se workspace zablokuje. Viz Kondice odesílání.
- Vězte, kam se dívat. Email APIEmails ukazuje stav každého e-mailu, pokusy o doručení a kontroly spamu. Email APILogs ukazuje každý požadavek přes API a SMTP. Email APIAnalytics ukazuje trendy. Kvůli incidentům sledujte status.emailit.com.
Testovací odeslání
- Posílejte do skutečných schránek v Gmailu, Outlooku a Yahoo. Zkontrolujte, že zpráva dorazí do doručené pošty, že SPF, DKIM a DMARC ukazují v hlavičkách zprávy
passa že odkazy a obrázky fungují na mobilu. Pro rychlý jednorázový test bez kódu použijte Compose na stránce Email APIEmails. - Zkontrolujte skóre spamu na stránce každého testovacího e-mailu v sekci Spam Checks. Zprávy se skóre 7 a vyšším se zadrží a nedoručí.
- Otestujte každou šablonu s realistickými daty, včetně chybějících hodnot. Temple nahradí chybějící proměnnou prázdným řetězcem, pokud jí nedáte výchozí hodnotu, například
{{first_name|"there"}}. Viz Šablonovací jazyk Temple.