E-Mail-Templates über die API lokalisieren
Ein E-Mail-Template ist HTML-Text mit eingebetteter Template-Syntax. Senden Sie den Body an die API, führen Sie einen Workflow für Ihre Sprachen aus und rufen Sie das übersetzte HTML pro Sprache wieder ab. Die Platzhalter bleiben während des gesamten Prozesses geschützt, sodass Sie das Ergebnis direkt in Ihren ESP kopieren können.
Auf dieser Seite
Wie sende ich ein Template ein?
POST /documents mit content_type: "html" und Ihren Zielsprachen. Das HTML wird unverändert übernommen; Formatierung, Links und Template-Platzhalter bleiben bei der Übersetzung vollständig erhalten.
Führen Sie die Schätzung und den Durchlauf dann genau wie unter Transept mit der API automatisieren beschrieben aus: Die Schätzung ist kostenlos, und der Durchlauf deckt mit nur einem Aufruf sämtliche Sprachversionen ab.
# 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}, … ] }Was passiert mit den Platzhaltern?
{{ first_name | … }} wird maskiert, bevor das Modell den Text sieht, und danach im Originalzustand wiederhergestellt. Da die Antwort mit dem Quelltext abgeglichen wird, werden verloren gegangene oder beschädigte Tokens repariert, statt sie fehlerhaft auszuliefern. Eine bewusste Ausnahme: Fallback-Texte innerhalb eines Tags (wie das friend in default:"friend") sind das, was Empfänger ohne hinterlegten Namen tatsächlich lesen; daher werden sie übersetzt, während der umschließende Tag unverändert bleibt. Die vollständigen Regeln zum Schutz von Tokens finden Sie in den Strings-Dateien.
Wie erhalte ich die einzelnen Sprachversionen zurück?
GET /documents/{id}/content?format=html für die jeweilige Sprachversion liefert dieselbe HTML-Struktur mit den übersetzten Texten zurück – bereit zum Einfügen in die Sprachvariante des ESP.
curl -s "$BASE/documents/<de-version-id>/content?format=html" \
-H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intactKann der gesamte Prozess ohne mich ablaufen?
Ja. Ein Webhook-Trigger, der auf „Der Request-Body ist der Inhalt“ eingestellt ist, bezieht das Template direkt von Ihrem ESP oder einem Zapier- oder n8n-Schritt und startet den Workflow sofort bei Eingang. Ein ausgehender Webhook sendet ein signiertes Event, sobald die Übersetzungen bereitstehen, sodass Ihre Automatisierung das HTML ohne Polling abrufen kann. Niemand muss mehr etwas manuell hochladen.
Bleiben Liquid-, Handlebars- oder Merge-Tags bei der Übersetzung erhalten?
Ja. Template-Tokens werden maskiert, bevor das Modell den Text verarbeitet, und danach im Originalzustand wiederhergestellt. Da jede Antwort mit dem Quelltext abgeglichen wird, werden verloren gegangene Platzhalter repariert, statt sie fehlerhaft auszuliefern. Eine bewusste Ausnahme ist der Fallback-Text innerhalb eines Tags: Da dies der Text ist, den Empfänger tatsächlich lesen, wird er übersetzt, während der Tag selbst unverändert bleibt.
Kann meine E-Mail-Plattform Templates ganz ohne Programmierung einsenden?
Ja. Stellen Sie das Ziel eines Workflow-Triggers auf „Der Request-Body ist der Inhalt“ ein und richten Sie die Plattform oder einen Zapier/n8n-Schritt auf die Trigger-URL aus. Jede Übermittlung wird als Dokument angelegt und der Workflow startet sofort bei Eingang. Siehe Webhook-Trigger.
Was ist mit Templates, die über Braze- oder Mailchimp-Tags lokalisiert werden?
Templates, bei denen die Lokalisierung über Übersetzungs-Tags oder Sprachbedingungen erfolgt, verfügen über einen eigenen Importpfad, der diese Tags direkt ausliest und befüllt. Siehe E-Mail-Templates von Braze und Mailchimp.
Kommen Sie nicht weiter? Fragen Sie Literess in der App oder schreiben Sie an [email protected].