Rýchly štart

Skrátená verzia pre tých, ktorí chcú len kontrolný zoznam. Každý bod odkazuje na zodpovedajúci krok Tutoriálu, ktorý ho vysvetľuje aj so snímkami obrazovky.

1. Účet a organizácia

• Zaregistrujte sa na app.frontmail.dev e-mailom a heslom, cez Google alebo GitHub. Potvrďte svoju e-mailovú adresu – dovtedy sa môžete rozhliadnuť, ale nie posielať.
• Vytvorte organizáciu: vyplňte Názov organizácie, Krajina fakturácie (určuje DPH a menu) a Čo budete posielať? (Kontaktný formulár, Transakčné e-maily alebo Niečo iné) a kliknite na Vytvoriť organizáciu.
• Ste v tarife Free s 300 požiadavkami na tento mesiac. Frontmail vám ukáže prvý súkromný kľúč – iba raz. Skopírujte si ho do správcu hesiel alebo do tajných premenných servera; potrebujete ho len na posielanie zo servera. Potom kliknite na Pokračovať v nastavení.

2. Šesť krokov nastavenia

Stránka Začíname vás prevedie šiestimi krokmi. Ktorýkoľvek z nich môžete preskočiť (Preskočiť tento krok, Preskočiť nastavenie) a vrátiť sa k nemu neskôr.

1. Pripojte e-mailovú službu – E-mailové služby → Pridať službu, vyberte poskytovateľa, vyplňte prístupové údaje (alebo pri Gmaile / Outlooku Pripojiť cez váš účet) a kliknite na Overiť a uložiť. → Krok 1 tutoriálu
2. Vytvorte šablónu – Šablóny → Z galérie → Kontaktný formulár → Použiť šablónu. Pole Komu je predvyplnené vašou adresou, Reply-To adresou návštevníka. → Krok 2 tutoriálu (a krok 3 pre automatickú odpoveď)
3. Povoľte svoj web – Zabezpečenie → Povolené weby → Pridať doménu, napr. example.com, *.example.com alebo localhost:3000, potom Uložiť. Odporúčame: v sekcii Ochrana pred botmi (Turnstile) pridajte kľúče vlastného bezplatného widgetu Cloudflare Turnstile a kliknite na Zapnúť CAPTCHA pre všetky šablóny. → Krok 4 tutoriálu
4. Pošlite testovací e-mail – v editore kliknite na Poslať test. Zadarmo, 20 za deň. → Krok 6 tutoriálu
5. Pridajte ho na web – skopírujte kód zo karty Kód v šablóne (HTML / JS, React, Vue, Svelte, Node.js, cURL). → Krok 5 tutoriálu
6. Zabezpečte účet a pozvite tím – voliteľne si zapnite dvojstupňové overenie a pozvite kolegov (Tím).

3. Odosielanie z kódu

Karta Kód doplní váš verejný kľúč aj ID. Kód v prehliadači používa verejný kľúč (pk_…), servery súkromný kľúč (sk_…):

Prehliadač (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.sk',
  message: 'Dobrý deň, prosím o cenovú ponuku.',
});
console.log(result.status); // "queued" (alebo "held", ak sa vám minuli kredity)

Šablóna s voľbou Vyžadovať CAPTCHA (Turnstile) potrebuje aj token Turnstile – kompletný formulár so sendForm() nájdete v kroku Vytvorte formulár.

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.sk", "message": "Dobrý deň!" }
  }'

Požiadavky so súkromným kľúčom preskakujú kontrolu originu aj CAPTCHA. Pozrite si referenčnú príručku API.

API odpovie 202 Accepted s message_id; e-mail potom sledujte v sekcii História.

Upozornenie

Súkromný kľúč (sk_…) nikdy nevkladajte do frontendového kódu. Pozrite si Verejné a súkromné kľúče.

Radšej krok za krokom?Tutoriál postupne vytvorí kontaktný formulár s automatickou odpoveďou, so snímkami obrazovky.