Lokalizacja szablonu e-mail przez API

Wyślij żądanie POST /documents z parametrem content_type: "html" oraz wybranymi językami docelowymi. Kod HTML jest przesyłany w niezmienionej formie; formatowanie, linki i symbole zastępcze szablonu zostają zachowane podczas tłumaczenia.

Następnie dokonaj wyceny i uruchom proces dokładnie tak, jak w Automatyzacja Transept przez API: wycena jest bezpłatna, a proces obejmuje wszystkie wersje językowe w ramach jednego wywołania.

# 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 | … }} jest maskowany, zanim model zobaczy tekst, a następnie przywracany w niezmienionej formie. Każda odpowiedź jest weryfikowana pod kątem zgodności ze źródłem, więc utracone lub zniekształcone tokeny są naprawiane przed wysyłką. Jedynym celowym wyjątkiem jest tekst zastępczy wewnątrz tagu (friend w default:"friend") – to właśnie ten tekst widzą odbiorcy, których danych nie ma w systemie, dlatego jest on tłumaczony, podczas gdy sam tag pozostaje nienaruszony. Pełne zasady ochrony tokenów znajdują się w plikach lokalizacyjnych.

GET /documents/{id}/content?format=html wywołane dla każdej wersji językowej zwraca ten sam układ HTML z przetłumaczoną treścią, gotowy do wklejenia do odpowiedniego wariantu językowego w systemie ESP.

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

Tak. Wyzwalacz webhook z ustawioną opcją „treść żądania jest zawartością” pobiera szablon bezpośrednio z Twojego systemu ESP lub kroku w Zapier/n8n i uruchamia proces natychmiast po jego otrzymaniu. Gdy tłumaczenia są gotowe, webhook wychodzący wysyła podpisane zdarzenie, dzięki czemu Twoja automatyzacja może pobrać kod HTML bez konieczności odpytywania serwera. Nikt nie musi niczego przesyłać ręcznie.