Preskočiť na obsah
Frontmail Docs

Prehľad a základné pojmy

Frontmail vám umožní posielať e-maily priamo z frontendu – kontaktný formulár, žiadosť o rezerváciu, potvrdenie objednávky – bez vlastného backendu. Pripojíte poskytovateľa e-mailu, ktorého už používate, v dashboarde navrhnete HTML šablónu s typovanými parametrami a zavoláte jedinú funkciu:

import { init, send } from '@frontmail/browser';


init({ publicKey: 'pk_4f2a…' });
await send('svc_01J9…', 'tpl_01J9…', { name: 'Jana', message: 'Dobrý deň!' });

Požiadavka príde na Frontmail API, ktoré ju skontroluje (origin, ochrana pred botmi, rate limity, validácia parametrov), zarezervuje jeden kredit a zaradí e-mail do fronty. Odosielač potom vyrenderuje šablónu a doručí ju cez vášho poskytovateľa. Udalosti doručenia (doručené, vrátené, otvorené…) sa cez webhooky poskytovateľa vracajú do vašej histórie a štatistík.

Stavebné kamene

Section titled “Stavebné kamene”

Organizácia

Section titled “Organizácia”

Všetko – kľúče, služby, šablóny, kredity, členovia – patrí organizácii. Jeden používateľ môže byť členom viacerých organizácií a prepínať medzi nimi. Každá organizácia má svoj tarif a vlastný zostatok kreditov.

Verejný a súkromný kľúč

Section titled “Verejný a súkromný kľúč”
Verejný kľúč pk_… Súkromný kľúč sk_…
Kde je uložený Vo vašom frontendovom kóde – nie je tajný Iba na vašom serveri – zaobchádzajte s ním ako s heslom
Ako sa posiela user_id v tele požiadavky alebo hlavička X-Frontmail-Public-Key Authorization: Bearer sk_… (alebo accessToken v tele) – nikdy z prehliadača: požiadavky s hlavičkou Origin sú odmietnuté
Čo ho chráni Povolené domény, Turnstile, rate limity, ochrana pred botmi Jeho utajenie – preskakuje kontrolu originu aj CAPTCHA
Čo dokáže send, send-form, nahrávanie súborov, stav vlastných správ Všetko uvedené a navyše send-batch, history, templates

Keďže verejný kľúč vidí každý, kto otvorí vašu stránku, Frontmail mu nikdy nedôveruje samotnému. Pred spustením do prevádzky si prečítajte Verejné a súkromné kľúče.

Služby

Section titled “Služby”

Služba je pripojenie k poskytovateľovi e-mailu: SMTP (Seznam, Zoho, vlastný server), Mailgun, Amazon SES, Postmark, Mailjet, Brevo, Resend, Gmail alebo Outlook / Microsoft 365. Prístupové údaje sú šifrované cez AWS KMS. Frontmail každú službu kontroluje denne a hneď po chybe autentifikácie a šablóna môže mať záložnú službu, ktorá prevezme odosielanie, keď primárna zlyhá. Pozrite si Prehľad služieb.

Šablóny

Section titled “Šablóny”

Šablóna je plnohodnotný HTML e-mail (s vygenerovanou textovou verziou) spolu s predmetom, príjemcami (To, CC, BCC, Reply-To, From) a schémou parametrov. Parametre sú typované (string, email, number, date, list…) a validujú sa pri každom odoslaní; telo používa Handlebars pre podmienky, cykly a formátovacie helpery. Pozrite si HTML šablóny a Parametre a typy.

Kredity

Section titled “Kredity”

Jeden prijatý e-mail = jeden kredit. Kredity pochádzajú z grantov:

  • subscription – mesačná kvóta vášho tarifu (neprenáša sa do ďalšieho obdobia),
  • pack – predplatené kreditové balíky s platnosťou 3–12 mesiacov, dostupné v každom tarife vrátane Free,
  • bonus – kredity pridané podporou Frontmailu,
  • overdraft – 10 % rezerva (prečerpanie) v platených tarifoch, fakturovaná na ďalšej faktúre.

Kredity sa vždy berú z grantu, ktorému platnosť vyprší najskôr, prečerpanie ako posledné. Testovacie odoslania z editora šablón sú zadarmo. Ak odoslanie trvalo zlyhá, kredit sa vráti. Pozrite si Poradie čerpania.

Žiadny e-mail sa potichu nestratí

Section titled “Žiadny e-mail sa potichu nestratí”

Keď sa vám minú kredity, Frontmail váš e-mail nezahodí. V predvolenom režime hold prijme požiadavku s odpoveďou 202 { "status": "held" }, správu uloží a odošle ju automaticky, len čo budú kredity opäť k dispozícii – po kúpe balíka, automatickom dobití, prechode na vyšší tarif alebo v ďalšom fakturačnom období. Prečítajte si Fronta pozdržaných e-mailov.

Životný cyklus správy

Section titled “Životný cyklus správy”
accepted ─┬─► queued ─► sending ─► sent ─┬─► delivered
          │                              ├─► bounced
          │                              └─► complained
          ├─► held (bez kreditov) ─► queued …   alebo ─► discarded (pozdržanie vypršalo / ručne)
          └─► (pri chybe autentifikácie u poskytovateľa) held_service_error ─► queued … po oprave služby
                                     failed (trvalá chyba, kredit vrátený)

Všetky stavy sú vysvetlené v časti Stavy správ.

Ďalšie kroky

Section titled “Ďalšie kroky”