Reference
Hlavičky e-mailu
K čemu slouží běžné hlavičky e-mailu, od From a Reply-To po DKIM-Signature a List-Unsubscribe, a které z nich Emailit při odesílání přidává, přepisuje nebo odstraňuje.
Hlavičky jsou řádky ve tvaru Name: value na začátku každého e-mailu. Nesou odesílatele, příjemce, předmět, historii směrování a výsledky ověření. Tato stránka vysvětluje hlavičky, které budete nejspíš zkoumat nebo nastavovat, a co s každou z nich Emailit dělá, když odesílá vaši poštu.
Obálka a hlavičky
E-mail má dvě sady adres a ty se nemusejí shodovat:
| Obálka | Hlavičky | |
|---|---|---|
| Odesílatel | MAIL FROM, adresa pro nedoručitelné zprávy. Emailit ji nastavuje na váš return path, adresu na emailit.yourdomain.com. |
From, adresa, kterou vidí příjemci. Nastavujete ji vy. |
| Příjemci | RCPT TO, kam server poštu skutečně doručí. |
To a Cc, které vidí příjemci. Bcc se nikdy nezobrazuje. |
Přijímající servery kontrolují SPF vůči odesílateli v obálce a DKIM vůči podpisu a pak DMARC zkontroluje, že alespoň jedna z těchto domén je zarovnaná s hlavičkou From.
Jak nastavit hlavičky
- E-mailové API. Použijte pole
from,to,cc,bcc,reply_toasubjecta jakoukoli další hlavičku předejte v objektuheaders. Viz Hlavičky a metadata. - SMTP. Emailit odešle MIME zprávu, kterou vaše aplikace předá, se změnami uvedenými níže. Viz Hlavičky SMTP.
Přehled hlaviček
Sloupec Emailit uvádí, jestli Emailit hlavičku přidává, přepisuje nebo odstraňuje, nebo ji nechává na vás.
Adresy a předmět
| Hlavička | Účel | Emailit |
|---|---|---|
From |
Adresa a zobrazované jméno autora, které vidí příjemci. | Nastavujete ji vy. Musí používat ověřenou odesílací doménu workspace, porovnávanou bez ohledu na velikost písmen. Jinak API vrátí 422 a SMTP 530. |
Sender |
Adresa, která zprávu skutečně odeslala, když se liší od From, například asistent odesílající za manažera. |
Předá se beze změny. Emailit kontroluje jen From. |
Reply-To |
Kam chodí odpovědi místo na adresu From. |
Nastavujete ji vy. Emailit ji odstraní, když obsahuje stejné adresy jako From, protože to spamové filtry penalizují. |
To |
Hlavní příjemci, viditelní pro všechny. | Nastavujete ji vy. Každý příjemce dostane samostatnou kopii s vlastním ID e-mailu. |
Cc |
Viditelní příjemci kopie. | Nastavujete ji vy. Každý příjemce dostane samostatnou kopii. |
Bcc |
Skrytí příjemci kopie. | Před doručením se ze zprávy odstraní. Příjemci skryté kopie přesto svou kopii dostanou. |
Subject |
Předmět. | Nastavujete ho vy. Emailit kóduje znaky mimo ASCII (RFC 2047), aby se diakritika a nelatinková písma zobrazovala správně. |
Date |
Kdy byla zpráva napsána. | Emailit ho nastaví na čas, kdy zprávu odešle. |
Identifikace a vlákna
| Hlavička | Účel | Emailit |
|---|---|---|
Message-ID |
Globálně jedinečné ID zprávy ve tvaru <id@domain>. |
Emailit ho nastaví na ID na vaší odesílací doméně a nahradí jím jakoukoli hodnotu, kterou pošlete. API ho vrací jako message_id. |
In-Reply-To |
Message-ID zprávy, na kterou se odpovídá. Poštovní klienti ho používají k řazení konverzací do vláken. |
Předá se. Nastavte ho v poli headers nebo ve své MIME zprávě. |
References |
Řetězec hodnot Message-ID ve vlákně. |
Předá se. |
Směrování a trasování
| Hlavička | Účel | Emailit |
|---|---|---|
Return-Path |
Odesílatel v obálce, kterého obvykle přidá přijímající server při konečném doručení. | Emailit ho nastaví na adresu na emailit.yourdomain.com, aby zprávy o nedoručení docházely do Emailitu a SPF se kontrolovalo vůči vaší doméně. Změnit ho nemůžete. |
Received |
Jeden řádek za každý server, kterým zpráva prošla, nejnovější první. Užitečné při hledání zpoždění. | Přidává ho API nebo SMTP relay Emailitu a jeho MTA. SMTP relay odmítne zprávu s 550 Loop detected, pokud jím prošla víc než 4krát. |
Struktura MIME
| Hlavička | Účel | Emailit |
|---|---|---|
MIME-Version |
Deklaruje, že zpráva používá MIME, vždy 1.0. |
API ho generuje. Přes SMTP se předá. |
Content-Type |
Typ těla nebo části, například text/html, multipart/alternative nebo multipart/mixed, a jeho znaková sada. |
API ho generuje z html, text a attachments. Přes SMTP se předá. |
Content-Transfer-Encoding |
Jak je část kódovaná pro přenos, například quoted-printable, base64 nebo 7bit. |
API ho generuje. Přes SMTP se předá. |
Ověření
| Hlavička | Účel | Emailit |
|---|---|---|
DKIM-Signature |
Kryptografický podpis těla a vybraných hlaviček, ověřovaný vůči veřejnému klíči v DNS. | Emailit ho přidá s d= nastaveným na vaši doménu a selektorem emailit a navíc druhý podpis pro emailitmail.com, který poskytovatelé schránek používají pro feedback loopy. |
Authentication-Results |
Výsledky kontrol SPF, DKIM a DMARC na přijímajícím serveru. | Přidává ho server příjemce, ne Emailit. Při ladění ověření si ho přečtěte v kopii příjemce. |
ARC-Seal, ARC-Message-Signature, ARC-Authentication-Results |
Authenticated Received Chain: přeposílající servery a e-mailové konference zaznamenávají výsledky ověření, které viděly, aby jim další servery mohly důvěřovat. | Emailit je nepřidává. Přidávají je prostředníci, kteří vaši poštu přeposílají. |
Seznamy a automatická pošta
| Hlavička | Účel | Emailit |
|---|---|---|
List-Unsubscribe |
Odkaz mailto: nebo https:, díky kterému mohou poskytovatelé schránek zobrazit tlačítko pro odhlášení. |
Přidává se do každého e-mailu z kampaně a odkazuje na hostovanou odhlašovací stránku. U pošty z API nebo SMTP přidejte vlastní v poli headers nebo ve své MIME zprávě. |
List-Unsubscribe-Post |
Nastavená na List-Unsubscribe=One-Click umožňuje odhlášení jedním kliknutím (RFC 8058). Gmail a Yahoo ji u hromadné pošty vyžadují. |
Přidává se do každého e-mailu z kampaně spolu s List-Unsubscribe. |
Feedback-ID |
Identifikátor, který poskytovatelé schránek uvádějí v datech o stížnostech, aby je odesílatelé mohli seskupit. | Emailit ho přidává do každé zprávy ve tvaru :campaign-id:workspace-id:Emailit. |
Precedence |
Starší nápověda, například bulk nebo list, kterou respektují některé automatické odpovídače. |
Nepřidává se. Můžete ji nastavit sami. |
Auto-Submitted |
Označuje zprávu jako automaticky vytvořenou, například auto-generated nebo auto-replied, aby na ni jiné systémy neodpovídaly. |
Nepřidává se. Nastavte ji u automatických odpovědí, abyste předešli zacyklení pošty. |
Hlavičky Emailitu
| Hlavička | Účel | Emailit |
|---|---|---|
X-Emailit-ID |
Interní token e-mailu. Emailit ho používá k párování zpráv o nedoručení s původním e-mailem. | Přidává se do každé zprávy. Pokud poštu z Emailitu předáváte přes jiný systém, tuto hlavičku neodstraňujte. |
X-Emailit-Tag |
Starší hlavička pro označování e-mailů štítky. | Emailit ji nečte. Předá se jako jakákoli vlastní hlavička. |
X-Emailit-Meta |
Metadata e-mailu v kódování base64. | API ji přidá, když pošlete meta. Zůstává v doručené zprávě, takže do metadat nedávejte tajné údaje. |
X-Emailit-Tracking |
Nastavení měření otevření a prokliků e-mailu. | API ji přidá, když u odeslání zapnete měření. |