25.03.2026 15:10

AddBot

[POST] .../v1/chat/addbot

Добавляет чат-бота в чат по connected_integration_id.

Входные параметры

Название Тип данных Обязательность Описание
chat_id String Обязательный UUID чата
connected_integration_id String Обязательный ID подключенной интеграции

Ограничения и проверки

  • chat_id должен быть корректным UUID существующего чата.
  • connected_integration_id обязателен.
  • Интеграция по connected_integration_id должна существовать, быть активной и иметь тип ChatBot.
  • Метод доступен владельцу чата (created_user_id) или пользователю с правом chat_manage_all (688).
  • Метод работает как для обычных чатов, так и для чатов, связанных с сущностями Lead/Deal/Ticket/Task.
  • Добавление бота выполняется через отдельную сущность ChatBot и роль участника Bot.
  • Для чат-бота не создаются записи персональной read-истории (ctlg_cht_message_users_ref).

Пример запроса

{
  "chat_id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef",
  "connected_integration_id": "c98210addc4f4e1bb50b17a8c1299a37"
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}