Типы событий

message.created

Возникает для сообщения в личном чате, обращения @botname в группе или реплая на сообщение бота. data содержит chat_id, chat_type, session_id, message и ограниченный actor.

button.clicked

Возникает для callback-кнопки. В группе actor описывает только нажавшего пользователя; результат можно адресовать только ему. Повторные нажатия допустимы, если single_use не включён.

Системные события

Установка, перезапуск, удаление и изменение доступности могут передаваться отдельными системными событиями. Не используйте display_name или username как стабильный идентификатор — сохраняйте UUID.

Практика с SDK

Маршрутизируйте события по полю type и оставляйте безопасный обработчик для неизвестных типов. Это позволит платформе добавлять совместимые события без поломки бота.

В button.clicked доверяйте actor только в пределах текущего бота; не связывайте bot-scoped actor id с глобальным аккаунтом без собственного подтверждения.

const handlers = {
  'message.created': async event => {
    const { chat_id, session_id, message, actor } = event.data;
    console.log(event.id, chat_id, session_id, message.text, actor.id);
    return {};
  }
};