Zendeskヘルプセンターをローカライゼーションエンジンに接続できます。翻訳対象のカテゴリ、セクション、記事を選ぶと、Lingo.devが対象言語に翻訳し、その翻訳をZendeskに書き戻します。
Zendesk Guide（ヘルプセンター）のコンテンツに対応しています：カテゴリ、セクション、記事。
Zendesk連携は組織ごとに有効化されます。Settings -> Integrations に表示されない場合は、ご連絡いただければこちらで有効化します。
始める前に#
必要なものは次の3つです。
Zendeskの管理者アクセス。 接続にはOAuthを使用するため、認可するアカウントにはヘルプセンターのコンテンツを管理する権限が必要です。
Zendeskでターゲット言語を有効にしてください。 Zendeskで翻訳を受け付けられるのは、ヘルプセンターですでに認識されている言語だけです。Zendesk の Knowledge -> Settings -> Language settings で有効にしてください。
Admin Center -> Account -> Appearance -> Localization で追加した言語は別管理のリストで、ヘルプセンターの言語を有効にするものではありません。
ヘルプセンターで実際に受け付けられる言語を正確に確認するには、管理者としてサインインした状態で
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonを開いてください。そのエンドポイントに表示される内容が、そのまま Lingo.dev で選択できる対象です。ローカライゼーションエンジン。 ヘルプセンターの翻訳は、その用語集、ブランドボイス、ルールに沿って行われます。
ロケールコードはZendeskと完全一致している必要があります
Zendeskでは en-us や de-de のようなコードを使います。ヘルプセンターのソース言語が en-us と表示されている場合、Lingo.devでは単なる English ではなく English (United States) を選んでください。これは別々のロケール（en-US と en）で、この不一致が接続失敗の最もよくある原因です。
ヘルプセンターを接続する#
連携を開く
Settings -> Integrations に移動し、Zendeskの Connect をクリックします。
フォームに入力
| 項目 | 入力内容 |
|---|---|
| サブドメイン | Zendesk URLのラベル部分だけを入力します。https://acme.zendesk.com なら acme を入力してください。https:// も .zendesk.com も不要です |
| エンジン | このコンテンツを翻訳するローカライゼーションエンジン |
| ソースロケール | 記事の元言語です。Zendesk上の表示と完全に一致している必要があります |
| 対象ロケール | 翻訳先の言語です。すべて事前にZendeskで有効化されている必要があります |
| 下書きとして保存 | オンのままにすると、翻訳は未公開の下書きとして書き込まれます。オフにすると、すぐに公開されます |
Zendeskで認可する
Zendeskにリダイレクトされたら、Allow をクリックしてください。その後Lingo.devのZendeskページに戻り、接続が有効になります。
翻訳する対象を選ぶ#
Zendeskページには Content と Runs の2つのタブがあります。
Contentタブには、ヘルプセンター内のすべての項目（カテゴリ、セクション、記事）が1つのテーブルに表示されます。上部のフィルターチップ（All、Categories、Sections、Articles）で一覧を絞り込み、チェックボックスで翻訳対象を選択します。各行の名前はZendesk内の該当項目へのリンクになっているので、選択内容を確認しながら進められます。
カテゴリを選んでも、その中身までは選択されません
カテゴリ、セクション、記事はそれぞれ個別に選択します。カテゴリ全体を翻訳したい場合は、そのカテゴリ と 配下のセクション、記事も選択してください。
同期の前に、まず保存。 新しい接続は空のスコープから始まり、同期で使われるのは画面で今チェックされている内容ではなく、保存済みのスコープです。何も保存しないまま同期すると、実行結果は翻訳対象なしになります。まず Save をクリックしてから、翻訳してください。
翻訳される内容#
| 項目 | 翻訳対象フィールド |
|---|---|
| カテゴリ | タイトル、説明 |
| セクション | タイトル、説明 |
| 記事 | タイトル、本文 |
記事本文はHTMLとして翻訳されるため、書式、リンク、埋め込みメディアもそのまま保たれます。
同期と再翻訳#
2つのボタンには、それぞれ役割があります。
| ボタン | 動作 | 使うタイミング |
|---|---|---|
| Sync | 前回の実行以降に変更されたものだけを翻訳します | 通常の更新時。多くの場合はこちらを使います |
| Retranslate | 対象範囲内のすべてを最初から翻訳し直します | エンジンの用語集、ブランドボイス、ルールを変更し、既存の翻訳を再生成したいとき |
どちらも2か所から使えます。ページヘッダーでは保存済みの対象範囲全体に対して、コンテンツテーブル上部では選択した行だけに対して実行されます。
実行は手動です。Zendesk で記事を編集しても自動では開始されません。翻訳を開始するタイミングは、あなたが決められます。
同時に実行できるランは1つだけです。ランの実行中は、両方のボタンが無効になります。
ランを確認する#
Runs タブには、すべてのランについてステータス、実行のきっかけ、開始時刻、所要時間が表示されます。進行中のランは一覧からキャンセルできます。
実行を開くと詳細を確認できます。Zendesk からのコンテンツ取得、翻訳、書き戻しといった現在のステージに加え、全体の進捗や対象言語ごとの進捗も表示されるので、ドイツ語は完了していて、日本語はまだ進行中といった状況もひと目でわかります。
nothing to translate で実行が終了しても、失敗ではありません。これは、スコープ内のすべての内容がすでに翻訳と一致していることを意味します。つまり、間に何も編集せずに 2 回同期したときの通常の結果です。
翻訳の反映先#
各翻訳は、同じ記事・セクション・カテゴリに、ロケールごとのバージョンとして紐づけられます。これは Zendesk の標準の翻訳モデルです。読者はヘルプセンターで言語を切り替えるだけでその翻訳を表示でき、重複して作成されたり、別の場所に移されたりすることはありません。
翻訳の作成者として表示される人
Zendesk では、翻訳の作成者になるのは Sync をクリックした人ではなく、接続を認可したアカウントです。ヘルプセンター全体に 1 人のチームメンバーの名前を表示したくない場合は、共有のサービスアカウントで接続してください。
下書きと公開#
下書きとして保存 をオンにすると、翻訳はZendeskに未公開の下書きとして保存されます。Zendeskで誰かがレビューして公開するまで、お客様には表示されません。これは安全なデフォルト設定で、翻訳品質を評価している間はこのままにしておくのがおすすめです。
オフにすると、翻訳は書き込まれた時点ですぐに公開されます。
この設定は後から Settings -> Integrations -> Zendesk で変更できます。エンジンや対象ロケールも同じ場所で変更できます。
接続を解除する#
接続を解除すると、接続自体に加え、実行履歴と、各記事でどこまで翻訳済みかを記録した情報も削除されます。すでに Zendesk に書き込まれた翻訳はそのまま残ります。翻訳は私たちのものではなく、あなたのヘルプセンターのものです。
再接続するとゼロからやり直し
記事ごとの同期状態が失われるため、再接続後の最初の同期では、スコープ全体が新規として扱われ、すべてがもう一度翻訳されます。もちろん、その分のコストもかかります。接続解除はトラブルシューティングのためではなく、本当に止めたいときに行ってください。
制限#
| 制限 | 詳細 |
|---|---|
| 対応コンテンツ | カテゴリ、セクション、記事に対応しています。チケット、マクロ、テーマ、コミュニティ投稿は対象外です。 |
| コンテンツブロック | Zendeskのコンテンツブロックで作成された記事は翻訳されません |
| トリガー | 手動のみ - webhook なし、記事が変更されても自動同期はされません |
| 同時実行ラン | 接続ごとに1つ |
| 対象言語 | ランで書き込みを行う前に、Zendeskヘルプセンターで有効化されている必要があります |
トラブルシューティング#
Allow をクリックした直後に接続に失敗する。 ほとんどの場合、原因はロケールの不一致です。選択したソースロケールがヘルプセンターに存在していません。https://<subdomain>.zendesk.com/api/v2/help_center/locales.json を開いて、表示されているコードを正確に確認し、そのコードで再接続してください。
ターゲット言語がドロップダウンに表示されない。 まずは Zendesk の Knowledge -> Settings -> Language settings でその言語を有効にしてから、Lingo.dev で設定を開き直してください。
同期しても翻訳対象がないと表示される場合。 保存済みのスコープが空か、含まれている内容がすべて最新です。スコープが空の場合は、Content タブでコンテンツを選択して Save をクリックしてください。
翻訳がヘルプセンターに表示されない。 接続が下書きモードになっていないか確認してください。下書きはZendesk内にはありますが、公開されるまでお客様には表示されません。
