Zendesk ヘルプセンター
ヘルプセンターのカテゴリ、セクション、記事を既存の各言語版に翻訳。同期と公開は手動で管理できます。
ヘルプセンターのコンテンツを、Zendesk から移動せずに翻訳できます。Lingo.dev の接続は、選択したカテゴリ、セクション、記事をヘルプセンターの既定の言語で読み取り、ローカライゼーションエンジンで翻訳して、同じ項目に対象言語版を書き込みます。
Studio 2.5のナビゲーションでは、設定 → 連携ではなく、Studio 2.5 → 連携を開いてください。既存の接続用・セットアップ用リンクは引き続きご利用いただけます。
処理は手動で実行します。記事を変更したら、更新したいコンテンツの同期を開始してください。初回の書き込み前に、翻訳を下書きにするか、公開するかを選択します。公開済みの対象言語版を下書きとして書き込むと、再公開するまで読者がその言語版を閲覧できなくなる場合があります。
アクセス権とヘルプセンターの言語を準備する #
Zendesk ヘルプセンター連携を利用するには、Enterprise プランが必要です。現在の提供状況は料金をご覧ください。組織のプランでは利用できない場合、設定 → 連携の Zendesk の横にご利用のプランでは利用できませんと表示されます。
ヘルプセンターのコンテンツにアクセスできる Zendesk 管理者アカウントを使用してください。Radar 用のアクティビティを収集する記事公開ウェブフックの登録には、管理者権限が必要です。書き込みは認可に使用したアカウントの操作として記録されます。チーム共通の名義で記録する必要がある場合は、適切なサービスアカウントを使用してください。Lingo.dev では、組織に対する権限と接続の利用資格に加え、選択したローカライゼーションエンジンへのアクセス権が必要です。
ヘルプセンターの言語設定で対象言語を有効にしてください。Zendesk のアカウント全体のローカライゼーション一覧は別の設定のため、そちらで言語を追加してもヘルプセンターの翻訳は有効になりません。適切な認可があれば、読み取り専用エンドポイント https://<subdomain>.zendesk.com/api/v2/help_center/locales.json でヘルプセンターのロケール設定を一覧表示できます。
Lingo.dev は実行のたびにヘルプセンターの既定の言語を読み取り、原文の言語として使用します。接続フォームで別の原文言語を選択する必要はありません。
接続して最初の記事を翻訳する #
- 設定 → 連携を開き、Zendesk の接続を選択します。名前とヘルプセンターのサブドメインを入力します。
acme.zendesk.comの場合はacmeを入力してください。 - Zendesk に進み、アクセスを認可します。認可が成功すると、接続が作成されます。
- Studio で、接続済みにあるヘルプセンターを選択し、セットアップを選択します。
- ローカライゼーションエンジンと書き戻しモードを選び、続行を選択します。初回は、ヘルプセンターで有効になっている言語から対象言語を一つ選択してください。原文の言語は対象外です。ほかの言語がない場合は、先に Zendesk で有効にしてください。
- 記事を開き、原文の内容が固まっている記事を一つ選んで、同期スイッチを有効にします。設定が保存されるのを待ってから、その記事の行のチェックボックスを選択し、同期をキューに追加を選択します。
- ワークフローの結果と、Zendesk にある実際の対象記事を確認します。タイトル、本文、リンク、ロケール、下書きか公開済みかを確認してください。公開する記事であれば、読者向けの URL も開いて確認します。
初回の同期では、既存の翻訳に不足がなければ上書きせずに採用し、本文と下書き状態をそのまま保持します。不足しているコンテンツは翻訳します。既存の翻訳を意図的に置き換える場合は、再翻訳を使用してください。
翻訳したい範囲全体を選択する #
カテゴリ、セクション、記事には、それぞれ個別のテーブルと、設定が保持される同期スイッチがあります。カテゴリを有効にすると、そのカテゴリの名前と説明が翻訳されますが、配下のセクションや記事の同期は有効になりません。ヘルプセンターの特定の範囲をすべて翻訳する場合は、セクションや記事も個別に選択してください。
| 項目 | 翻訳対象のフィールド |
|---|---|
| カテゴリ | 名前/タイトルと説明 |
| セクション | 名前/タイトルと説明 |
| 記事 | タイトルと本文 |
行のチェックボックスでは、同期スイッチがすでに有効な項目の中から、今回の同期をキューに追加または再翻訳をキューに追加の対象を絞り込みます。行を選択しても、継続的な同期のスイッチは有効になりません。ヘッダーの操作は、接続内で有効になっている範囲全体に適用されます。開始する前に、その操作でどの範囲が処理されるかを確認してください。
記事本文は HTML として処理され、書式、リンク、埋め込みメディアが再構成されます。書き戻し時には、ヘルプセンターのリンクとして認識されたリンクを対象ロケールに合わせて調整できます。翻訳先のページが存在するかどうかも含め、処理結果のリンクを確認してください。外部リンクやサイト固有のナビゲーションは、別途確認が必要です。
この接続では、チケット、マクロ、テーマ、コミュニティ投稿、Zendesk のコンテンツブロックを使用した記事は翻訳しません。ヘルプセンターのコンテンツをローカライズするための接続であり、サポートチケットの仕分けを行うものではありません。
変更されたコンテンツを更新する・翻訳を置き換える #
同期は、現在の原文を記録済みの状態や既存の翻訳と比較します。通常の原文更新への対応、不足しているコンテンツの翻訳、前回の実行で完了しなかった作業に使用してください。
再翻訳は、原文に変更がなくても、選択した項目と言語の翻訳を再生成します。承認済みの手動編集が置き換えられる場合があります。広範囲に適用されるヘッダーの操作では確認が求められます。選択した行への操作でも、意図した置換範囲を選ぶ必要があります。
接続ごとに同時に実行できる処理は一つです。追加のリクエストはキューに入り、キューが満杯の場合は空きができるまで待つ必要があります。結果はワークフロー実行に表示されます。停止では、まだ停止可能な作業をキャンセルできます。結果が「最新の状態」を示している場合、選択範囲に処理が必要な変更がなかったという意味であり、翻訳品質を新たに評価したわけではありません。
読者に表示される内容を確認する #
公開モードでは、翻訳を公開状態で書き込みます。下書きモードでは、Zendesk でレビューできるように、各ロケール版を未公開の状態で書き込みます。公開済みの言語版を下書きモードで更新すると、誰かが再公開するまで、その公開版が閲覧できなくなる場合があります。更新を始める前に、この一時的な非公開がリリースに支障をきたさないか判断してください。
書き込み後は、対象言語の URL を開いて確認してください。実際のタイトルと本文を原文の該当する版と比較し、リンク先を開いて、原文の言語が残っていないか確認します。翻訳処理の完了は、リリースに必要な工程の一つです。翻訳を採用するか、公開するかは、引き続き編集上の判断で決定します。
原文の変更や一部のみ完了した結果に対処する #
書き戻し時には、原文の項目を再読み込みします。処理計画の作成後に原文が変更または削除されていた場合、Lingo.dev はその対象への書き込みをスキップします。原文の準備ができたら、手動で再度同期を実行し、新しい状態に合わせて更新してください。
一つのロケールで失敗しても、ほかのロケールで成功した書き込みは取り消されません。書き込み済み、スキップ、失敗の各項目を確認し、影響のある範囲を再試行してください。ヘルプセンター全体を強制的に処理すると、元の原因が解消されないまま、承認済みの文章が置き換えられる場合があります。
出力がない場合は、項目の選択、ヘルプセンターで有効な言語、ローカライゼーションエンジンへのアクセス権、書き戻しモード、コンテンツブロックによる除外、原文の変更の有無を確認してください。不足のない既存の翻訳を採用した場合、新しい文章を生成しないのは意図した動作です。対象言語が Zendesk で無効になっている場合、実行時にはその言語がスキップされます。接続の対象言語の選択を更新してください。
Zendesk で一時的な障害が発生している場合は、サービスの復旧後に再試行してください。認可の復元が必要な場合は、既存の接続で再接続を使用してください。切断して新しい接続を作成すると、同期状態が失われます。
切断または再接続する #
対象言語、ローカライゼーションエンジン、モードは、Studio でヘルプセンターを開き、設定タブで変更します。アカウントの名前変更や再接続は、設定 → 連携で行います。既存の接続の認可を復元するには、再接続を使用してください。
切断すると読み取りと書き込みが停止し、ローカルの接続、実行履歴、項目ごとの同期記録が削除されます。Zendesk にある既存の翻訳は残ります。その後、新しい接続を作成すると、新たな基準状態が設定されます。初回の同期では、不足のない既存の翻訳を保持し、不足しているコンテンツを補います。アクセスを終了する場合は、プロバイダー側の認可も別途取り消してください。以前に公開した文章に戻す必要がある場合は、Zendesk で直接復元してください。
Radar でアクティビティを収集する #
この接続は、ヘルプセンターのアクティビティを Radar にも提供します。測定用の翻訳を収集するでは、イベントの設定と、過去のデータを測定する前にプロバイダーの履歴をインポートする方法を説明しています。
手動翻訳は動作するのに新しい記事のアクティビティが表示されない場合は、接続のウェブフック登録と配信状況を確認してください。管理者以外のアカウントではウェブフックを登録できなくても、認可自体は成功する場合があります。設定 → 連携で、既存の Zendesk 接続の再接続を選択し、管理者として認可してください。自動収集を利用する前に、テスト記事を公開し、そのイベントを Radar で確認してください。