Skip to content

Объекты ​

Пустые поля обычно в JSON не попадают.

User ​

ПолеТип
idstringid аккаунта.
namestringИмя.
botboolАккаунт — бот.

Chat ​

ПолеТип
idstringУ личного чата — id собеседника.
typestringdirect или group.
titlestringИмя собеседника или название группы.
membersstring[]id участников группы.
ownerstringВладелец группы.
requestboolЕщё не принят: запрос на переписку или приглашение.
botboolЛичный чат с другим ботом.
expire_secintТаймер исчезающих сообщений, секунды.

Message ​

ПолеТип
idstring
chat_idstring
fromUserОтправитель; у своих сообщений его нет.
tsintВремя отправки, мс.
statusstringТолько у своих: pending, sent, delivered, read, failed.
textstring
mentionsMention[]
reply_tostringid цитируемого сообщения.
attachmentAttachment
pollPoll
reactions{from, emoji}[]from пуст у реакции самого бота.
edited_tsintПоследняя правка, мс.
expire_secintСообщение исчезнет через столько секунд.
buttonsButton[][]

Mention ​

{user, offset, length}: id аккаунта и место упоминания в text, в единицах UTF-16.

Attachment ​

ПолеТип
kindstringphoto, video, voice, file.
mimestring
namestringИмя файла.
sizeintБайты.
captionstring
width, heightintФото и видео.
duration_msintВидео и голосовые.

Содержимого в событии нет: скачивайте через GET …/messages/{msg}/file.

Poll ​

ПолеТип
questionstring
options{text, voters}[]voters — id аккаунтов.
multipleboolМожно выбрать несколько вариантов.
close_tsintЗакроется сам в это время, мс.
closedbool

Button ​

{text, data} или {text, url}. См. кнопки.

Update ​

ПолеТип
idintРастёт на единицу; передавайте id + 1 как offset.
typestringmessage, edited, deleted, reaction, poll, chat, notice, expired, button.
chat_idstring
messageMessagemessage, edited, poll.
chatChatchat.
deleted{message_id, from}deleted.
reaction{message_id, from, emoji}reaction; пустой emoji — убрана.
noticeNoticenotice.
expiredstring[]expired: id стёртых сообщений.
button{message_id, from, data, press_id}button.

from в deleted, reaction и button — User.

Notice ​

{from, code}, где code:

code
expire_timer:<сек>Сменился таймер исчезающих сообщений (0 — выключен).
message_pinned:<превью>Закреплено сообщение.
group_renamed:<имя>
group_photo_changed, group_photo_removed
safety_number_changedСменились ключи собеседника (новое устройство или переустановка).