UserJoined
Топик: group-events · Конверт: GroupId, UserId
Происходит, когда пользователь или бот вступает в группу — в том числе когда бот принимает приглашение и появляется в группе впервые.
Payload
Полный текущий снимок группы (та же форма, что и в
«Структура группы») — UserId того, кто
вступил, передаётся отдельным полем конверта, а не внутри payload'а:
| Поле | Описание |
|---|---|
Id | Id группы |
OwnerId | Id владельца группы |
Name | Название группы |
AccessType | Тип доступа к группе |
VerificationLevel | Уровень верификации группы |
CreatedAt | Когда создана группа |
AvatarId / BannerId | Id аватара/баннера группы (или null) |
Categories[].Id / .GroupId / .Name / .Position | Категории группы |
Categories[].Channels[].Id / .CategoryId / .Name / .Type / .Position | Каналы категории (Type: 0 текстовый, 1 голосовой) |
Categories[].Channels[].Users[] | Участники, подключённые к голосовому каналу прямо сейчас |
{
"Type": "UserJoined",
"PayloadJson": "{\"Id\":\"b3b10000-0000-0000-0000-000000000001\",\"OwnerId\":\"a1a10000-0000-0000-0000-000000000001\",\"Name\":\"My Group\",\"AccessType\":1,\"VerificationLevel\":0,\"CreatedAt\":\"2026-01-01T00:00:00Z\",\"AvatarId\":null,\"BannerId\":null,\"Categories\":[]}",
"Timestamp": 1785500200000,
"GroupId": "b3b10000-0000-0000-0000-000000000001",
"UserId": "d4d40000-0000-0000-0000-000000000001"
}
Событие приходит всем уже состоящим в группе клиентам (в том числе другим ботам) — если нужен
профиль вступившего пользователя, запросите его через GetGroupUsers.