Получение информации о членстве бота в групповом чате или канале

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <access_token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном

Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

ID группового чата или канала

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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 — право на просмотр статистики каналов (для групповых чатов недоступно). Назначается по умолчанию владельцам каналов. Для других пользователей-администраторов канала и ботов недоступно

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

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