25.03.2026 15:10

MarkSent

[POST] .../v1/chatmessage/marksent

Проставляет внешней системе идентификатор отправленного сообщения.

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

Название Тип данных Обязательность Описание
id String Обязательный UUID сообщения
external_message_id String Обязательный Внешний ID сообщения

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

  • Поля id и external_message_id обязательны.
  • id должен быть корректным UUID сообщения.
  • Метод доступен только пользователю, у которого есть доступ к чату сообщения.
  • Для обычных чатов проверяется право chat_message_add (685).
  • Для чатов, связанных с Lead/Deal/Ticket/Task, доступ наследуется от сущности: требуется Edit у связанной сущности (заменяет права chat_message_*).
  • Для закрытого чата (closed = true) операция отклоняется с ошибкой 1220.
  • Метод применяется только к обычным (Regular) и не удаленным сообщениям.
  • external_message_id можно установить только один раз.
  • Если повторно передан тот же external_message_id, метод работает идемпотентно и возвращает успешный результат.
  • Если у сообщения уже установлен другой external_message_id, возвращается ошибка валидации.

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

{
  "id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "external_message_id": "provider-994533"
}

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

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

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

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