Категоризировать диалог

Отправляет завершённый диалог на категоризацию боту-категоризатору. Базовый URL метода — `https://api.wikibot.pro/api`, без `/bot`. Обработка асинхронная: метод сразу возвращает идентификатор запроса, а результат отправляется на webhook URL бота — см. [Подключения бота-категоризатора](/docs/categorizer/connections#api).

POST
/categorize

Authorization

Authorization<token>

In: header

Request Body

application/jsonRequired
chatIdRequiredstring

Идентификатор диалога или тикета в вашей системе

dialogRequiredstring

Текст диалога, который нужно категоризировать

dialogStartedAtstring

Дата и время начала диалога в формате ISO 8601. Используется как ось времени в отчётах — если не передана, берётся время обработки

Format: "date-time"
dialogEndedAtstring

Дата и время окончания диалога в формате ISO 8601

Format: "date-time"
metaobject

Произвольные дополнительные данные о диалоге. Сохраняются вместе с результатом и не влияют на классификацию

Response Body

200

Диалог принят в обработку

requestIdRequiredstring

Идентификатор запроса. По нему запрос можно найти в журнале бота

chatIdRequiredstring

Идентификатор диалога, переданный в запросе

400

Неверный формат запроса или бот не является категоризатором

errorRequiredinteger
Format: "int32"
messageRequiredstring

403

Интеграция отключена

errorRequiredinteger
Format: "int32"
messageRequiredstring
curl -X POST "https://api.wikibot.pro/api/bot/categorize" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "chatId": "12345",
    "dialog": "Клиент: не могу оплатить подписку картой\nОператор: попробуйте другую карту\nКлиент: спасибо, получилось",
    "dialogStartedAt": "2026-08-01T09:15:00Z",
    "dialogEndedAt": "2026-08-01T09:42:00Z",
    "meta": {
      "channel": "telegram"
    }
  }'

Диалог принят в обработку

{
  "requestId": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
  "chatId": "12345"
}