Guruを外部ナレッジソースとして接続する方法

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

ナレッジベース Professional または Enterprise

要約：◀▼

Guruを外部ナレッジソースとして接続すると、指定したコレクションから公開済みのコンテンツを同期できます。閲覧者権限の設定、手動でのコンテンツの再同期、コネクションの削除などを行って、コネクションを管理できます。同期は24時間ごとに実行され、ワークフローに変更が反映されます。このインテグレーションには管理者権限が必要であり、メールアドレスとAPIトークンを使用して、承認されたコンテンツのみに安全にアクセスできます。

GuruをZendeskアカウントに接続すると、外部コンテンツが使用されるすべての場所で、Guruのコンテンツを利用できるようになります。Guruを外部ナレッジソースとして接続すると、セットアップ時に指定したコレクション内の公開済みカードからコンテンツを取り込むことができます。

Zendeskで外部コンテンツのコネクションを設定して管理するには、ナレッジベース管理者である必要があります。Guru内でコンテンツを同期するために必要なAPIキーを作成するには、Guruの管理者権限が必要です。Guruコネクタは、メールアドレスとAPIキーによって認証されます。これにより、Guru内でアクセス権限のあるコンテンツのみを同期できます。

この記事では、以下のトピックについて説明します。

Guruコネクションを設定する
Guruコネクションでのコンテンツの追加または削除
Zendeskアカウントに接続されたGuruサイトを管理する

関連記事：

Guruコネクションを設定する

Guruコネクションを設定することで、Guruコレクションと接続し、コンテンツを同期させることができます。Guruコレクションを接続したら、この外部コンテンツを使用するようにワークフローを設定できます。Guruコレクションを同期すると、コンテンツを含む公開済みカードが自動的に同期されます。

SharePointコネクションを設定するには

「ナレッジベースの管理」で、サイドバーの「記事の管理」（）をクリックします。
「外部コンテンツ」>「コネクション」をクリックします。
Guruカードの「利用可能なソース」セクションで、「接続」をクリックします。
「続行」をクリックします。
「認証」タブで、Guruに接続するための以下の認証情報を入力し、「続行」をクリックします。
- メールアドレス：Guruアカウントへのアクセスに使用するメールアドレス。コネクションを作成するにはGuruの管理者である必要があり、Guru内でアクセス権限のあるコンテンツのみを同期できます。
- APIトークン：Guru内のメールアドレスに関連付けられたユーザートークンです。このユーザートークンは、既存のアカウント権限に基づいてGuru内での読み取りおよび書き込みアクセス権を提供します。このフィールドの上にある「管理」>「APIアクセス」をクリックすると、ユーザートークンを生成できるGuru内のページにアクセスできます。詳細については、Guruのヘルプセンターにある「Leveraging Guru's API（GuruのAPIを活用する）」を参照してください。
「範囲を定義」タブの「コレクション」フィールドで、同期する公開済みコンテンツを含むGuruコレクションを選択し、「同期」をクリックします。
「コネクション」ページにGuruが追加され、同期が開始されます。

Guruコネクションでのコンテンツの追加または削除

Guruコネクションを設定する際に、接続するコレクションを指定します。複数のGuruコネクションを作成できますが、各コネクションに含まれるコレクションは1つのみです。コレクション内にコンテンツが含まれるすべての公開済みカードは、コネクションに同期されます。

Guruコレクションでコンテンツを追加または削除するには、Guruでコンテンツを追加または削除した後、自動同期を待つか、手動でコレクションを再同期します。新しいコンテンツ項目は、「コネクション」ページのGuruコネクションの「項目数」に反映されます。

メモ：同期（手動または自動）が完了するまで最大24時間かかる場合があります。

Zendeskアカウントに接続されたGuruサイトを管理する

Guruコネクションを作成すると、そのコネクションに関する情報を確認したり、コンテンツの閲覧権限を設定したり、コンテンツを手動で再同期したり、コネクションを削除したりできます。

ここでは、以下のトピックについて説明します。

Guruコネクションの情報を表示する
Guruのコンテンツの閲覧者権限を管理する
Guruのコンテンツを手動で再同期する
Guruコネクションを切断する

Guruコネクションの情報を表示する

情報パネルで、Guruコネクションに関する情報、作成日時や作成者、最後の同期日時などを確認できます。

Guruコネクションの情報を表示するには

「ナレッジベースの管理」で、サイドバーの「記事の管理」（）をクリックします。
「外部コンテンツ」>「コネクション」をクリックします。
管理するコネクションの行にあるオプションメニュー（）をクリックし、「管理」を選択します。
コネクションの詳細情報を確認します。
- 作成日時：コネクションが作成された日時
- 接続したユーザー：コネクションを作成したナレッジベース管理者の名前
- 項目：サイト内の接続済み項目数
- ステータス：同期のステータス
- 前回の同期：前回の同期が行われた日時。同期は24時間ごとに自動で行われますが、手動で同期を開始することも可能です。

Guruのコンテンツの閲覧者権限を管理する

Zendeskワークフロー内の接続済みGuruのコンテンツについて、閲覧できるユーザーを設定できます。

Guruのコンテンツの閲覧者権限を管理するには

「ナレッジベースの管理」で、サイドバーの「記事の管理」（）をクリックします。
「外部コンテンツ」>「コネクション」をクリックします。
管理するコネクションの行にあるオプションメニュー（）をクリックし、「管理」を選択します。
「閲覧権限」で、以下のオプションのいずれかを選択して、このGuruコンテンツを閲覧できるユーザーセグメントを指定します。
- 選択したユーザーセグメントのみに表示：以下のいずれかのユーザーセグメントを選択します。Enterpriseプランでは、最大10個のユーザーセグメントを選択できます。
  - サインインユーザー：アカウントを作成してヘルプセンターにサインインした社内外のユーザーが含まれます。
  - エージェントと管理者：チームメンバーのみ。このセグメントを対象に、社内専用のコンテンツを作成できます。
    メモ：ライトエージェントはこのセグメントに含まれます。ライトエージェントの権限のリストについては、「ライトエージェントの権限の概要と設定方法」を参照してください。
  - カスタムユーザーセグメント：タグ、組織、またはグループに基づいて閲覧アクセスを制限できます。詳しくは「ユーザーセグメントを作成してヘルプセンターへの閲覧アクセスを制限する方法」を参照してください。
- 全員に表示：ヘルプセンターを訪問するすべてのユーザーが対象となり、サインインは不要です。
「保存」をクリックします。

Guruのコンテンツを手動で再同期する

Guruを外部コンテンツソースとして接続すると、24時間ごとに同期処理が実行され、新規または変更されたコンテンツが更新されます。いつでも手動で再同期を行い、新たな同期を開始することができます。同期が完了するまで最大24時間かかる場合があります。

Guruのコンテンツを手動で再同期するには

「コネクション」ページで、同期するコネクションのオプションメニュー（）をクリックします。
「再同期」を選択します。
Guruコネクションが即座に同期され、「前回の同期」列が最新の同期日時で更新されます。

Guruコネクションを切断する

Guruのコンテンツの同期が不要になった場合は、Guruとのコネクションを切断できます。コネクションを削除すると、そのコネクション内のすべてのサイトのコンテンツも削除されます。

コネクションを削除すると、そのコネクションに関連するコンテンツは、外部コンテンツが使用されるすべての場所で利用できなくなります。

Guruコネクションを切断するには

「コネクション」ページで、切断するGuruコネクションのオプションメニュー（）をクリックします。
「コネクションを削除」を選択します。
メッセージを確認し、「コネクションを削除」をクリックします。
Guruコネクションは「コネクション」リストから削除され、外部コンテンツのソースとして利用できなくなります。