Transept
Procházet centrum nápovědy

Lokalizace e-mailové šablony přes API

Spravuje Vitalii VlasiukCo-founder

E-mailová šablona je HTML kód s vloženou syntaxí. Pošlete tělo zprávy do API, spusťte workflow pro své jazyky a získejte zpět HTML pro každý z nich. Zástupné symboly jsou po celou dobu chráněny a výsledek je připraven k vložení do vašeho ESP.

Na této stránce

Jak šablonu odeslat?

POST /documents s parametrem content_type: "html" a vašimi cílovými jazyky. HTML se vkládá v nezměněné podobě; formátování, odkazy i zástupné symboly šablony zůstanou při překladu zachovány.

Poté proveďte odhad a spuštění přesně podle návodu Automatizace Transeptu pomocí API: odhad je zdarma a spuštění v rámci jediného volání pokryje všechny jazykové verze.

# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Trial welcome", "content_type": "html", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "<h1>Welcome, {{ first_name | default:\"friend\" }}!</h1><p>Your trial starts today.</p>"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

Co se stane se zástupnými symboly?

{{ first_name | … }} se předtím, než text uvidí model, zamaskuje a poté se v nezměněné podobě obnoví. Odpověď se kontroluje podle zdroje, takže chybějící nebo zkomolený token se před odesláním opraví. Jedinou záměrnou výjimkou je náhradní text uvnitř tagu (ono friend v default:"friend"), který si skutečně přečtou příjemci, u nichž v databázi chybí jméno – ten se proto překládá, zatímco samotný tag nikoliv. Úplná pravidla pro ochranu tokenů najdete v části soubory s řetězci.

Jak získám jednotlivé jazykové verze zpět?

GET /documents/{id}/content?format=html u každé jazykové verze vrátí stejnou strukturu HTML s přeloženým textem, připravenou k vložení do příslušné jazykové varianty v ESP.

curl -s "$BASE/documents/<de-version-id>/content?format=html" \
  -H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intact

Může celý proces běžet bez mého zásahu?

Ano. Trigger webhooku nastavený na „tělo požadavku je obsah“ převezme šablonu přímo z vašeho ESP nebo z kroku v Zapieru či n8n a po přijetí spustí workflow. Jakmile jsou překlady hotové, odchozí webhook odešle podepsanou událost, takže si vaše automatizace může HTML kód stáhnout zpět bez nutnosti neustálého dotazování. Nikdo nemusí nic nahrávat ručně.

Časté dotazy✦

Zůstanou tagy Liquid, Handlebars nebo merge tagy při překladu zachovány?

Ano. Tokeny šablony se před předáním modelu zamaskují a poté se v nezměněné podobě obnoví. Každá odpověď prochází kontrolou oproti zdroji, takže případný chybějící zástupný symbol se opraví dříve, než by mohl být odeslán. Jedinou záměrnou výjimkou je náhradní text uvnitř tagu, který příjemci skutečně uvidí – ten se proto překládá, zatímco samotný tag nikoliv.

Může moje e-mailová platforma odesílat šablony bez psaní kódu?

Ano. Nastavte cíl triggeru workflow na „tělo požadavku je obsah“ a nasměrujte platformu nebo krok v Zapieru či n8n na URL adresu triggeru. Každý odeslaný požadavek se převede na dokument a workflow se spustí ihned po přijetí. Viz triggery webhooků.

Jak je to se šablonami lokalizovanými pomocí tagů Braze nebo Mailchimp?

Šablony, jejichž lokalizace je řešena pomocí překladových tagů nebo jazykových podmínek, mají vlastní způsob importu, který tyto tagy přímo načítá a vyplňuje. Viz e-mailové šablony z Braze a Mailchimpu.

Číst dál✦
Prozkoumat funkce✦

Stále si nevíte rady? Zeptejte se Literess v aplikaci, nebo napište na [email protected].