API経由でメールテンプレートをローカライズする

content_type: "html"と翻訳先の言語を指定してPOST /documentsを実行します。HTMLはそのまま送信され、書式設定、リンク、テンプレートのプレースホルダーはすべて翻訳後も維持されます。

その後はAPIでTranseptを自動化するとまったく同じ手順で、見積もりを取って実行します。見積もりは無料で、1回の呼び出しですべての言語バージョンに実行が展開されます。APIの利用にはキーが必要で、StarterプランおよびProプランに含まれています。

# 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 | … }}はモデルに渡される前にマスクされ、処理後に元の状態のまま復元されます。出力内容は原文と照合されるため、トークンが欠落したり崩れたりしても、そのまま出力されずに修復されます。意図的な例外が1つあります。タグ内のフォールバックテキスト（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を取得できます。手作業でアップロードする必要は一切ありません。