Telegram Bot 使用文档 (6)

该对象表示一个嵌入式键盘,出现在其所属消息的旁边。

Field Type Description
inline_keyboard   Array of Array of   按钮行数组,每个行由一个InlineKeyboardButton对象数组表示  

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

InlineKeyboardButton

此对象表示嵌入式键盘的一个按钮。您必须完全使用可选字段之一。

Field Type Description
text   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 Description
force_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 Description
url   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

描述

使用此方法可获取有关聊天的最新信息(一对一对话的用户的当前名称,用户的当前用户名,组或频道等)

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

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