该对象表示一个嵌入式键盘,出现在其所属消息的旁边。
Field Type Descriptioninline_keyboard Array of Array of 按钮行数组,每个行由一个InlineKeyboardButton对象数组表示
注意:这仅适用于2016年4月9日之后发布的电报版本。较旧的客户端将显示不受支持的消息。
InlineKeyboardButton此对象表示嵌入式键盘的一个按钮。您必须完全使用可选字段之一。
Field Type Descriptiontext String 在按钮上标记文本
url String 可选的。按下按钮时将打开HTTP或tg:// URL
login_url 可选的。用于自动授权用户的HTTP URL。可以替代电报登录小部件。
callback_data String 可选的。按下按钮时要在回调查询中发送到bot的数据,1-64个字节
switch_inline_query String 可选的。如果已设置,则按下按钮将提示用户选择其聊天之一,打开该聊天并将bot的用户名和指定的内联查询插入输入字段。可以为空,在这种情况下,只会插入机器人的用户名。
注意:这为用户提供了一种简便的方法,使他们在当前与它进行私聊时以内联模式开始使用您的机器人。与switch_pm…操作结合使用时特别有用–在这种情况下,用户将自动返回到其切换到的聊天中,而跳过聊天选择屏幕。
switch_inline_query_current_chat String 可选的。如果已设置,则按下按钮会将bot的用户名和指定的嵌入式查询插入当前聊天的输入字段中。可以为空,在这种情况下,只会插入机器人的用户名。
callback_game 可选的。用户按下按钮时将启动的游戏的描述。
注意:此类型的按钮必须始终是第一行中的第一个按钮。
pay Boolean 可选的。指定True,发送付款按钮。
注意:此类型的按钮必须始终是第一行中的第一个按钮。
ForceReply
收到带有该对象的消息后,Telegram客户端将向用户显示一个答复界面(就像用户选择了机器人的消息并点按“答复”一样)。如果您要创建用户友好的逐步界面而不必牺牲隐私模式,这将非常有用。
Field Type Descriptionforce_reply True 向用户显示回复界面,就像他们手动选择了机器人的消息并点按“回复”一样
selective Boolean 可选的。如果只想强制特定用户答复,请使用此参数。目标:1)在Message对象的文本中@提及的用户; 2)如果漫游器的消息是回复(具有reply_to_message_id),则为原始消息的发送者。
telegram方法
telegram方法就是拼接在api后面的那串字符串,不区分大小写。,这里只列举一些常用的,下面我所指的返回是指返回json中的result部分,其他章节提到的所有方法均可以在这一章节查阅
getUpdates
描述
获取更新,还有另外一种获取更新的方法(webhook),两种方式不能共存
参数
无参数
返回
update对象列表
setWebhook
描述
使用此方法可以指定URL并通过传出的Webhook接收传入的更新。只要机器人有更新,telegram就会向指定的URL发送HTTPS POST请求,请求数据为json序列化后的update对象
参数
Parameter Type Required Descriptionurl String Yes 发送更新的https url。使用空字符串删除webhook集成
certificate Optional 上传您的公共密钥证书,以便可以检查正在使用的根证书。有关详细信息,请参见我们的自签名指南。
max_connections Integer Optional 与Webhook进行更新交付的同时HTTPS连接的最大允许数量为1-100。默认值为40。使用较低的值可以限制bot服务器的负载,使用较高的值可以增加bot的吞吐量。
allowed_updates Array of String Optional 您希望机器人接收的更新类型的JSON序列化列表。 例如,指定[“ message”,“ edited_channel_post”,“ callback_query”]仅接收这些类型的更新。 请参阅更新以获取可用更新类型的完整列表。 指定一个空列表以接收所有更新,无论类型如何(默认)。 如果未指定,将使用以前的设置。
请注意,此参数不会影响调用setWebhook之前创建的更新,因此可能会在短时间内收到不需要的更新。
返回
成功返回True
deleteWebhook
描述
删除设置的webhook
参数
无参数
返回
成功返回True
getWebhookInfo
描述
获取当前webhook的状态
参数
无参数
返回
WebhookInfo对象
(如果没有设置webhook,则返回的对象中url为空)
getMe
描述
获取机器人自身信息
参数
无参数
返回
user对象
getChat
描述
使用此方法可获取有关聊天的最新信息(一对一对话的用户的当前名称,用户的当前用户名,组或频道等)