Telegram Bot 使用文档 (5)

该对象表示带有回复选项的自定义键盘

Field Type Description
keyboard   Array of Array of   按钮行数组,每个行由一个KeyboardButton对象数组表示  
resize_keyboard   Boolean   可选的。请求客户垂直调整键盘大小以达到最佳适合度(例如,如果只有两行按钮,则使键盘变小)。默认为false,在这种情况下,自定义键盘的高度始终与应用程序的标准键盘相同。  
one_time_keyboard   Boolean   可选的。要求客户在使用键盘后立即隐藏它。键盘仍然可用,但是客户端将在聊天中自动显示常用的字母键盘-用户可以在输入字段中按特殊按钮以再次查看自定义键盘。默认为false。  
selective   Boolean   可选的。如果只想向特定用户显示键盘,请使用此参数。目标:1)在Message对象的文本中@提及的用户; 2)如果机器人的消息是回复(具有reply_to_message_id),则为原始消息的发送者。
示例:用户请求更改机器人的语言,机器人用键盘答复选择新语言的请求。群组中的其他用户看不到键盘。
 
KeyboardButton

该对象表示回复键盘的一个按钮。对于简单的文本按钮,可以使用String代替此对象来指定按钮的文本。可选字段request_contact,request_location和request_poll是互斥的。

Field Type Description
text   String   按钮的文字。如果未使用任何可选字段,则在按下按钮时它将作为消息发送  
request_contact   Boolean   可选的。如果为True,则按下该按钮时,用户的电话号码将作为联系人发送。仅在私人聊天中可用  
request_location   Boolean   可选的。如果为True,则在按下按钮时将发送用户的当前位置。仅在私人聊天中可用  
request_poll     可选的。如果指定,则将要求用户创建一个民意调查,并在按下按钮时将其发送给机器人。仅在私人聊天中可用  

注意:request_contact和request_location选项仅适用于2016年4月9日之后发布的电报版本。较旧的客户端将显示不受支持的消息。

注意:request_poll选项仅在2020年1月23日之后发布的电报版本中有效。旧客户端将显示不支持的消息。

KeyboardButtonPollType

该对象表示民意调查的类型,可以在按下相应按钮时创建并发送该民意调查

Field Type Description
type   String   可选的。如果通过了测验,将仅允许用户以测验模式创建民意测验。如果通过常规,则仅允许常规民意调查。否则,将允许用户创建任何类型的民意测验。  
ReplyKeyboardRemove

收到带有此对象的消息后,Telegram客户端将删除当前的自定义键盘并显示默认的字母键盘。默认情况下,将显示自定义键盘,直到机器人发送新键盘为止。一次性键盘的例外情况是用户按下按钮后立即隐藏的一次性键盘

Field Type Description
remove_keyboard   True   请求客户端删除自定义键盘(用户将无法召唤此键盘;如果要隐藏键盘,但保持其可访问性,请在ReplyKeyboardMarkup中使用one_time_keyboard)  
selective   Boolean   可选的。如果仅要为特定用户卸下键盘,请使用此参数。目标:1)在Message对象的文本中@提及的用户; 2)如果漫游器的消息是回复(具有reply_to_message_id),则为原始消息的发送者。 示例:用户在投票中投票,机器人返回确认消息以回应投票,并删除该用户的键盘,同时仍向尚未投票的用户显示带有投票选项的键盘。  
InlineKeyboardMarkup

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zzsszz.html