헬프 센터 연계 검색을 사용하면 최종 사용자들이 헬프 센터 외부에 있는 헬프 센터 검색 결과의 콘텐츠를 볼 수 있습니다. 즉, 최종 사용자가 헬프 센터에서 검색할 때 검색 결과가 헬프 센터 문서 또는 커뮤니티 게시물에만 국한되지 않습니다. 연계 검색은 예를 들어 외부 지식창고, 학습 관리 소프트웨어, 블로그 및 웹사이트의 페이지까지 검색 범위를 확장할 수 있습니다. 최종 사용자는 유형별(예: 블로그 게시물별)로 검색을 필터링할 수도 있습니다.
외부 콘텐츠 검색 결과는 헬프 센터 검색, 컨텍스트 패널의 지식 섹션 및 통합 검색 API 응답에 표시될 수 있습니다. 바로 검색이나 Article Search API와 같은 다른 검색 기반 인터페이스에는 나타나지 않습니다.
다음 방법 중 하나를 사용하여 헬프 센터에서 연계 검색을 구현할 수 있습니다.
- 웹 크롤러 - 웹 크롤러로 개발자 리소스 없이 헬프 센터에서 연계 검색을 구현할 수 있습니다. 헬프 센터 검색 설정에서 여러 크롤러를 설정하여 같은 웹사이트나 다른 웹사이트의 서로 다른 콘텐츠를 크롤링하고 인덱싱할 수 있습니다.
- 연계 검색 API - 이 REST API를 통해 외부 콘텐츠의 레코드를 Zendesk 검색 인덱스에 수집할 수 있습니다. 이 방법을 사용하려면 개발자가 외부 콘텐츠를 호스팅하는 사이트를 헬프 센터와 연동하기 위해 미들웨어 레이어를 빌드하여 유지 관리해야 합니다.
API와 크롤러를 동시에 사용할 수 있습니다. 하지만 API를 통해 소스나 유형을 삭제하면 삭제된 소스나 유형의 레코드를 만들거나 업데이트하는 모든 크롤러가 작동을 중지합니다.
이 문서에서 다루는 주제는 다음과 같습니다.
웹 크롤러 방법에 대한 정보
하나 이상의 웹 크롤러를 설정하여 헬프 센터에서 검색하는 사용자가 사용할 수 있도록 동일하거나 다른 웹사이트의 외부 콘텐츠를 크롤링하고 인덱싱할 수 있습니다.
연계 검색을 위한 웹 크롤러를 설정하려면 웹 크롤러를 사용하여 외부 콘텐츠 인덱싱하기를 참조하세요.
연계 검색 API 방법에 대한 정보
Zendesk는 개발자가 외부 콘텐츠 레코드를 헬프 센터 검색 인덱스에 수집하기 위해 사용자 지정 연동 서비스를 빌드할 수 있는 REST API를 제공합니다. 검색을 위한 외부 콘텐츠를 수집하려면 개발자가 외부 콘텐츠를 호스팅하는 애플리케이션을 외부 콘텐츠 API와 통합해야 합니다.
API를 사용하여 연계 검색을 구성하려면 Zendesk REST API로 자체 연동을 구축한 후 검색 결과에 표시하려는 콘텐츠를 수집하세요. 연계 검색 API 참조 문서를 참조하세요.
연계 검색을 설정한 후에는 헬프 센터 검색 결과에 포함 및 제외하려는 콘텐츠를 선택해야 합니다. 헬프 센터 검색 결과에 외부 콘텐츠 포함하기를 참조하세요.
상담사를 위한 컨텍스트 패널의 지식 섹션에서 검색 결과에 외부 콘텐츠를 포함할 수도 있습니다. 컨텍스트 패널에서 지식 섹션 구성하기를 참조하세요.
외부 콘텐츠 소스 및 유형
사용하는 설정 방법에 관계없이 연계 검색으로 수집되는 각 콘텐츠 레코드는 최종 사용자가 검색 결과를 필터링하는 데 사용되는 콘텐츠 소스 및 콘텐츠 유형과 연결됩니다. 소스는 포럼, 문제 추적, 학습 관리 시스템 등 외부 콘텐츠의 출처를 나타냅니다. 유형은 블로그 게시물, 기술 노트, 버그 리포트 등 콘텐츠의 종류를 나타냅니다. 헬프 센터의 외부 콘텐츠를 위한 소스 및 유형 필터 관리하기를 참조하세요.
연계 검색 API를 사용하거나 웹 크롤러를 설정할 때 소스와 유형을 정의할 수 있습니다. API를 사용하여 소스와 유형을 정의하면 웹 크롤러 설정 중에 그러한 소스와 유형을 선택할 수 있습니다. 마찬가지로 웹 크롤러를 설정할 때 콘텐츠 소스와 유형을 만들면 외부 콘텐츠 유형 및 외부 콘텐츠 소스 API에 반영됩니다.
외부 콘텐츠 소스를 포함하거나 제외하도록 검색 결과를 구성할 수 있습니다. 헬프 센터 검색에 외부 콘텐츠가 포함되면 검색 필터가 소스 및 유형 이름별로 콘텐츠를 그룹화하여 사용자들이 원하는 정보를 더 쉽게 찾을 수 있도록 합니다. “소스”는 출처(예를 들어 블로그)별로 콘텐츠를 그룹화하고 “유형”은 콘텐츠 종류(예를 들어 개발자 문서)별로 콘텐츠를 그룹화합니다.
소스와 유형을 만들 때 외부 콘텐츠 소스 및 유형에 대한 유용한 그룹화와 이름을 고려하세요. 최종 사용자들이 헬프 센터에서 검색하는 콘텐츠를 쉽게 필터링하여 찾는 데 도움이 됩니다.