机器人事件

机器人令牌读取事件并幂等回复;实时变更提示通过独立 WebSocket 连接。

机器人令牌读取事件并幂等回复;实时变更提示通过独立 WebSocket 连接。

首次接入请阅读机器人事件接入指南,查看事件字段、消费与回复示例和断线恢复方式。

选择接口查看参数、响应、代码示例并手动发送请求。也可以通过站点搜索查找接口名称、路径或参数。

方法接口路径
GET读取机器人事件/v1/bots/me/events
POST回复机器人事件/v1/bots/me/replies

WebSocket 事件变更提示

握手路径: GET /v1/bots/me/events/stream

握手认证: Bot PAT or OAuth access token in Authorization Bearer header only; OAuth tokens must come from a reviewed bot application with an active bot permission grant and are always bound to the bot user; no Cookie or query token

连接只发送事件变化提示,不包含事件正文。连接后、重连后及运行期间,仍应通过 HTTP 事件接口按已保存的游标补取。

服务端通知示例:

{
  "event": "bot_events_changed"
}
连接限制当前值
每个令牌最多连接数2
单实例最多连接数64
单条连接最长持续时间1800 秒

完整契约:bots.json。