Intercom 지식 베이스

몇 분 안에 Intercom 지식을 Quickchat AI로 이전하세요. Intercom Fin AI에서 Quickchat AI로 전환하거나 둘을 함께 사용하려면 이 엔드포인트를 이용하세요. Fin AI 응답의 기반이 되는 전체 Intercom Help Center 문서를 API 호출 한 번으로 Quickchat 지식 베이스에 동기화할 수 있습니다.

작동 방식:

1. Quickchat 대시보드 또는 Intercom App Store 연동으로 Intercom 계정을 연결합니다.
2. Intercom 문서 가져오기로 전체 Help Center 문서를 Quickchat 지식 베이스에 가져옵니다. 원하면 선택한 언어만 가져올 수 있습니다.
3. Intercom에서 문서를 수정할 때 Intercom 문서 새로고침으로 동기화 상태를 유지합니다.
4. 연결을 해제하려면 Intercom 문서 삭제로 동기화된 모든 콘텐츠를 제거합니다.

수동으로 콘텐츠를 이전하지 않아도 AI 에이전트가 Fin AI와 같은 지식을 바로 사용할 수 있습니다. 전체 연동 절차는 Intercom 채널 가이드를 참고하세요. Fin AI에서 전환하는 방법은 Fin AI 대안으로서의 Quickchat을 확인하세요.

Intercom 문서 새로고침

Intercom의 기존 문서를 다시 가져오고 새 문서를 가져옵니다.

locales로 가져온 문서는 같은 언어로 새로고침되며 Intercom 문서의 모든 언어 버전이 함께 새로고침됩니다.

권한 범위: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/refresh_articles

요청 본문

매개변수	설명
article_ids 정수 배열	types=Intercom으로 문서 목록을 호출하여 반환받은, 다시 가져올 지식 베이스 문서 ID입니다. 기본값은 없음이며 기존 문서를 다시 가져오지 않습니다. 전체를 새로고침하려면 모든 ID를 전달하세요.
fetch_new_articles 불리언	새 문서를 가져올지 여부(기본값: true)

응답 200 OK(빈 JSON 객체). ID가 지식 베이스의 Intercom 문서가 아니면 400을 반환합니다.

Intercom Help Center 언어 목록

Help Center에서 게시한 언어별 문서 수와 가져오기를 제안하는 언어를 반환합니다. 제안은 Help Center에 존재하는 경우 AI 에이전트의 언어를 사용합니다.

권한 범위: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/intercom/locales

응답 200 OK

{
  "locales": [
    { "locale": "uk", "article_count": 259 },
    { "locale": "en", "article_count": 220 }
  ],
  "suggested_locales": ["uk"]
}

locales 목록이 비어 있으면 Help Center가 언어별 버전을 게시하지 않는 것입니다. locales 없이 가져오세요.

Intercom 문서 가져오기

Intercom의 모든 문서를 가져옵니다.

권한 범위: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/import

요청 본문(선택 사항)

매개변수	설명
locales 문자열 배열	["uk"]처럼 가져올 Help Center 언어입니다. 언어별로 별도 문서가 생성되어 요금제 문서 한도에 포함됩니다. 생략하면 각 문서를 한 버전씩 가져오며 영어가 있으면 영어, 없으면 Help Center 기본 언어를 사용합니다.

응답 200 OK: 가져온 문서 스냅샷 목록을 반환합니다. 선택한 언어로 게시된 문서가 없으면 400을 반환합니다.

Intercom 문서 삭제

지식 베이스에서 Intercom에서 가져온 모든 문서를 제거합니다.

권한 범위: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/delete

응답 200 OK(빈 JSON 객체)

---