20.03.2026 16:20

Writing

[POST] .../v1/chatmessage/writing

Отправляет событие «печатает» в чате.

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

Название Тип данных Обязательность Описание
chat_id String Обязательный UUID чата
author_entity_type String(ChatEntityTypeEnum) Необязательный Тип сущности автора события writing (только вместе с author_entity_id)
author_entity_id Int64 Необязательный Идентификатор сущности автора события writing (только вместе с author_entity_type)

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

  • chat_id обязателен и должен быть корректным UUID чата.
  • author_entity_type и author_entity_id передаются только парой; передача одного из полей без второго недопустима.
  • Метод доступен только пользователю, у которого есть доступ к чату.
  • Без права chat_manage_all (688) метод доступен только участнику чата.
  • При праве chat_manage_all (688) участником чата быть не обязательно.
  • Если передан кастомный автор:
    • для не-ChatBot требуется право chat_manage_all (688);
    • указанный автор должен быть участником чата;
    • для ChatBot допускается вызов без членства текущего пользователя в чате (при условии, что бот является участником).
  • Метод отправляет сервисное событие «печатает» и не создает запись сообщения.
  • Идентичные события writing от одного автора в одном чате сервер может кратковременно дедуплицировать (debounce), чтобы снизить лишнюю нагрузку на webhook.

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

{
  "chat_id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef",
  "author_entity_type": "ChatBot",
  "author_entity_id": 12
}

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

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

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

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