База знаний Intercom

Перенесите знания Intercom в Quickchat AI за несколько минут. Если вы используете Fin AI от Intercom и хотите перейти на Quickchat AI или запустить обе системы параллельно, эти endpoints упрощают переход. Весь справочный центр Intercom (статьи, на которых основаны ответы Fin AI) можно синхронизировать с Базой знаний Quickchat одним API-вызовом.

Как это работает:

1. Подключите аккаунт Intercom через панель управления Quickchat или интеграцию в Intercom App Store
2. Используйте Импорт статей Intercom, чтобы загрузить все статьи справочного центра в Базу знаний Quickchat, при необходимости только на выбранных языках
3. Используйте Обновление статей Intercom, чтобы синхронизировать содержимое после изменений в Intercom
4. Если вы решите отключить интеграцию, Удаление статей Intercom удалит всё синхронизированное содержимое

Так AI-агент сразу получает доступ к тем же знаниям, которые использует Fin AI, без ручного переноса содержимого. Полное описание интеграции см. в руководстве по каналу Intercom. Подробнее о переходе с Fin AI: Quickchat как альтернатива Fin AI.

Обновление статей Intercom

Заново загрузите существующие статьи из Intercom и импортируйте новые.

Статьи, импортированные с locales, обновляются на тех же языках. Все языковые версии одной статьи Intercom обновляются вместе.

Права: write_all

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

Тело запроса

Параметр	Описание
article_ids массив целых чисел	ID статей Базы знаний для повторной загрузки, полученные через Список статей с types=Intercom. По умолчанию список пуст, поэтому существующие статьи не обновляются. Чтобы обновить все, передайте все их ID.
fetch_new_articles логическое значение	Загружать ли новые статьи (по умолчанию: true)

Ответ 200 OK (пустой JSON-объект). Возвращает 400, если ID не соответствует статье Intercom в вашей Базе знаний.

Список языков справочного центра Intercom

Получите языки справочного центра Intercom, число опубликованных статей на каждом языке и рекомендуемые языки для импорта (язык 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 означает, что справочный центр не публикует языковые версии; импортируйте без locales.

Импорт статей Intercom

Импортируйте все статьи из Intercom.

Права: write_all

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

Тело запроса (необязательно)

Параметр	Описание
locales массив строк	Языки справочного центра для импорта, например ["uk"]. Каждый язык импортируется отдельными статьями, которые учитываются в лимите тарифа. Не указывайте параметр, чтобы импортировать по одной версии каждой статьи: английскую, если она доступна, иначе версию на языке справочного центра по умолчанию.

Ответ 200 OK: возвращает список снимков импортированных статей. Возвращает 400, если на выбранных языках нет опубликованных статей.

Удаление статей Intercom

Удалите из Базы знаний все статьи, полученные из Intercom.

Права: write_all

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

Ответ 200 OK (пустой JSON-объект)

---