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-время в миллисекундах). Если пользователь отключил в настройках профиля мессенджера 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 time

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"
}