Описание
Этот объект определяет критерии, используемые для запроса подходящего чата. Информация о выбранном чате будет передана боту при нажатии соответствующей кнопки. Боту будут предоставлены запрошенные права в чате, если это уместно. Подробнее о запросе чатов ».
| Поле | Тип | Описание |
|---|---|---|
| request_id | Integer | Подписанный 32-битный идентификатор запроса, который будет получен обратно в объекте ChatShared. Должен быть уникальным в пределах сообщения |
| chat_is_channel | Boolean | Передайте True для запроса чата-канала, передайте False для запроса группового чата или супергруппы. |
| chat_is_forum | Boolean | Необязательный. Передайте True для запроса супергруппы-форума, передайте False для запроса чата без форума. Если не указано, дополнительные ограничения не применяются. |
| chat_has_username | Boolean | Необязательный. Передайте True для запроса супергруппы или канала с именем пользователя, передайте False для запроса чата без имени пользователя. Если не указано, дополнительные ограничения не применяются. |
| chat_is_created | Boolean | Необязательный. Передайте True для запроса чата, принадлежащего пользователю. В противном случае дополнительные ограничения не применяются. |
| user_administrator_rights | ChatAdministratorRights | Необязательный. JSON-сериализованный объект, перечисляющий требуемые права администратора пользователя в чате. Права должны быть надмножеством bot_administrator_rights. Если не указано, дополнительные ограничения не применяются. |
| bot_administrator_rights | ChatAdministratorRights | Необязательный. JSON-сериализованный объект, перечисляющий требуемые права администратора бота в чате. Права должны быть подмножеством user_administrator_rights. Если не указано, дополнительные ограничения не применяются. |
| bot_is_member | Boolean | Необязательный. Передайте True для запроса чата, в котором бот является участником. В противном случае дополнительные ограничения не применяются. |
| request_title | Boolean | Необязательный. Передайте True для запроса названия чата |
| request_username | Boolean | Необязательный. Передайте True для запроса имени пользователя чата |
| request_photo | Boolean | Необязательный. Передайте True для запроса фотографии чата |
Примеры
json
{
"request_id": 123456789,
"chat_is_channel": true,
"chat_is_forum": false,
"chat_has_username": true,
"chat_is_created": false,
"user_administrator_rights": {
"is_anonymous": false,
"can_manage_chat": true,
"can_delete_messages": true,
"can_manage_video_chats": true,
"can_restrict_members": true,
"can_promote_members": false,
"can_change_info": true,
"can_invite_users": true,
"can_post_stories": false,
"can_edit_stories": false,
"can_delete_stories": false,
"can_post_messages": true,
"can_edit_messages": true,
"can_pin_messages": true,
"can_manage_topics": false
},
"bot_administrator_rights": {
"is_anonymous": false,
"can_manage_chat": true,
"can_delete_messages": true,
"can_manage_video_chats": false,
"can_restrict_members": false,
"can_promote_members": false,
"can_change_info": false,
"can_invite_users": true,
"can_post_stories": false,
"can_edit_stories": false,
"can_delete_stories": false,
"can_post_messages": true,
"can_edit_messages": false,
"can_pin_messages": false,
"can_manage_topics": false
},
"bot_is_member": true,
"request_title": true,
"request_username": true,
"request_photo": false
}История изменений
- API 6.5. Добавлен объект KeyboardButtonRequestChat
- API 7.2. Обновлен объект KeyboardButtonRequestChat: Добавлены поля request_title, request_username, request_photo
Дополнительно
- ChatShared - Объект содержит информацию о чате, предоставленном боту через специальную кнопку клавиатуры.
- ChatAdministratorRights - Объект, описывающий права администратора в чате Telegram, включая управление сообщениями, пользователями, настройками и другими функциями.