ChatMember

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

user_id
integer <int64>
Идентификатор пользователя или бота

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

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

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

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

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

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

description
string Nullableoptional

до 16000 символов

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

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

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

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

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

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

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

permissions
ChatAdminPermission[] Nullable

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

Если право назначается действующему администратору, то его текущие права будут обновлены в соответствии с переданным списком. Ниже приведено краткое описание всех прав — подробнее читайте в разделе «Доступные права администратора»

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

  • 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
stringoptional

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

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

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

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