28.06.2026 12:20

Callback

[POST] .../v1/chatmessage/callback

Публикует callback-действие inline-кнопки сообщения.

Метод не выполняет бизнес-действие сам. Он проверяет доступ пользователя к сообщению и наличие кнопки, после чего публикует событие ChatMessageCallback.

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

Название Тип данных Обязательность Описание
message_id String Обязательный UUID сообщения
action_id String Обязательный Идентификатор callback-действия внутри actions сообщения

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

  • message_id обязателен и должен быть корректным UUID существующего сообщения.
  • action_id обязателен и должен существовать в actions указанного сообщения.
  • Пользователь должен иметь доступ к чату и право на запись сообщения по тем же правилам, что и для ChatMessage/SetReaction.
  • Для чатов, связанных с Lead/Deal/Ticket/Task, write-доступ наследуется от связанной сущности.
  • Если чат или связанная сущность закрыты для write-операций, callback отклоняется.
  • Событие ChatMessageCallback сохраняется в истории событий и доступно через Event/Get.

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

{
  "message_id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "action_id": "approve"
}

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

Название Тип данных Описание
result.row_affected Int64 Количество обработанных callback-действий
result.ids Array of String UUID сообщения, для которого опубликован callback

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [
      "9beec41f-6ef5-4e87-b4ea-05895cff2c54"
    ]
  }
}