Intercom Knowledge Base

Intercom の知識を数分で Quickchat AI に移行できます。 Intercom の Fin AI を使用していて、Quickchat AI に切り替えたい場合、または両方を並行して運用したい場合、これらのエンドポイントがそれをシームレスにします。Intercom Help Center 全体（Fin AI の応答を支える記事）を、1 回の API 呼び出しで Quickchat の Knowledge Base に同期できます。

仕組み:

1. Quickchat Dashboard または Intercom App Store integration 経由で Intercom アカウントを接続します
2. Import Intercom Articles を使って、すべての Help Center 記事を Quickchat の Knowledge Base に取り込みます（選択した言語のみに限定することもできます）
3. Refresh Intercom Articles を使って、Intercom で記事を更新するたびにコンテンツを同期した状態に保ちます
4. 切断する場合は、Delete Intercom Articles が同期されたすべてのコンテンツをきれいに削除します

これにより、AI Agent は手動でのコンテンツ移行なしで、Fin AI が使用するのと同じ知識にすぐにアクセスできます。Intercom 連携の完全なウォークスルーについては、Intercom channel ガイド を参照してください。Fin AI からの切り替えについて詳しくは、Quickchat as a Fin AI alternative をご覧ください。

Refresh Intercom Articles

既存の記事を Intercom から再取得し、新しい記事をインポートします。

locales を指定してインポートした記事は同じ言語で更新され、Intercom 記事のすべての言語版がまとめて更新されます。

スコープ: write_all

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

Request Body

Parameter	Description
article_ids array of integers	再取得する Knowledge Base 記事の ID。types=Intercom を指定した List Articles で取得できます。デフォルト：なし（既存の記事は再取得されません）。すべての記事をリフレッシュするには、すべての記事の ID を渡します。
fetch_new_articles boolean	新しい記事を取得するかどうか（デフォルト：true）

Response 200 OK（空の JSON オブジェクト）。ID が Knowledge Base 内の Intercom 記事でない場合は 400 を返します。

List Intercom Help Center Languages

Intercom Help Center が公開している言語と、それぞれの公開記事数、およびインポートに推奨される言語（Help Center にある場合は AI Agent の言語）を一覧表示します。

スコープ: read_all

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

Response 200 OK

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

locales が空の場合、Help Center は言語版を公開していません。locales を指定せずにインポートしてください。

Import Intercom Articles

Intercom からすべての記事をインポートします。

スコープ: write_all

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

Request Body （任意）

Parameter	Description
locales array of strings	インポートする Help Center の言語（例：["uk"]）。言語ごとに個別の記事としてインポートされ、プランの記事数の上限にカウントされます。省略すると、各記事の 1 つのバージョンをインポートします（英語版があれば英語、なければ Help Center のデフォルト言語）。

Response 200 OK — インポートされた記事のスナップショットのリストを返します。 選択した言語で公開されている記事がない場合は 400 を返します。

Delete Intercom Articles

Intercom 由来のすべての記事を Knowledge Base から削除します。

スコープ: write_all

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

Response 200 OK（空の JSON オブジェクト）

---