28.05.2026 00:00

Edit

[POST] .../v1/chatmessage/edit

Редактирует сообщение чата.

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

Название Тип данных Обязательность Описание
id String Обязательный UUID сообщения
text String Необязательный Новый текст сообщения
mentions Array of CommonMentionInput Необязательный Новый список структурированных упоминаний в text
mention_options CommonMentionOptions Необязательный Опции обработки упоминаний
file_ids Array of Int64 Необязательный Новый список файлов

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

  • id обязателен и должен быть корректным UUID сообщения.
  • Метод доступен только пользователю, у которого есть доступ к чату сообщения.
  • Для обычных чатов проверяется право chat_message_edit (686).
  • Для чатов, связанных с Lead/Deal/Ticket/Task, редактирование наследует права сущности: требуется Edit у связанной сущности (заменяет права chat_message_*).
  • Для закрытого чата (closed = true) редактирование сообщения отклоняется с ошибкой 1220.
  • Нужно передать хотя бы одно поле для изменения: text или file_ids.
  • Если text передан пустой строкой, текст сообщения очищается.
  • Если передан mentions, поле text обязательно.
  • При изменении text список mentions полностью заменяет прежние упоминания сообщения; если text передан без mentions, прежние упоминания очищаются.
  • По умолчанию можно упоминать только участников чата. Если mention_options.add_missing_users_to_context = true, упомянутые пользователи добавляются в контекст через участников чата или связанной сущности.
  • Если file_ids передан пустым массивом, вложения очищаются.
  • Текст проходит серверную нормализацию markdown: поддерживаются только bold, italic, underline, strike, link, pre.
  • Все HTML-теги и неподдерживаемое форматирование удаляются из текста.
  • Для каждого переданного file_id выполняется та же нормализация, что и в ChatMessage/Add.
  • Если входной файл не является chat-owned system-файлом текущего чата, сервер создает его копию в папке чата и сохраняет уже новый file_id.
  • Файлы, удаленные из сообщения, физически удаляются только если на них больше нет ссылок из других неудаленных сообщений.

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

{
  "id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "text": "Уточненное сообщение",
  "file_ids": [
    101
  ]
}

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

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

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

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