Preklady šablón

Šablónu môžete posielať vo viacerých jazykoch. Má jeden predvolený jazyk a až 29 jazykových verzií (prekladov). ID šablóny je vo všetkých jazykoch rovnaké – váš kód len povie, aký jazyk chce, napríklad locale: 'de', a Frontmail vyberie správnu verziu.

Nie ste obmedzení na osem jazykov dashboardu: použiť môžete akýkoľvek jazyk zapísaný značkou BCP 47, napríklad hu, nl alebo pt-BR.

Čo sa prekladá a čo je spoločné

Každá jazyková verzia má vlastný:

• Predmet,
• HTML obsah,
• Textovú verziu (automaticky vygenerovanú z HTML prekladu alebo napísanú ručne),
• Meno odosielateľa – nepovinné; ak ho necháte prázdne, použije sa meno z predvoleného jazyka.

Všetko ostatné sa nastavuje raz, v predvolenom jazyku, a zdieľajú to všetky jazyky: príjemcovia (Komu, CC, BCC, Reply-To), E-mail odosielateľa, parametre, Pri uložení vložiť CSS do atribútov, služba, nastavenia ochrany, prílohy, automatická odpoveď aj zber kontaktov.

Je to zámer: bezpečnostné pravidlá šablóny – dynamickí príjemcovia a zámok obsahu, pevné polia odosielateľa a validácia parametrov – sú na jednom mieste, takže ich žiadny preklad nemôže oslabiť. Jazyková verzia smie používať len parametre, ktoré existujú v predvolenom jazyku.

Ako pridať jazyk

Pridávať a upravovať preklady môžu roly Vlastník, Administrátor a Vývojár.

1. Otvorte šablónu. Nad kartami editora je lišta Jazyky s predvoleným jazykom (štítok Predvolený) a s jedným čipom pre každú jazykovú verziu.
2. Kliknite na Pridať jazyk.
3. V poli Jazyk vyberte jazyk zo zoznamu alebo napíšte jeho kód (napr. pt-BR) a zvoľte Použiť „pt-BR“.
4. V časti Začať z vyberte:
   • Kópia predvoleného jazyka – text preložíte sami,
   • Strojový preklad – preloží ho služba s vlastným kľúčom vašej organizácie (pozrite Strojový preklad); ak máte nastavených viac služieb, zvoľte Službu,
   • Prázdna – začnete s prázdnym predmetom a HTML.
5. Kliknite na Pridať jazyk, obsah preložte alebo skontrolujte a kliknite na Uložiť.

Kým nový jazyk neuložíte, je to len koncept (štítok nový). Strojový preklad vychádza z uloženého predvoleného jazyka – neuložené zmeny v ňom nebudú.

Úprava prekladu

Kliknutím na jazyk v lište Jazyky prepnete editor do tohto jazyka. Editor zobrazí Upravujete preklad: … a funguje ako zvyčajne:

• Obsah – predmet a karty HTML, Vizuálne a Text upravujú preklad. Vzorové údaje a náhľad sú spoločné a náhľad vykreslí preklad presne tak, ako odíde. Parametre sú tu len na čítanie (Parametre zdieľajú všetky jazyky. Upravte ich v predvolenom jazyku.).
• Nastavenia – k prekladu patrí len predmet, Meno odosielateľa a nastavenie textovej verzie; spoločné polia majú poznámku Zdieľané všetkými jazykmi.
• Kód a Poslať test majú pole Jazyk, takže si kód skopírujete alebo testovací e-mail pošlete v ľubovoľnom jazyku.

Kontroly navyše porovnávajú preklad s predvoleným jazykom: parameter, ktorý je len v preklade, je chyba (najprv ho pridajte do predvoleného jazyka), parameter použitý v predvolenom jazyku, ktorý v preklade chýba, je upozornenie.

Štítky Zastaraný a Strojový

• Zastaraný – predvolený jazyk sa od uloženia prekladu znova uložil, takže prekladu môže niečo chýbať. Odosielanie funguje ďalej. Preklad upravte a uložte, alebo – ak stále sedí – kliknite na Označiť ako aktuálny.
• Strojový – uložená verzia vznikla strojovým prekladom. Skôr než sa na ňu spoľahnete, skontrolujte ju.

Keď máte vybraný preklad, lišta ponúka aj Preložiť znova (nový strojový preklad uloženého predvoleného jazyka; nič sa neuloží, kým nekliknete na Uložiť) a Odstrániť jazyk. S odstráneným jazykom zmiznú aj jeho verzie a e-maily, ktoré si ho vyžiadajú, odídu v predvolenom jazyku.

Verzie a obnovenie

Každé uloženie prekladu vytvorí jeho novú verziu – každý jazyk má vlastné číslovanie. Keď máte vybraný preklad, karta Verzie zobrazuje Verzie prekladu … so stĺpcami Vychádza z (verzia predvoleného jazyka, ku ktorej bol preklad uložený) a Pôvod (Ručný alebo Strojový). Verzie porovnáte a staršiu Obnovíte rovnako ako pri predvolenom jazyku.

Každá správa si pamätá jazyk aj verziu prekladu, s ktorou bola vykreslená. E-maily čakajúce vo fronte pozdržaných e-mailov odídu s verziami, ktoré boli aktuálne, keď ich Frontmail prijal.

Zmena predvoleného jazyka

Predvolený jazyk nájdete v Nastavenia → Všeobecné → Predvolený jazyk. Zvoliť môžete akýkoľvek jazyk okrem takého, ktorý už má jazykovú verziu – tú najprv odstráňte.

Odoslanie v jazyku

Jazyk vždy výslovne určuje odosielateľ. Frontmail ho neodhaduje z prehliadača (Accept-Language) – ak chcete jazyk návštevníka, odovzdajte ho sami.

Ako sa jazyk vyberá

Pre požadované locale Frontmail použije:

1. bez locale → predvolený jazyk,
2. presnú zhodu (na veľkosti písmen nezáleží) → tento jazyk,
3. rovnaký základný jazyk → de-AT dostane de; pt dostane verziu pt-…, napríklad pt-BR,
4. inak → predvolený jazyk.

Neznámy jazyk nie je chyba – locale je len želanie. Odmietne sa len chybne zapísaná značka (napr. "german!"), a to chybou 400 invalid_body.

Odpoveď prezradí, ktorý jazyk sa skutočne použil:

{ "message_id": "msg_…", "status": "queued", "status_token": "…", "locale": "de" }

REST API

Pridajte locale do POST /v1/send (a do každej správy v POST /v1/send-batch):

{
  "template_id": "tpl_01J9…",
  "template_params": { "name": "Jana" },
  "locale": "de"
}

POST /v1/send-form používa vyhradené pole formulára fm_locale. Pole s názvom locale zostáva bežným parametrom šablóny, takže existujúce formuláre fungujú ďalej:

<select name="fm_locale">
  <option value="sk">Slovenčina</option>
  <option value="de">Deutsch</option>
</select>

SDK

Všetky SDK majú voľbu locale a použitý jazyk vracajú v result.locale.

Prehliadač (@frontmail/browser) – sendForm ho pošle ako fm_locale; vlastné pole fm_locale vo formulári má prednosť:

const result = await send('svc_01J9…', 'tpl_contact', { name: 'Jana' }, { locale: 'de' });
await sendForm('svc_01J9…', 'tpl_contact', '#contact', { locale: document.documentElement.lang });
console.log(result.locale); // 'de'

React (@frontmail/react) – prop locale komponentu <FrontmailForm> alebo options.locale pri send / sendForm. Vue a Svelte fungujú rovnako:

<FrontmailForm serviceId="svc_01J9…" templateId="tpl_contact" locale="de">…</FrontmailForm>

const { send } = useSendEmail('svc_01J9…', 'tpl_contact');
await send({ name: 'Jana' }, { locale: 'de' });

Node.js (@frontmail/node):

const { locale } = await frontmail.send({ templateId: 'tpl_order', params: { order_id: 'A-1042' }, locale: 'de' });
await frontmail.sendBatch([{ templateId: 'tpl_reminder', params: { name: 'Jana' }, locale: 'sk' }]);

Android / Kotlin (dev.frontmail:frontmail):

val result = frontmail.send(
    "tpl_contact",
    mapOf("name" to name),
    options = SendOptions(locale = Locale.getDefault().toLanguageTag()),
)
println(result.locale) // "de"

iOS / Swift (Frontmail pre Swift) – použite Locale.preferredLanguages.first (napr. de-AT); Locale.current.identifier obsahuje _ a platnou značkou nie je:

let result = try await frontmail.send(
    templateID: "tpl_contact",
    params: ["name": "Jan"],
    options: SendOptions(locale: Locale.preferredLanguages.first)
)
print(result.locale ?? "default") // "de"

Flutter / Dart (frontmail) – použite toLanguageTag() (napr. de-AT); Locale.toString() používa _ a platnou značkou nie je:

final result = await frontmail.send(
  templateId: 'tpl_contact',
  params: {'name': 'Jan'},
  options: SendOptions(locale: Localizations.localeOf(context).toLanguageTag()),
);
print(result.locale ?? 'default'); // "de"

V React Native použite send(params, { locale: 'de' }) z useSendEmail. npx frontmail types vypíše jazyky každej šablóny a vygeneruje pre ne typ – pozrite Node.js.

Automatické odpovede, opätovné odoslanie a EmailJS

• Automatická odpoveď sa riadi jazykom pôvodnej správy: šablóna automatickej odpovede si pre tento jazyk vyberie vlastnú jazykovú verziu podľa rovnakých pravidiel (a prípadne použije svoj predvolený jazyk).
• Odoslať znova v Histórii pošle správu znova v rovnakom jazyku, s aktuálnou verziou prekladu. Ak bol medzitým jazyk odstránený, použije sa predvolený jazyk.
• Cesty kompatibilné s EmailJS (/api/v1.0/email/…) a @frontmail/emailjs-compat posielajú vždy predvolený jazyk.

Formátovanie sa riadi jazykom e-mailu

E-mail sa vykreslí v jazyku, v ktorom odchádza. formatDate, formatNumber a formatMoney formátujú dátumy, čísla a sumy pre tento jazyk (nemecká verzia vypíše 1. Oktober 2026 a 49,00 €). Pätička Odoslané cez Frontmail v tarife Free je v jazyku e-mailu, ak je to jeden z ôsmich jazykov dashboardu, inak v angličtine.

Strojový preklad

Frontmail vám šablónu preloží pomocou OpenAI, Anthropic, Google Gemini alebo DeepL – a to s vlastným API kľúčom vašej organizácie („bring your own key“). Frontmail nikdy neprekladá na svoj účet a strojový preklad nestojí žiadne kredity Frontmailu; za použitie vám účtuje priamo daná služba.

Strojový preklad sa nikdy nespúšťa sám: prebehne len vtedy, keď v dialógu Pridať jazyk zvolíte Strojový preklad alebo kliknete na Preložiť znova. Výsledkom je koncept, ktorý pred uložením skontrolujete.

Ako nastaviť kľúč služby

Pridávať a meniť kľúče môže len Vlastník a Administrátor. Vývojár vidí, ktoré služby sú nastavené (len na čítanie), a môže ich na preklad používať.

1. Otvorte Nastavenia → Strojový preklad.
2. Pri službe kliknite na Pridať kľúč. Odkaz Získať kľúč … otvorí stránku s kľúčmi danej služby.
3. Vložte API kľúč. Pri OpenAI, Anthropic a Gemini môžete vyplniť Model (nepovinné); ak ho necháte prázdny, použije sa predvolený model služby. DeepL voľbu modelu nemá.
4. Kliknite na Uložiť kľúč. Pred uložením kľúč overíme malou požiadavkou na službu.

Ak máte viac služieb, tlačidlom Nastaviť ako predvolenú určíte, ktorá bude predvybraná. Pri každej nastavenej službe nájdete Nahradiť kľúč a Odobrať; po odobratí kľúča zostanú už uložené preklady bez zmeny.

Kľúč ukladáme šifrovane a už ho nikdy nezobrazíme – dashboard ukazuje len jeho posledné štyri znaky. Každú zmenu zaznamená Auditný záznam.

Čo sa službe posiela

Len predmet, HTML, textová verzia a meno odosielateľa uloženého predvoleného jazyka – textová verzia len vtedy, keď je písaná ručne (automatická sa vygeneruje z preloženého HTML). Nič ďalšie Frontmail neopustí: žiadni príjemcovia, hodnoty parametrov, vzorové údaje, kontakty ani história správ. Požiadavka ide zo serverov Frontmailu priamo na oficiálne API služby a na obsah sa vzťahujú podmienky danej služby.

Ako sa výsledok kontroluje

Frontmail službu žiada, aby výrazy Handlebars ({{name}}, {{#if …}}), HTML značky a atribúty, odkazy a e-mailové adresy nechala bez zmeny, a výsledok potom overí: preklad musí obsahovať presne rovnaké výrazy Handlebars a rovnaké adresy odkazov a obrázkov ako zdroj. Ak nie, výsledok sa zahodí s hláškou Strojový preklad zmenil parametre, odkazy alebo štruktúru HTML, a preto nebol použitý. (translation_invalid) – skúste to znova alebo s inou službou. Nič sa neuloží napoly.

Ďalšie chyby: translation_not_configured (nie je nastavený kľúč), translation_provider_auth (služba kľúč odmietla) a translation_provider_error (služba zlyhala – skúste to neskôr).

Limity a náklady

• 30 strojových prekladov za hodinu na organizáciu.
• 60 000 znakov zdrojového obsahu na jeden preklad; dlhšie šablóny dostanú payload_too_large.
• Preklad musí dobehnúť do 60 sekúnd.
• Náklady účtuje služba účtu, ku ktorému kľúč patrí. Prekladanie nespotrebúva kredity Frontmailu a odoslanie preloženého e-mailu stojí rovnako ako každé iné – jeden kredit.

Limity

• 30 jazykov na šablónu – predvolený jazyk a 29 jazykových verzií.
• Pre jazykovú verziu platia rovnaké limity veľkosti ako pre obsah šablóny.
• Značka jazyka môže mať najviac 35 znakov.

Export a import

Exportovať (.json) zahrnie všetky jazykové verzie a Importovať ich v novej šablóne znova vytvorí. Staršie exporty bez jazykových verzií sa importujú rovnako ako doteraz.