You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

关于Telegram Bot添加至群组/超级群组的更新格式技术问询

解析Telegram Bot被加入超级群组时的更新数据结构

刚看到你分享的Bot被加入超级群组时收到的更新 payload,我来帮你拆解下这个数据的关键部分:

首先是完整的更新数据(你提供的内容):

{"update_id":366723634, "message":{"message_id":33,"from":{"id":***,"is_bot":false,"first_name":"name","username":"name","language_code":"en-US"},"chat":{"id":***,"title":"Bot Test","type":"supergroup"},"date":1523443381,"new_chat_participant":{"id":***,"is_bot":true,"first_name":"Bot Name","username":"username"},"new_chat_member":{"id":***,"is_bot":true,"first_name":"Bot Name","username":"username"},"new_chat_membe...}

接下来逐个解释核心字段:

  • update_id: 每一条Telegram更新的唯一标识符,主要用来避免重复处理相同的更新,你可以在处理完更新后记录这个ID,后续只处理ID更大的更新。
  • message: 这是本次更新的主体,包含了添加Bot操作的所有上下文信息:
    • message_id: 当前群组内这条“添加成员”消息的唯一ID,和全局的update_id不是一回事。
    • from: 执行“添加Bot到群组”操作的用户信息,is_bot: false说明这是一个真人用户,字段里还包含了用户的昵称、用户名和使用的语言代码。
    • chat: 目标超级群组的信息,type: supergroup明确了这是超级群组类型,id是群组的唯一标识(后续Bot操作这个群组时需要用到这个ID),title是群组的名称。
    • date: 这条更新发生的Unix时间戳,转换后对应的是2018年4月11日左右,你可以用这个时间来记录Bot被加入的时间点。
    • new_chat_participant/new_chat_member: 这两个字段指向的都是被加入群组的Bot本身,is_bot: true确认了这是一个Bot账户。需要注意的是,Telegram API在不同版本中用了不同的字段名,早期用new_chat_participant,后来统一为new_chat_member,所以你在处理的时候最好两个字段都做兼容判断。

如果你的Bot需要在被加入群组时执行特定逻辑(比如发送欢迎语、初始化群组配置),就可以监听这种包含new_chat_member且成员是Bot自身的更新,触发对应的处理逻辑。

内容的提问来源于stack exchange,提问作者MOHW

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.22 09:40:31