Fronta pozdržaných e-mailov

Žiadny e-mail sa nikdy potichu nezahodí. Keď Frontmail nemôže správu odoslať hneď – pretože vašej organizácii došli kredity alebo pretože vaša e-mailová služba odmietla prihlasovacie údaje –, správu prijme, bezpečne ju uloží do fronty pozdržaných e-mailov (v dashboarde Pozdržané správy) a odošle ju automaticky, hneď ako je problém vyriešený.

Kedy sa správy pozdržia

Dôvod	Stav	Príčina
Chýbajú kredity	held	Žiadny grant nemá zostávajúce kredity (kvóta, balíky aj prečerpanie sú vyčerpané) a organizácia používa režim `hold`
Chyba služby	held_service_error	Poskytovateľ odmietol prihlasovacie údaje (chyba autentifikácie) a šablóna nemá funkčnú záložnú službu

Pri pozdržaní pre kredity API odpovie okamžite:

HTTP/1.1 202 Accepted

{ "message_id": "msg_01J9Z3K7Q2", "status": "held", "status_token": "…" }

SDK vrátia výsledok so status: 'held' – je to úspech, nie chyba. Návštevníkovi zobrazte bežné potvrdenie; e-mail odíde, keď budú kredity k dispozícii.

Pozdržanie pre službu nastáva až neskôr, v odosielači: správa bola prijatá ako queued, poskytovateľ odmietol prihlasovacie údaje, kredit sa vrátil a správa prešla do stavu held_service_error.

Ako dlho sa správy držia

Tarif	Doba pozdržania
Free	3 dni
Starter, Pro, Business	14 dní

Doba sa počíta od okamihu, keď bola správa pozdržaná, podľa tarifu, ktorý máte v tej chvíli. Keď pozdržaným správam zostáva do vypršania menej ako 24 hodín, vlastník, administrátori a členovia s rolou Fakturácia dostanú e-mail „Pozdržané e-maily čoskoro vypršia“ (najviac raz denne). Správy, ktoré dosiahnu koniec doby pozdržania, sa zahodia (stav discarded) a tí istí ľudia dostanú e-mail s ich zoznamom a odkazom na stiahnutie úplného zoznamu v CSV. Žiadna pozdržaná správa sa nezahodí bez toho, aby o tom niekto vedel.

Limit fronty pozdržaných e-mailov

Jedna organizácia môže mať pozdržaných najviac 10 % mesačnej kvóty svojho tarifu – najmenej 1 000 a najviac 10 000 správ (Free, Starter, Pro: 1 000; Business 50k: 5 000; Business 100k a 200k: 10 000). Keď je fronta plná, nové požiadavky bez kreditu sa namiesto pozdržania odmietnu s 402 insufficient_credits a details.reason: "hold_queue_full". Kto si skopíruje váš verejný kľúč, tak nemôže frontu zaplniť nezmyslami, ktoré by – uvoľňované od najstaršej – spotrebovali každý nový kredit skôr než vaše skutočné správy. Miesto uvoľníte tak, že pozdržané správy uvoľníte alebo zahodíte, prípadne dokúpite kredity.

Automatické uvoľnenie

Frontmail frontu uvoľní automaticky vždy, keď pribudnú kredity:

kúpite kreditový balík,
prebehne automatické dobitie,
prejdete na vyšší tarif,
začne nové fakturačné obdobie (obnovenie predplatného; Free: nový kalendárny mesiac),
podpora Frontmailu pridá bonusové kredity.

…a pri správach v stave held_service_error aj vtedy, keď služba znova funguje (aktualizované prihlasovacie údaje, opätovne pripojený OAuth alebo úspešná kontrola stavu).

Uvoľňovanie spracúva pozdržané správy od najstaršej. Pre každú správu rezervuje kredit, vráti ju do stavu queued a odovzdá ju odosielaču. Zastaví sa pri prvej správe, na ktorú už kredit nie je – ostatné zostanú pozdržané, stále v rovnakom poradí. Uvoľňovanie môže bežať súbežne; žiadna správa sa neodošle dvakrát.

Správy odoslané s verejným kľúčom sa automaticky uvoľňujú len z iných kreditov než z prečerpania, pokiaľ prevádzke s verejným kľúčom jeho použitie nepovolíte v časti Fakturácia → Kúpiť kredity → Výdavky z prevádzky s verejným kľúčom. Ak zostáva už len prečerpanie, takéto správy zostanú pozdržané, zatiaľ čo ostatné sa uvoľnia. Ručné uvoľnenie v dashboarde môže prečerpanie použiť aj pre ne.

Pozdržané správy sa vykreslia verziou šablóny, ktorá bola aktuálna v čase ich prijatia.

Ručné uvoľnenie a zahodenie

Stránka Pozdržané správy v dashboarde zobrazuje všetky pozdržané správy od najstaršej so stĺpcami Pozdržané od, šablóna (s predmetom), príjemca, Dôvod a Platnosť do. Riadky, ktorým platnosť vyprší do 24 hodín, sú zvýraznené. Podľa dôvodu môžete filtrovať pomocou Všetky / Chýbajú kredity / Chyba služby. Vlastníci, administrátori a vývojári môžu:

Uvoľniť N – uvoľniť vybrané správy. Hodí sa po oprave služby alebo keď máte len pár kreditov a chcete najskôr poslať najdôležitejšie správy. Správy sa uvoľňujú od najstaršej, kým sú kredity; ostatné zostanú pozdržané a dashboard vás na to upozorní.
Uvoľniť všetky – uvoľniť všetky pozdržané správy od najstaršej, pokiaľ to kredity dovolia.
Zahodiť N – po potvrdení zahodiť vybrané správy. Nikdy sa neodošlú a kredity nespotrebujú. Túto akciu nemožno vrátiť.

Vlastníci a členovia s rolou Fakturácia na stránke vidia aj tlačidlo Kúpiť kredity. Ak vaša organizácia používa režim reject, stránka upozorní, že nové požiadavky sa namiesto pozdržania odmietajú.

Horná lišta dashboardu vždy ukazuje, koľko kreditov zostáva (Zostáva N požiadaviek). Po kliknutí uvidíte rozpis podľa zdroja (predplatné, kreditové balíky, bonus, prečerpanie) a najbližšiu expiráciu. Keď sú nejaké správy pozdržané, zobrazí sa vedľa neho červený odznak s ich počtom, ktorý vedie na Pozdržané správy.

Režim `hold` vs. `reject`

Každá organizácia si v časti Zabezpečenie → Keď vám dôjdu kredity (vlastníci a administrátori) volí, čo sa stane, keď nemá kredity:

Režim	Odpoveď	Kedy ho použiť
Pozdržať e-maily (`hold`, predvolený, odporúčaný)	`202` so `status: "held"`, správa sa uloží a odošle neskôr	Radšej doručiť neskôr ako nikdy – kontaktné formuláre, objednávky, rezervácie
Odmietať požiadavky (`reject`)	`402` `insufficient_credits`, nič sa neuloží	Neskoré doručenie je horšie ako žiadne (jednorazové kódy, časovo citlivé upozornenia) a váš kód chybu ošetrí

V režime reject SDK vyhodia InsufficientCreditsError. Pozdržanie pre službu (held_service_error) nastáva v oboch režimoch, pretože požiadavka už bola prijatá.

Upozornenia

E-mail	Kedy	Komu
E-maily čakajú – došli vám kredity	Keď sa v kalendárnom mesiaci pozdrží prvá správa	vlastník, administrátori, fakturácia
Pozdržané e-maily čoskoro vypršia	Najviac raz denne, kým pozdržaným správam zostáva do vypršania menej ako 24 hodín	vlastník, administrátori, fakturácia
Pozdržané e-maily boli zahodené	Po vypršaní, so zoznamom zahodených správ a odkazom na CSV	vlastník, administrátori, fakturácia
Služba nefunguje / opäť funguje	Keď služba neprejde autentifikáciou / keď sa zotaví	vlastník, administrátori

Všetky e-maily nájdete v časti Upozornenia.

Kontrola stavu z kódu

const res = await send('svc_01J9…', 'tpl_order', params);
if (res.status === 'held') {
  // Prijatá a v bezpečí – odošle sa automaticky.
}

// Neskôr (klienti s verejným kľúčom potrebujú status token z výsledku odoslania):
const status = await getStatus(res.messageId, { token: res.statusToken });
console.log(status.status); // "held" → "queued" → "sent" …