通过 API 本地化邮件模板
邮件模板是内嵌了模板语法的 HTML 文本。将正文发送至 API，针对目标语言运行工作流，即可取回各语言版本的 HTML。占位符在整个过程中都受到保护，译好的内容可直接粘贴到您的 ESP 中。
本页内容
如何提交模板？
调用 POST /documents 接口，设置 content_type: "html" 并指定目标语言。HTML 内容将原样上传；格式、链接和模板占位符在翻译后都会完整保留。
然后，完全按照通过 API 自动化 Transept中的说明进行预估和运行：预估是免费的，只需一次调用即可同步运行所有语言版本。
# 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 | … }} 在模型读取文本前会被屏蔽，并在翻译完成后原样还原。系统会将返回内容与原文进行比对，确保任何丢失或乱码的标记都能被修复，而不是直接交付。一个特意保留的例外是：标签内的回退文本（如 default:"friend" 中的 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整个流程可以实现全自动化吗？
可以。只需将 Webhook 触发器设置为“请求体即内容”，即可直接从您的 ESP 或 Zapier/n8n 步骤中获取模板，并在接收后立即运行工作流。翻译就绪后，出站 Webhook 会推送一个签名事件，您的自动化程序即可直接取回 HTML，无需轮询。整个过程完全无需手动上传。
Liquid、Handlebars 或合并标签在翻译后会保留吗？
是的。模板标记在模型读取文本前会被屏蔽，并在翻译完成后原样还原。系统会将返回内容与原文进行比对，确保任何丢失的占位符都能被修复，而不是直接交付。一个特意保留的例外是标签内的回退文本，由于这是收件人实际看到的文字，因此这部分会被翻译，而其外层的标签则保持不变。
我的邮件平台能否在无需编写代码的情况下推送模板？
可以。只需将工作流触发器的目标设置为“请求体即内容”，并将平台或 Zapier/n8n 步骤指向该触发器 URL。每次推送的内容都会生成一个文档，且工作流会在接收后立即运行。请参阅 Webhook 触发器。
如何处理通过 Braze 或 Mailchimp 标签本地化的模板？
如果模板的本地化逻辑存在于翻译标签或语言条件语句中，系统提供了专门的导入路径来直接读取并填充这些标签。请参阅来自 Braze 和 Mailchimp 的邮件模板。
仍有疑问？在应用内询问 Literess，或发送邮件至 [email protected]。