横串検索の外部コンテンツAPIは、Zendeskの検索インデックスに外部コンテンツのレコードを取り込むことができるREST APIです。この方法では、外部コンテンツをホストするサービス、Webサイト、LMS、ブログなどとヘルプセンターを統合するためのミドルウェア層を、開発者が構築し、維持する必要があります。
開発者の支援なしで横串検索を設定するには、外部コンテンツ検索クローラーを使用します。「Zendeskの横串検索について」を参照してください。
メモ:2019年9月25日までにヘルプセンターをセットアップし、カスタムテーマを作成している場合は、テーマを変更して、複数のヘルプセンターからの検索結果を表示する必要があります。
外部コンテンツAPIを使用して横串検索を設定する
外部コンテンツAPIを使用してヘルプセンターに横串検索を設定するには、以下のプロセスフローの手順を参考にしてください。
-
検索結果に表示したいコンテンツを取り込むためには、Zendesk REST APIとのインテグレーションを独自に構築します。詳しくは「横串検索APIリファレンス」を参照してください。
-
ヘルプセンターの検索結果に含めるコンテンツと除外するコンテンツを選択します。詳しくは「ヘルプセンターの検索結果に外部コンテンツを含める方法」を参照してください。
-
ヘルプセンターのテーマを横串検索用に設定します。
外部コンテンツがヘルプセンター検索の検索結果に表示されるようにするには、横串検索結果に対応したテーマが必要です。それには、最新バージョンのCopenhagenテーマを使うか、古い{{help_center_filters}}ヘルパーと{{filters}}ヘルパーを新しい{{source_filters}}ヘルパーと{{type_filters}}ヘルパーに置き換えてください(「ヘルプセンターのテンプレート言語のレシピ集」を参照)。
-
必要に応じて、ナレッジベース検索に外部コンテンツが含まれるようにナレッジベース結果を設定します。詳しくは「Zendeskエージェントワークスペースでのコンテキストパネルの設定」を参照してください。