Внешняя интеграция бота (API)

Подключите вашего бота-консультанта к другой системе — CRM, сайту, телефонии: отправляйте сообщения по HTTP и получайте ответы. Бот сам ищет ответ в базе знаний и обращается к подключённым источникам, а вы можете передать ему контекст клиента.

Что нужно

Создайте бота в разделе Боты и запомните его slug — он показан в Настройки → Интеграции → Внешняя интеграция бота.
Выпустите API-токен со scope bot:chat (Настройки → Интеграции → Создать токен).

Вызов

POST https://sensei.red/api/bot/{slug}/chat
Authorization: Bearer ВАШ_ТОКЕН
Content-Type: application/json

{
  "message": "Хочу записать ребёнка на робототехнику",
  "session_id": "client-42",
  "context": "Клиент: Иван, тел +7..., абонемент до 2026-09"
}

Параметры запроса

message — сообщение пользователя (обязательно).
session_id — идентификатор диалога. Передавайте один и тот же в рамках разговора, чтобы бот помнил историю.
context — необязательный контекст: данные клиента, состояние записи и т.п. Бот учитывает его как справочные данные.

Ответ

{ "answer": "...", "sources": [...], "session_id": "...", "is_empty": false }

Бот при этом сам обращается к подключённым внешним источникам (например, CRM записи). Данные из источников и переданный context объединяются в одном ответе.

Slug подставляется в URL: для бота с slug consultant адрес будет /api/bot/consultant/chat. Управление ботами — раздел «Боты», выпуск токенов — «Настройки → Интеграции».