仕様書 · ドキュメント＆サポート

Help Scout and Transglot, bring your help articles into translation.

Choose Help Scout in your project’s CMS settings, add your credentials, and select the content and languages to sync. Translate and review in one project, then publish to your mapped target languages.

Import into Transglot

方向: Import into Transglot
プラン: Starter以上
範囲: Docs記事：コレクション全体の名前とテキスト
認証: Help Scout Docs APIキー
はじめに: Connect from your project’s CMS settings.

Create your project セットアップ

ドキュメント＆サポート

ワークフロー

コンテンツを接続。すべての言語を確認。

一度接続してコンテンツと言語を選択し、同じプロジェクト内で翻訳と確認を行います。以下の手順で、お使いのツールでの動作を確認できます。

Connect Help Scout
Choose Help Scout in the project’s CMS settings. Add a Help Scout Docs API key.
connect
Choose the content and locale mapping
Select the types and fields you want to localize. The connector reads Docs articles: name and text, across your collections. Map the source and target locales to your project.
map
Sync and review the translations
Start Sync from CMS to bring the selected source into your project. Translate and review the resulting keys alongside the rest of your project content.
レビュー
Deliver through your project
Pull the translated locale files through the API or CLI, or use the project’s CDN bundle. Help Scout remains an import-only source.
deliver

Read translated locale files through the Transglot API, CLI or CDN. Publishing changes back to Help Scout is not part of this connector.

対象となる要素

翻訳・配信可能なコンテンツ

Docsコレクションとその記事は全文を取得します。リストエンドポイントは参照のみを返すためです。Help Scout Docsでは各言語を別個のサイトとしてモデル化しており、記事の翻訳スロットが存在しないため、一方向の同期となります。

翻訳・配信可能なコンテンツ
サーフェス	期待できること
ソースと範囲	Docs記事：コレクション全体の名前とテキスト
翻訳後の出力	Read translated locale files through the Transglot API, CLI or CDN. Publishing changes back to Help Scout is not part of this connector.
注意事項	Import only. Your original Help Scout content is read, and this connector does not write translations back.

接続を開始

最初の接続までの数ステップ

以下のツール設定に従い、接続を追加して同期対象を選択し、少量のコンテンツで試してみてください。チームは既存のツールを引き続き使用できます。

必要なもの

Help Scout Docs APIキー.

ソースロケールとターゲットロケールが設定されたTransglotプロジェクト
チームがファイル間でシークレットをコピーすることなく作業できるよう、接続設定に認証情報を保存してください。
ホスト型APIへのアクセスには有料のTransglotプランが必要です。AI翻訳はワークスペースの単語数枠を使用します。

プロジェクトを作成

Create a Transglot project with the source and target locales you need.
Open the project’s CMS settings and choose Help Scout.
Provide a Help Scout Docs API key.
Save the connection, select the supported content, map locales, then run Sync from CMS.

同じプロジェクト、さらなる可能性