ChatMember

Объект включает общую информацию о пользователе или боте, URL аватара и описание (при наличии). Является наследником схемы UserWithPhoto. Дополнительно к ней содержит данные для пользователей-участников чата или канала. Возвращается только при вызове некоторых методов группы /chats, например GET /chats/{chatId}/members

user_id
integer <int64>

Идентификатор пользователя или бота

first_name
string

Отображаемое имя пользователя или бота

last_name
string Nullable optional

Отображаемая фамилия пользователя. Для ботов это поле не возвращается

username
string Nullable

Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть null, если тот недоступен или имя не задано

is_bot
boolean

true, если это бот

last_activity_time
integer <int64>

Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться

name
string Nullable

Устаревшее поле, скоро будет удалено

description
string Nullable optional

до 16000 символов

Описание пользователя или бота. В случае с пользователем может принимать значение null, если описание не заполнено

avatar_url
string optional

URL аватара пользователя или бота в уменьшенном размере

full_avatar_url
string optional

URL аватара пользователя или бота в полном размере

last_access_time
integer <int64>

Время последней активности пользователя в чате. Может быть устаревшим для суперчатов (равно времени вступления)

is_owner
boolean

Является ли пользователь владельцем группового чата или канала

is_admin
boolean

Является ли пользователь администратором группового чата или канала

join_time
integer <int64>

Дата присоединения к чату в формате Unix timestamp в миллисекундах

permissions
ChatAdminPermission[] Nullable

Возможные значения в enum: "read_all_messages" "add_remove_members" "add_admins" "change_chat_info" "pin_message" "write" "can_call" "edit_link" "post_edit_delete_message" "edit_message" "delete_message" "edit" "delete"

Перечень прав доступа пользователя или бота, если тот является администратором группового чата или канала. Для обычных участников чата или канала поле не возвращается

Ниже приведено краткое описание всех прав — подробнее читайте в разделе «Доступные права администратора»

Краткое описание доступных прав администратора:

read_all_messages — читать все сообщения в канале или групповом чате
edit — редактировать посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместо edit в API использовалось edit_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используется edit
delete — удалять посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместо delete в API использовалось delete_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используется delete
write — редактировать и удалять сообщения в групповых чатах, а также писать посты и комментарии в каналах. Ранее вместо write в API использовалось post_edit_delete_message — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используется write
pin_message — закреплять сообщение
change_chat_info — изменять информацию о канале или групповом чате
add_remove_members — добавлять и удалять участников группового чата (доступно пользователям и ботам) или подписчиков канала (доступно только пользователям)
add_admins — добавлять и удалять администраторов группового чата или канала
edit_link — изменять ссылку на групповой чат (для каналов недоступно)
can_call — звонить в групповом чате (для каналов недоступно)
view_stats — право на просмотр статистики каналов (для групповых чатов недоступно). Назначается по умолчанию владельцам каналов. Для других пользователей-администраторов канала и ботов недоступно

alias
string optional

Описание роли, которое будет отображаться на клиентском устройстве в настройках чата или канала рядом с именем пользователя

Если пользователь администратор или владелец и ему не установлено это название, то поле не передаётся, клиентское устройство на своей стороне подменит значение на соответствующее: "владелец" или "админ"

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

JSON

Скопировать

{
    "user_id": 0,
    "first_name": "string",
    "last_name": "string",
    "username": "string",
    "is_bot": true,
    "last_activity_time": 0,
    "name": "string",
    "description": "string",
    "avatar_url": "string",
    "full_avatar_url": "string",
    "last_access_time": 0,
    "is_owner": true,
    "is_admin": true,
    "join_time": 0,
    "permissions": [array],
    "alias": "string"
}