Cơ sở kiến thức Intercom

Chuyển kiến thức Intercom sang Quickchat AI trong vài phút. Nếu đang dùng Fin AI của Intercom và muốn chuyển sang Quickchat AI hoặc vận hành song song, các endpoint này giúp thực hiện dễ dàng. Toàn bộ Trung tâm trợ giúp Intercom (các bài viết dùng để Fin AI trả lời) có thể đồng bộ vào Cơ sở kiến thức Quickchat chỉ với một lệnh gọi API.

Cách hoạt động:

1. Kết nối tài khoản Intercom qua bảng điều khiển Quickchat hoặc tích hợp Intercom App Store
2. Dùng Nhập bài viết Intercom để đưa toàn bộ bài viết Trung tâm trợ giúp vào Cơ sở kiến thức Quickchat, có thể giới hạn ở các ngôn ngữ bạn chọn
3. Dùng Làm mới bài viết Intercom để giữ nội dung đồng bộ khi cập nhật bài viết trong Intercom
4. Nếu muốn ngắt kết nối, Xóa bài viết Intercom sẽ xóa sạch nội dung đã đồng bộ

Như vậy, AI Agent lập tức truy cập cùng kiến thức mà Fin AI dùng mà không cần di chuyển nội dung thủ công. Xem hướng dẫn đầy đủ trong Hướng dẫn kênh Intercom. Để tìm hiểu việc chuyển khỏi Fin AI, xem Quickchat thay thế Fin AI.

Làm mới bài viết Intercom

Lấy lại bài viết hiện có từ Intercom và nhập bài viết mới.

Bài viết được nhập với locales sẽ làm mới theo cùng các ngôn ngữ, và mọi phiên bản ngôn ngữ của một bài Intercom được làm mới cùng nhau.

Phạm vi: write_all

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

Nội dung yêu cầu

Tham số	Mô tả
article_ids mảng số nguyên	ID bài viết Cơ sở kiến thức cần lấy lại, như trả về bởi Liệt kê bài viết với types=Intercom. Mặc định: không có, nên không lấy lại bài hiện có nào. Để làm mới mọi bài, truyền tất cả ID.
fetch_new_articles boolean	Có lấy bài viết mới hay không (mặc định: true)

Phản hồi 200 OK (đối tượng JSON rỗng). Trả về 400 nếu một ID không phải bài Intercom trong Cơ sở kiến thức của bạn.

Liệt kê ngôn ngữ Trung tâm trợ giúp Intercom

Liệt kê ngôn ngữ được Trung tâm trợ giúp Intercom xuất bản, số bài đã xuất bản ở mỗi ngôn ngữ và các ngôn ngữ đề xuất nhập (ngôn ngữ AI Agent nếu Trung tâm trợ giúp có ngôn ngữ đó).

Phạm vi: read_all

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

Phản hồi 200 OK

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

Danh sách locales rỗng nghĩa là Trung tâm trợ giúp không xuất bản các phiên bản ngôn ngữ; hãy nhập mà không có locales.

Nhập bài viết Intercom

Nhập tất cả bài viết từ Intercom.

Phạm vi: write_all

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

Nội dung yêu cầu (tùy chọn)

Tham số	Mô tả
locales mảng chuỗi	Ngôn ngữ Trung tâm trợ giúp cần nhập, chẳng hạn ["uk"]. Mỗi ngôn ngữ được nhập thành các bài riêng và tính vào giới hạn bài viết của gói. Bỏ qua để nhập một phiên bản mỗi bài: tiếng Anh nếu có, nếu không thì ngôn ngữ mặc định của Trung tâm trợ giúp.

Phản hồi 200 OK: trả về danh sách ảnh chụp bài viết đã nhập. Trả về 400 nếu không có bài xuất bản bằng các ngôn ngữ đã chọn.

Xóa bài viết Intercom

Xóa toàn bộ bài viết có nguồn Intercom khỏi Cơ sở kiến thức.

Phạm vi: write_all

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

Phản hồi 200 OK (đối tượng JSON rỗng)

---