Transept
Переглянути довідковий центр

Локалізація шаблону листа через API

Підтримує Vitalii VlasiukCo-founder

Шаблон електронного листа — це HTML-код із вбудованим синтаксисом шаблонів. Надішліть вміст через API, запустіть процес перекладу на потрібні мови та отримайте такий самий HTML для кожної з них. Плейсхолдери будуть захищені на всіх етапах, а готовий код можна відразу вставляти у ваш ESP.

На цій сторінці

Як надіслати шаблон?

POST /documents з content_type: "html" та вашими цільовими мовами. HTML-код передається без змін; форматування, посилання та плейсхолдери шаблону повністю зберігаються під час перекладу.

Потім виконайте оцінку та запуск точно так само, як у розділі Автоматизація Transept через API: оцінка безкоштовна, а запуск охоплює всі мовні версії за один запит.

# 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}, … ] }

Що відбувається з плейсхолдерами?

{{ first_name | … }} маскується перед тим, як модель побачить текст, і відновлюється дослівно після перекладу; відповідь звіряється з оригіналом, тому втрачений або спотворений токен виправляється, а не потрапляє в результат. Один виняток зроблено навмисно: резервний текст усередині тегу (friend у default:"friend") — це те, що насправді бачать отримувачі, чиїх імен немає в базі, тому він перекладається, тоді як сам тег залишається незмінним. Повні правила захисту токенів наведені у файлах рядків.

Як отримати кожну мовну версію?

GET /documents/{id}/content?format=html для кожної мовної версії повертає такий самий HTML-код із перекладеним текстом, готовий для вставки у відповідний мовний варіант в ESP.

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

Чи може весь цикл працювати без моєї участі?

Так. Вебхук-тригер із налаштуванням «тіло запиту — це вміст» отримує шаблон безпосередньо з вашого ESP або через крок у Zapier/n8n і запускає робочий процес відразу після отримання. Коли переклади готові, вихідний вебхук надсилає підписану подію, щоб ваша автоматизація могла забрати HTML-код без постійних запитів (polling). Нікому не потрібно нічого завантажувати вручну.

Часті запитання✦

Чи зберігаються теги Liquid, Handlebars або теги злиття під час перекладу?

Так. Токени шаблонів маскуються перед тим, як модель побачить текст, і відновлюються дослівно після перекладу, а кожна відповідь звіряється з оригіналом, тому втрачений плейсхолдер виправляється, а не потрапляє в готовий код. Є один свідомий виняток: резервний текст усередині тегу — це те, що насправді бачать отримувачі, тому він перекладається, тоді як сам тег залишається незмінним.

Чи може моя платформа для розсилок надсилати шаблони без написання коду?

Так. Виберіть для тригера робочого процесу налаштування «тіло запиту — це вміст» і спрямуйте платформу або крок у Zapier/n8n на URL-адресу тригера. Кожна передача стає документом, а робочий процес запускається відразу після отримання. Див. вебхук-тригери.

Як щодо шаблонів, локалізованих за допомогою тегів Braze або Mailchimp?

Шаблони, локалізація яких базується на тегах перекладу або мовних умовах, мають власний шлях імпорту — система зчитує та заповнює ці теги безпосередньо. Див. шаблони листів із Braze та Mailchimp.

Читати далі✦
Огляд функцій✦

Досі потрібна допомога? Запитайте Literess у застосунку або напишіть на [email protected].