Rychlý start

Stručná verze pro ty, kdo chtějí jen kontrolní seznam. Každý bod odkazuje na odpovídající krok Návodu, kde je vše vysvětlené i se snímky obrazovky.

1. Účet a organizace

• Zaregistrujte se na app.frontmail.dev e-mailem a heslem, přes Google nebo GitHub. Potvrďte svou e-mailovou adresu – do té doby si můžete dashboard prohlížet, ale ne odesílat.
• Založte organizaci: vyplňte pole Název organizace a Fakturační země (určuje DPH a měnu), u otázky Co budete posílat? zvolte Kontaktní formulář, Transakční e-maily nebo Něco jiného a klikněte na Založit organizaci.
• Máte tarif Free s 300 požadavky na tento měsíc. Frontmail vám ukáže první privátní klíč – jen jednou. Uložte si ho do správce hesel nebo do serverových secrets; potřebujete ho jen pro odesílání ze serveru. Pak klikněte na Pokračovat v nastavení.

2. Šest kroků nastavení

Stránka Začínáme vás provede šesti kroky. Kterýkoli můžete přeskočit (Přeskočit krok, Přeskočit nastavení) a vrátit se k němu později.

1. Připojte e-mailovou službu – E-mailové služby → Přidat službu, vyberte poskytovatele, vyplňte přihlašovací údaje (u Gmailu a Outlooku Připojení přes účet) a Ověřit a uložit. → Návod, krok 1
2. Vytvořte šablonu – Šablony → Z galerie → Kontaktní formulář → Použít šablonu. Komu je předvyplněné na vaši adresu, Odpovědět na na návštěvníka. → Návod, krok 2 (a krok 3 pro automatickou odpověď)
3. Povolte svůj web – Zabezpečení → Povolené weby → Přidat doménu, např. example.com, *.example.com nebo localhost:3000, a Uložit. Doporučujeme také přidat klíče vlastního bezplatného widgetu Cloudflare Turnstile v kartě Ochrana proti botům (Turnstile) a kliknout na Zapnout CAPTCHA u všech šablon. → Návod, krok 4
4. Pošlete si testovací e-mail – v editoru Poslat test. Zdarma, 20 denně. → Návod, krok 6
5. Vložte ji na web – zkopírujte kód z karty šablony Kód pro web (HTML / JS, React, Vue, Svelte, Node.js, cURL). → Návod, krok 5
6. Zabezpečení a tým – volitelně si zapněte dvoufázové ověření a pozvěte kolegy (Tým).

3. Odeslání z kódu

Karta Kód pro web doplní váš veřejný klíč i ID. Kód v prohlížeči používá veřejný klíč (pk_…), servery privátní klíč (sk_…):

Prohlížeč (npm)

npm install @frontmail/browser

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

init({ publicKey: 'pk_…' });

const result = await send('svc_…', 'tpl_…', {
  name: 'Jana Nováková',
  email: 'jana@example.cz',
  message: 'Dobrý den, prosím o cenovou nabídku.',
});
console.log(result.status); // "queued" (nebo "held", pokud vám došly kredity)

Šablona se zapnutým Vyžadovat CAPTCHA (Turnstile) potřebuje i token Turnstile – kompletní formulář se sendForm() najdete v kroku Postavte formulář.

Server (cURL)

curl https://api.frontmail.dev/v1/send \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_…' \
  -d '{
    "service_id": "svc_…",
    "template_id": "tpl_…",
    "template_params": { "name": "Jana", "email": "jana@example.cz", "message": "Dobrý den!" }
  }'

Požadavky s privátním klíčem kontrolu originu a CAPTCHA přeskakují. Viz Přehled API.

API odpoví 202 Accepted s message_id; e-mail pak sledujte v Historii.

Upozornění

Privátní klíč (sk_…) nikdy nevkládejte do frontendového kódu. Viz Veřejný a privátní klíč.

Chcete to raději krok za krokem?Návod postaví kontaktní formulář s automatickou odpovědí postupně a se snímky obrazovky.