Zendeskヘルプセンター
Zendeskのヘルプセンターをローカライゼーションエンジンに接続しましょう。翻訳対象にしたいカテゴリ、セクション、記事で同期をオンにすると、Lingo.devがヘルプセンターで有効な言語に翻訳し、そのままZendeskに書き戻します。
Zendesk Guide（ヘルプセンター）のコンテンツに対応しています：カテゴリ、セクション、記事。
ZendeskはEnterpriseでご利用いただけます。接続ページにZendesk is not on your planと表示されたら、ご連絡ください。こちらで対応します。
始める前に#
必要なものは次の3つです。
Zendeskへの管理者アクセス。 接続にはOAuthを使用するため、認証に使うアカウントにはヘルプセンターのコンテンツを管理する権限が必要です。Lingo.devが書き込む翻訳はすべて、Zendesk上でそのアカウントの操作として記録されます。ヘルプセンター全体に特定のチームメイトの名前を出したくない場合は、共有のサービスアカウントで接続してください。
Zendeskで対象言語が有効になっていること。 Lingo.devで選べるのは、ヘルプセンターで有効になっている言語だけです。ZendeskのKnowledge -> Settings -> Language settingsで有効にしてください。
Admin Center -> Account -> Appearance -> Localization で追加した言語は別管理のリストで、ヘルプセンターの言語を有効にするものではありません。
ヘルプセンターで実際に受け付けている内容を正確に確認するには、管理者としてサインインした状態で
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonを開いてください。そのエンドポイントに表示されるものが、Lingo.devで提供される内容です。ローカライゼーションエンジン。 ヘルプセンターの翻訳は、その用語集、ブランドボイス、ルールに沿って行われます。
ソース言語は選択できません。Lingo.devは実行のたびに、Zendeskからヘルプセンターのデフォルト言語を読み取ります。
ヘルプセンターはすでに翻訳済みですか？
最初の同期では、Zendeskにすでにある翻訳がそのまま保持されます。各項目と言語ごとに、Zendeskに完全な翻訳がすでにある場合、Lingo.devはそれを変更せず、不足している部分だけを翻訳します。既存の翻訳を置き換えるには、再翻訳を使用します。
ヘルプセンターを接続する#
連携を開く
Studio -> All integrationsに移動し、ZendeskカードのConnectをクリックします。
フォームに入力
| 項目 | 入力内容 |
|---|---|
| 名前 | ヘルプセンターを見分けやすいように、この接続に付ける名前 |
| ヘルプセンター | ZendeskのURLから、サブドメインだけを入力します。https://acme.zendesk.comならacmeを入力してください。フォームにはその後ろに.zendesk.comが表示されます |
| エンジン | この翻訳で使う用語集、ルール、ブランドボイスが適用されるローカライゼーションエンジン |
| モード | Draftでは翻訳が未公開の下書きとして書き込まれ、Publishでは書き込まれた時点ですぐ公開されます。詳しくは下のDraftとPublishの違いをご覧ください |
Continue to Zendeskをクリックします。
Zendeskで認可する
ZendeskでLingo.devへのアクセス許可を求められます。Allowをクリックしてください。ここで許可するまで、何も作成されません。Denyをクリックすると、接続は作成されず、そのままフォームに戻ります。
言語を選ぶ
Lingo.devに戻ると、ヘルプセンターで有効になっている言語のうち、デフォルト言語を除いた一覧が表示されます。すべて最初から選択されています。不要なものはチェックを外して、Save and openをクリックしてください。
ヘルプセンターの言語が1つしかない場合は、まずZendeskで言語を追加するようLingo.devが案内します。
翻訳する対象を選ぶ#
接続ページには5つのタブがあります。Categories、Sections、Articles、Workflow runs、Settingsです。
最初の3つのタブには、それぞれの種類のコンテンツが1行ずつ表示され、名前とIDで検索できる検索ボックスがあります。各行の名前はZendesk上のその項目へのリンクになっているので、何を選んでいるかを確認できます。各行にはSyncスイッチがあり、オンにすると、その項目は以後この接続の対象になります。変更は切り替えた瞬間に保存され、Saveボタンはありません。テーブルヘッダーのスイッチを使うと、一覧のすべてに対してSyncをオンまたはオフにできます。
チェックボックスは単発実行用です。行にチェックを入れると、**Queue sync (N)とQueue retranslation (N)**の2つのボタンが表示され、Syncがオンになっている内容を変えずに、その行だけ実行できます。
自動では連動しません
カテゴリをオンにしても翻訳されるのは、そのカテゴリ自身の名前と説明だけで、配下のセクションや記事までは含まれません。カテゴリ全体を対象にするには、Articlesタブでもその記事をオンにしてください。ヘッダースイッチを使えば、一覧に表示されているものをまとめてオンにでき、不要なものだけチェックを外せます。
翻訳される内容#
| 項目 | 翻訳対象フィールド |
|---|---|
| カテゴリ | タイトル、説明 |
| セクション | タイトル、説明 |
| 記事 | タイトル、本文 |
記事本文はHTMLとして翻訳されるため、書式、リンク、埋め込みメディアもそのまま保たれます。
同期と再翻訳#
2つのボタンには、それぞれ役割があります。
| ボタン | 動作 | 使うタイミング |
|---|---|---|
| Sync | 前回の実行以降に変更されたものだけを翻訳します | 通常の更新時。多くの場合はこちらを使います |
| Retranslate | 変更の有無にかかわらず、すべてをもう一度翻訳します | エンジンの用語集、ブランドボイス、ルールを変更し、既存の翻訳を再生成したいとき |
どちらもページヘッダーにあり、そこではSyncがオンのすべてに適用されます。また、行にチェックを入れるとテーブルの上にも表示され、その場合はチェックした行だけに適用されます。ヘッダーからRetranslateを実行する場合は、選択したすべての項目とすべての言語に料金が発生するため、先に確認が表示されます。
実行は手動です。Zendesk で記事を編集しても自動では開始されません。翻訳を開始するタイミングは、あなたが決められます。
接続ごとに同時に実行できるのは1件だけです。実行中に別の実行を依頼すると、その後ろにキューされます。キューがいっぱいの場合は、いずれかの実行が終わってからもう一度お試しください。
ランを確認する#
Workflow runsタブには、すべての実行が一覧表示されます。開始時刻、何がきっかけだったか、対象言語、所要時間、ステータスを確認できます。まだ実行中のものにはStopボタンがあります。行を開くと、言語ごとの結果を確認できます。
実行結果がUp to dateで終わっても、失敗ではありません。前回の実行以降に何も変わっていない、という意味です。間に何も編集せずに2回同期した場合の通常の結果です。
翻訳の反映先#
各翻訳は、同じ記事・セクション・カテゴリに、ロケールごとのバージョンとして紐づけられます。これは Zendesk の標準の翻訳モデルです。読者はヘルプセンターで言語を切り替えるだけでその翻訳を表示でき、重複して作成されたり、別の場所に移されたりすることはありません。
下書きと公開#
Draftモードでは、翻訳はZendeskに未公開の下書きとして書き込まれます。Zendeskで誰かがレビューして公開するまで、読者には何も表示されません。ヘルプセンターにまだ翻訳がなく、品質を見極めたいときは、まずこのモードから始めるのがおすすめです。
Publishモードでは、翻訳は書き込まれるとすぐに公開されます。
すでに公開済みの翻訳があるなら、Publishを使いましょう
Draftモードでは、Lingo.devがすでに公開されている言語に書き込んだ翻訳は、その言語の下書きになります。その結果、誰かが再公開するまで、読者には公開中の版が見えなくなります。ヘルプセンターですでに翻訳を公開している場合は、Publishを選んでください。
モードは後からSettingsタブで変更できます。エンジンや対象言語も同じ場所で変更できます。
設定#
設定タブでは、この接続がどのヘルプセンターを読み込むか、また同期されているコンテンツの量を確認できます。あわせて、名前、対象言語、エンジン、モードも変更できます。変更内容はその都度保存されます。
選択していた言語がZendeskで有効でなくなった場合、このタブにその旨が表示されます。同期ではその言語がスキップされ、次に一覧が変更されると外されます。
接続を解除する#
Settingsタブの下部にあるDisconnectを使うと、Lingo.devによるヘルプセンターの読み取りと書き込みが停止します。接続、その実行履歴、そして記事ごとの翻訳済み記録が削除されます。すでに書き込まれた翻訳はZendeskに残ります。翻訳はLingo.devではなく、あなたのヘルプセンターに属しているためです。
再接続
再接続すると、何が翻訳されたかの新しい記録が始まります。再接続後の最初の同期では、Lingo.devが以前に書き込んだものも含めて、Zendeskにすでにある翻訳がそのまま保持され、不足している部分だけが翻訳されます。
制限#
| 制限 | 詳細 |
|---|---|
| 対応コンテンツ | カテゴリ、セクション、記事に対応しています。チケット、マクロ、テーマ、コミュニティ投稿は対象外です。 |
| コンテンツブロック | Zendeskのコンテンツブロックで作成された記事は翻訳されません |
| トリガー | 手動のみ - webhook なし、記事が変更されても自動同期はされません |
| 同時実行ラン | 接続ごとに1件まで。追加のリクエストはその後ろにキューされます |
| 対象言語 | Lingo.devで提供される前に、Zendeskのヘルプセンターで有効になっている必要があります |
| 接続 | 組織ごとに複数のヘルプセンターを、それぞれ一度だけ接続可能 |
トラブルシューティング#
接続ページにZendesk is not on your planと表示される。 ZendeskはEnterpriseでご利用いただけます。ご連絡いただければ対応します。それまでの間も、すでに接続済みのものはそのまま動作し続けます。
接続ページにyou cannot connect thisと表示される。 接続には、現在のロールに含まれていない権限が必要です。組織の管理者が接続するか、その権限を付与してください。
対象言語が一覧に表示されない。 まずZendeskのKnowledge -> Settings -> Language settingsでその言語を有効にしてから、Lingo.devのSettingsタブを開き直してください。一覧は毎回Zendeskから読み込まれます。
Allowの後に、Lingo.devからZendeskで言語を追加するよう求められる。 ヘルプセンターは1つの言語のみで、ほかの言語がないため、まだ翻訳先がありません。
同期結果がUp to dateになる。 前回の実行以降に何も変わっていないか、まだSyncがオンのコンテンツが1つもありません。対象にしたいコンテンツを、Categories、Sections、Articlesの各タブでオンにしてください。
翻訳がヘルプセンターに表示されない。 接続がDraftモードになっていないか確認してください。下書きはZendesk内にはありますが、公開されるまで読者には表示されません。