Telegram Bot 使用文档 (2)

该对象表示telegram的一个用户或者机器人

Field Type Description
id   Integer   该用户或机器人的唯一标识  
is_bot   Boolean   标识该用户是否是机器人,True如果是机器人  
first_name   String   用户或者机器人的first_name  
last_name   String   可选。用户或者机器人的last_name  
username   String   可选。用户或者机器人的username  
language_code   String   可选。用户语言的IETF语言标签  
can_join_groups   Boolean   可选。返回True如果该机器人可以被邀请加入群组,只在getMe方法返回  
can_read_all_group_message   Boolean   可选。返回True如果该机器人禁用了隐私模式,只在getMe方法返回  
supports_inline_queries   Boolean   可选。返回True,如果这个自持内联查询,只在getMe方法返回  
Chat

该对象表示一个聊天信息

Field Type Description
id   Integer   该聊天的唯一标识符。 这个数字可能会大于32位但是一定小于52位所以编程时因指定int64类型  
type   String   聊天的类型,可以是 “private”, “group”, “supergroup” 或者 “channel”  
title   String   可选。 标题, 针对 supergroups, channels 和 group 类型的聊天  
username   String   可选。 Username, 针对 私有的聊天,如果可以的话也针对 supergroups 和 channels  
first_name   String   可选。 私人聊天中对方的first_name  
last_name   String   可选。私人聊天中对方的last_name  
photo     可选。 聊天照片,只在getChat方法返回  
description   String   可选。 描述, 针对 groups, supergroups 和 channel 的聊天。只在getChat方法返回  
invite_link   String   可选。聊天的邀请链接, 针对 groups, supergroups 和 channel 的聊天。聊天中的每个管理员都会生成自己的邀请链接,因此机器人必须首先使用exportChatInviteLink生成链接。仅在getChat中返回。  
pinned_message     可选。固定信息,针对 groups, supergroups 和 channels。只在getChat方法中返回  
permissions     可选。默认的聊天成员权限, 针对 groups 和 supergroups。只在getChat方法中返回  
slow_mode_delay   Integer   可选。针对 supergroups, 每个非特权用户发送的连续消息之间允许的最小延迟。仅在getChat中返回。  
sticker_set_name   String   可选。针对 supergroups, 组贴纸集的名称。仅在getChat中返回。  
can_set_sticker_set   Boolean   可选。 返回True如果机器人可以改变group的贴纸集,只在getChat方法中返回。  
Message

该对象代表一个消息

Field Type Description
message_id   Integer   此聊天中的唯一消息标识符  
from     可选的。发件人,对于发送到channels的消息为空  
date   Integer   发送时间(Unix时间)  
chat     消息所属的会话  
forward_from     可选的。对于转发的消息,原始消息的发件人  
forward_from_chat     可选的。对于从频道转发的消息,有关原始频道的信息  
forward_from_message_id   Integer   可选的。对于从频道转发的消息,是频道中原始消息的标识符  
forward_signature   String   可选的。对于从频道转发的消息,作者的签名(如果有)  
forward_sender_name   String   可选的。从用户转发的信息的发件人名称,这些用户不允许在转发的信息中添加指向其帐户的链接  
forward_date   Integer   可选的。对于转发的消息,原始消息的发送日期(Unix时间)  
reply_to_message     可选的。对于答复,原始消息。请注意,即使此字段本身是答复,该字段中的Message对象也不会包含其他的reply_to_message字段。  
via_bot     可选的。发送消息的机器人  
edit_date   Integer   可选的。消息最后一次编辑的日期(Unix时间)  
media_group_id   String   可选的。该消息所属的媒体消息组的唯一标识符  
author_signature   String   可选的。在频道中信息的作者签名  
text   String   可选的。对于文本消息,消息的实际UTF-8文本,0-4096个字符  
entities   Array of   可选的。对于文本消息,出现在文本中的特殊实体,例如用户名,URL,机器人命令等。  
animation     可选的。消息是动画,有关动画的信息。为了向后兼容,设置此字段时,还将设置文档字段  
audio     可选的。消息是音频文件,有关该文件的信息  
document     可选的。消息是常规文件,有关文件的信息  
photo   Array of   可选的。消息是照片,照片的可用尺寸  
sticker     可选的。消息是贴纸,有关贴纸的信息  
video     可选的。消息是视频,有关视频的信息  
video_note     可选的。消息是视频注释,有关视频消息的信息  
voice     可选的。消息是语音消息,有关文件的信息  
caption   String   可选的。动画,音频,文档,照片,视频或语音的标题,0-1024个字符  
caption_entities   Array of   可选的。对于带有标题的消息,出现在标题中的特殊实体,例如用户名,URL,漫机器人命令等  
contact     可选的。消息是共享的联系人,有关该联系人的信息  
dice     可选的。消息是一个骰子,具有从1到6的随机值  
game     可选的。消息是一个游戏,有关游戏的信息。  
poll     可选的。消息是原生投票,有关投票的信息  
venue     可选的。消息是一个场地,有关该场地的信息。为了向后兼容,设置此字段时,还将设置位置字段  
location     可选的。消息是共享位置,有关位置的信息  
new_chat_members   Array of   可选的。添加到组或超组中的新成员以及有关它们的信息(机器人本身可能是这些成员之一)  
left_chat_member     可选的。成员已从群组中删除,有关他们的信息(该成员可能是机器人本身)  
new_chat_title   String   可选的。聊天标题已更改为此值  
new_chat_photo   Array of   可选的。聊天照片已更改为此值  
delete_chat_photo   True   可选的。服务消息:聊天照片已删除  
group_chat_created   True   可选的。服务信息:组已创建  
supergroup_chat_created   True   可选的。 服务消息:超组已创建。 在通过更新发送的消息中无法接收到该字段,因为bot在创建时不能成为超组的成员。 仅当有人回复直接创建的超组中的第一条消息时,才可以在reply_to_message中找到该消息。  
channel_chat_created   True   可选的。 服务信息:频道已创建。 在通过更新发送的消息中无法接收到该字段,因为bot在创建时不能成为频道的成员。 如果有人回复频道中的第一条消息,则只能在reply_to_message中找到它。  
migrate_to_chat_id   Integer   可选的。 该组已迁移到具有指定标识符的超组。 此数字可能大于32位,并且某些编程语言在解释它时可能会有困难/无声的缺陷。 但是它小于52位,因此带符号的64位整数或双精度浮点类型对于存储此标识符是安全的。  
migrate_from_chat_id   Integer   可选的。 超级组已从具有指定标识的组中迁移。 此数字可能大于32位,并且某些编程语言在解释它时可能会有困难/无声的缺陷。 但是它小于52位,因此带符号的64位整数或双精度浮点类型对于存储此标识符是安全的。  
pinned_message     可选的。 指定的消息已固定。 请注意,即使该字段本身是答复,该字段中的Message对象也不会包含其他的reply_to_message字段。  
invoice     可选的。 消息是付款的发票,有关发票的信息。  
successful_payment     可选的。 消息是有关成功付款的服务消息,有关付款的信息。  
connected_website   String   可选的。 用户登录的网站的域名。  
passport_data     可选的。 电报护照数据  
reply_markup     可选的。 消息附带的嵌入式键盘。 login_url按钮表示为普通url按钮。  
MessageEntity

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

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