messages.sendBotRequestedPeer

Send one or more chosen peers, as requested by a keyboardButtonRequestPeer button.

updatesTooLong#e317af7e = Updates;
updateShortMessage#313bc7f8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortChatMessage#4d6deea5 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:long chat_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShort#78d4dec1 update:Update date:int = Updates;
updatesCombined#725b04c3 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq_start:int seq:int = Updates;
updates#74ae4240 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq:int = Updates;
updateShortSentMessage#9015e101 flags:# out:flags.1?true id:int pts:int pts_count:int date:int media:flags.9?MessageMedia entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
---functions---
messages.sendBotRequestedPeer#91b2d060 peer:InputPeer msg_id:int button_id:int requested_peers:Vector<InputPeer> = Updates;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
peer InputPeer The bot that sent the keyboardButtonRequestPeer button.
msg_id flags.0?int ID of the message that contained the reply keyboard with the keyboardButtonRequestPeer button.
webapp_req_id flags.1?string If the button was prepared for a Mini App », the Mini App request ID returned by bots.requestWebViewButton.
button_id int The button_id field from the keyboardButtonRequestPeer constructor.
requested_peers Vector<InputPeer> The chosen peers.

Result

Updates

Only users can use this method

Possible errors

Code Type Description
400 MESSAGE_ID_INVALID The provided message id is invalid.
400 PEER_ID_INVALID The provided peer id is invalid.

Related pages

keyboardButtonRequestPeer

Prompts the user to select and share one or more peers with the bot using messages.sendBotRequestedPeer

Available only in private chats, in reply keyboards.

See peer requests for the full flow.

Bot buttons

Users can interact with your bot via buttons or even inline buttons, straight from inline messages in any chat.

bots.requestWebViewButton

Bots may use this method to prepare a peer request button for a Mini App, see here » for more info.