Skip to main content
Объект groupMember описывает связь пользователя с конкретной группой: статус участия, блокировки и метаданные по интеграции с Telegram. Этот объект возвращается, например, в методе group/{groupId}/member/create-many и других эндпоинтах работы с участниками групп.

​
Поля участника группы (структурно)

​
Основные поля

​
id
integer
required
Уникальный идентификатор участника группы.
​
group
Group
required
Объект группы, к которой относится участник (может возвращаться как объект или как ссылка по ID).
​
user
User
required
Объект пользователя, который является участником группы.
​
inviter
User | null
Пользователь, который пригласил участника в группу (если применимо).
​
active
boolean
required
Активен ли участник в группе: true — активен, false — деактивирован в рамках этой группы.
​
blockedUntil
string | null
Дата и время, до которых участник заблокирован в группе. null, если блокировки нет.
​
blockedBy
User | null
Пользователь, который заблокировал участника.
​
deletedBy
User | null
Пользователь, который удалил участника из группы (при мягком удалении).
​
tgChannelMeta
object
required
Метаданные по добавлению участника в Telegram-канал (ссылка-приглашение, статус добавления и т.д.).
​
tgGroupChatMeta
object
required
Метаданные по добавлению участника в Telegram-групповой чат.

​
Вычисляемые поля (структурно)

​
isAddedToTg
boolean
required
Участник успешно добавлен хотя бы в один Telegram-чат/канал (tgChannelMeta.chatInviteLink или tgGroupChatMeta.chatInviteLink).

​
Системные поля аудита (структурно)

​
createdAt
string
required
Дата и время создания записи участника (ISO 8601).
​
updatedAt
string
required
Дата и время последнего обновления.

​
Пример объекта groupMember

{
  "id": 1227,
  "createdAt": "2025-07-19T15:45:51.212Z",
  "updatedAt": "2025-07-19T15:45:51.212Z",
  "group": {
    "id": 101,
    "uuid": "8b8b2b0e-6a27-4c3c-b5a5-9f4f0e3f1c01",
    "name": "Группа 7А — Математика"
  },
  "user": {
    "id": 15,
    "uuid": "YRnh3REH1Wbd",
    "active": true,
    "activated": true,
    "banned": false,
    "email": "[email protected]",
    "phone": "+987654321",
    "language": "Ru",
    "timezone": 5,
    "lastOnlineAt": "2025-07-20T19:14:03.972Z",
    "starsBalance": 0
  },
  "inviter": null,
  "active": true,
  "blockedUntil": null,
  "blockedBy": null,
  "deletedBy": null,
  "tgChannelMeta": {
    "chatInviteLink": null,
    "joined": false
  },
  "tgGroupChatMeta": {
    "chatInviteLink": null,
    "joined": false
  },
  "isAddedToTg": false
}

​
Связанные объекты

  • Поле user — это объект User, описанный на отдельной странице.
  • Поле group — это объект Group.