Reference

Hlavičky a odpovědi SMTP

Které hlavičky Emailit u pošty přes SMTP přidává, přepisuje nebo odstraňuje, jak z odpovědi 250 přečíst ID e-mailů a jak sami přidat List-Unsubscribe.

Aktualizováno 1. 10. 2026

Emailit předává zprávu MIME, kterou odešlete přes SMTP, většinou beze změny, ale upraví několik hlaviček, aby zpráva prošla ověřením a dala se měřit. Tato stránka tyto změny uvádí, vysvětluje odpověď 250, která obsahuje nová ID e-mailů, a popisuje hlavičky, které musíte přidat sami.

Hlavičky, které Emailit přidává nebo přepisuje

Hlavička	Co Emailit dělá
`Received`	Přidá trasovací hlavičky pro relay a pro poštovní server Emailitu, který zprávu doručuje.
`Message-ID`	Nahradí vaši hodnotu za `<token@your-domain>`, kde doména je ta z vaší adresy odesílatele. Kopie pro každého příjemce dostane vlastní Message-ID.
`Date`	Nastaví ji, když Emailit zprávu poprvé zpracovává k doručení.
`Subject`	Přepíše ji z dekódovaného předmětu a znovu zakóduje znaky mimo ASCII.
`Return-Path`	Nastaví adresu pro nedoručené zprávy na vaší subdoméně return path, `emailit.<your-domain>`. Stejná adresa se použije jako odesílatel v obálce, takže SPF pro vaši doménu projde.
`X-Emailit-ID`	Přidá token e-mailu.
`Feedback-ID`	Přidá identifikátor, který poskytovatelé schránek používají v hlášeních o stížnostech.
`DKIM-Signature`	Podepíše zprávu klíčem DKIM vaší domény (ve výchozím stavu selektor `emailit`). Pro feedback loopy se stížnostmi může přibýt druhý podpis pro `emailitmail.com`.

Podpis DKIM pokrývá mimo jiné hlavičky From, To, Cc, Subject, Date, Message-ID, Reply-To, hlavičky MIME a List-*. Po podepsání Emailitem zprávu neměňte, například e-mailovou konferencí, která přepisuje předmět, jinak podpis neprojde.

Hlavičky, které Emailit odstraňuje

Hlavička	Kdy
`Bcc`	Vždy, aby příjemci skryté kopie zůstali skrytí.
`Reply-To`	Když uvádí stejnou adresu jako `From`. Některé spamové filtry nadbytečnou hlavičku Reply-To penalizují.
`Content-Disposition`	Na nejvyšší úrovni zprávy. Části s přílohami si ji ponechávají.

Vše ostatní, včetně vašich vlastních hlaviček X-, se doručí beze změny.

Řídicí hlavičky se přes SMTP nečtou

Do zpráv, které odesíláte, nevkládejte hlavičku X-Emailit-ID. Emailit podle ní poznává zprávy, které už zpracoval, a zpráva, která ji má, přeskočí přepis hlaviček a podepsání DKIM popsané výše.

Odpověď 250

Když relay zprávu přijme, jeho odpověď na konec DATA uvádí ID e-mailů, která Emailit vytvořil, jedno pro každého příjemce:

Text

250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa, em_33VtK8nB5rTq0YxW3mJk9PdLsUe

2.0.0 je rozšířený stavový kód pro úspěch.
Každé ID em_ je stejné ID, jaké pro e-mail daného příjemce používá API, webové rozhraní a webhooky.
Řádek odpovědi má omezenou délku. Pokud se všechna ID nevejdou, k čemuž dochází zhruba od 15 příjemců, odpověď obsahuje jen první ID. Ostatní najdete v Email APIEmails nebo ve webhookových událostech.

Většina knihoven odpověď zpřístupňuje. V Nodemaileru je to info.response. V PHPMaileru zavolejte po send() metodu $mail->getSMTPInstance()->getLastReply(). Uložte si ID ke svému záznamu, abyste mohli párovat webhookové události, nebo e-mail později dohledat endpointem Načtení e-mailu.

Přidejte List-Unsubscribe sami

Emailit přidává hlavičky List-Unsubscribe jen do e-mailů z kampaní. Pokud přes SMTP posíláte newslettery nebo jinou hromadnou poštu, přidejte do zprávy obě hlavičky sami:

Text

List-Unsubscribe: <https://acme.com/unsubscribe?u=881&l=digest>, <mailto:unsubscribe@acme.com?subject=unsubscribe-881>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

URL s https musí přijímat POST s tělem List-Unsubscribe=One-Click a osobu odhlásit bez potvrzovacího kroku (RFC 8058). Emailit obě hlavičky zahrne do podpisu DKIM, což Gmail a Yahoo pro odhlášení jedním kliknutím vyžadují.

JavaScript

await transporter.sendMail({
  from: 'Acme <news@acme.com>',
  to: 'ada@example.com',
  subject: 'Acme weekly digest',
  html: '<p>This week at Acme…</p>',
  headers: {
    'List-Unsubscribe': '<https://acme.com/unsubscribe?u=881&l=digest>',
    'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
  },
});

Python

msg["List-Unsubscribe"] = "<https://acme.com/unsubscribe?u=881&l=digest>"
msg["List-Unsubscribe-Post"] = "List-Unsubscribe=One-Click"

PHP

$mail->addCustomHeader('List-Unsubscribe', '<https://acme.com/unsubscribe?u=881&l=digest>');
$mail->addCustomHeader('List-Unsubscribe-Post', 'List-Unsubscribe=One-Click');

Nastavení SMTP
Hlavičky a metadata pro odesílání přes API
Slovník e-mailových hlaviček
Měření otevření a prokliků