外部コンテンツのインデックス作成のための Zendesk の構成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:4分
  • Zendesk アドミンセンターで API トークンを作成して、Zendesk Guide 外部コンテンツコネクタが Zendesk ソースシステムにアクセスできるようにします。

    始める前に

    Zendeskインスタンスへのアドミニストレーターアクセス権が必要です。

    必要なロール:なし

    このタスクについて

    Zendesk Guide 外部コンテンツコネクタは、Zendesk API を使用してZendeskソースシステムからドキュメントとユーザー権限を取得します。

    コネクタが Zendesk API を介して Zendesk ソースシステムにアクセスできるようにするには、Zendesk アドミンセンターで API トークンを作成する必要があります。ServiceNow AI Platformインスタンスアドミンは、この API トークンを使用して、ソースシステムに適切に接続できるように Zendesk Guide 外部コネクタを構成できます。

    手順

    1. https://<subdomain>.zendesk.com に移動します。ここで<サブドメイン>Zendeskインスタンスの一意の識別子です。
    2. Zendesk アドミニストレーターの認証情報でログインします。
    3. アイコン を選択してアプリ メニューを開き、[ 管理センター] を選択します。
      Zendeskアプリメニューのアドミンセンターのリンク。
    4. [アドミンセンター] メニューで、 アプリと統合 > API 一覧 > OAuth クライアント.

      管理センターのメニュー ラベルが表示されない場合は、 [アプリと統合] アイコンを選択してメニューを展開し、移動します。

    5. [OAuth クライアント Zendesk ] ページで、[ OAuth クライアントの追加] を選択します。
      [ OAuth クライアントを追加] ボタンがある Zendesk の OAuth クライアントページ。
      [OAuth クライアントを追加 (Add OAuth client)] ページが表示されます。
    6. [OAuth クライアントを追加] ページで、フィールドに入力します。
      フィールド 説明
      名前* (必須) 新しい OAuth 2.0 クライアントアプリケーションの名前を入力します。たとえば、「 Zendesk Guide external content connector」と入力します。
      説明 * 新しい OAuth 2.0 クライアントアプリケーションの簡単な説明を入力します。この説明は、アプリケーションへのアクセス権の付与を求められたときにユーザーに表示されます。たとえば、「 ServiceNow Zendesk Guide 外部コンテンツコネクタが Zendesk ソースシステムにアクセスできるようにするアプリ」と入力します。
      会社* 組織の名前を入力します。たとえば、「 Example.com」と入力します。
      識別子* コードで新しい OAuth 2.0 クライアントアプリケーションを参照するときに使用する識別子文字列を入力します。デフォルトの識別子は、入力したアプリケーション名から自動的に生成されますが、別の値を使用する場合は上書きできます。
      重要:
      ServiceNow AI Platformアドミニストレーターは、Zendesk外部コンテンツコネクタを構成するときにこのクライアント識別子を必要とします。
      クライアントの種類 [機密] を選択します。
      リダイレクト URL https://<instance-name>.service-now.com/oauth_redirect.do を入力します。ここで <instance-name> は、外部コンテンツコネクタを作成して実行する ServiceNow AI Platform® インスタンスのホスト名です。たとえば、「 https://example.service-now.com/oauth_redirect.do」と入力します。
      Zendeskで OAuth クライアントページを追加します。
    7. [Save (保存)] を選択します。
      Zendesk 新しい OAuth 2.0 クライアントアプリケーションが追加され、生成されたクライアントシークレットが [OAuth クライアントの追加] ページの下部に表示されます。
    8. 新しい OAuth 2.0 クライアントアプリケーションの シークレット をコピーし、安全な場所に保存します。
      生成されたクライアントシークレットを示す [Zendeskに OAuth クライアントを追加] ページ。
      重要:
      ServiceNow AI Platformアドミニストレーターは、Zendesk外部コンテンツコネクタを構成するときにこのクライアントシークレットが必要です。
    9. [Save (保存)] を選択します。
      新しい OAuth 2.0 クライアントアプリケーションを表示する Zendesk の [OAuth クライアント] ページ。
      Zendesk は、生成されたシークレットで新しい OAuth 2.0 クライアントアプリケーションを更新します。新しいアプリケーションが [ Zendesk OAuth クライアント] ページに表示されます。

    次のタスク

    ServiceNow AI Platformアドミンに次のアイテムを提供します。
    • ステップ 6 で入力した OAuth 2.0 クライアント識別子。
    • ステップ 8 で保存したクライアントシークレット。

    ServiceNow AI Platformアドミンは、Zendeskソースシステムから検索可能なコンテンツとセキュリティプリンシパルを取得するように Zendesk Guide 外部コンテンツコネクタを構成するために、これらの設定を必要としています。

    Zendesk Guide 外部コンテンツコネクターの作成と構成の詳細については、「Zendeskガイド外部コンテンツコネクタの作成」を参照してください。