机器人事件
读取机器人事件
GET /v1/bots/me/events
GET
/v1/bots/me/events使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token,按十进制游标读取当前仍有权限查看的私信和房间指令事件,每页最多 50 条;断线后可用 next_after 补取。OAuth 应用审核和 bot 权限 grant 均必须有效;令牌主体始终是绑定的 bot user。事件保留 90 天,清理不重置序号;无新事件时 next_after 不小于请求的 after。
Bearer 令牌(bot:events:read)
查询参数
afterstring可选长度 ≤ 19 · 格式:^[0-9]{1,19}$
limitstring可选格式:^(?:[1-9]|[1-4][0-9]|50)$
返回值
Success
eventsobject[]必填条目数 ≤ 50
eventsobject[]必填event_idstring必填seqstring必填长度 ≤ 19 · 格式:^[0-9]{1,19}$
message_idstring必填room_idstring | null必填conversation_idstring | null必填trigger_kindstring必填可选值
"dm""mention""slash"command_idstring | null必填command_revisionnumber | null必填argsstring[]必填
argsstring[]必填[]stringcontentstring必填author_idstring必填created_atstring必填next_afterstring必填长度 ≤ 19 · 格式:^[0-9]{1,19}$
接口信息
接口: GET /v1/bots/me/events
operationId: listBotEvents
所需权限: bot:events:read
使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token,按十进制游标读取当前仍有权限查看的私信和房间指令事件,每页最多 50 条;断线后可用 next_after 补取。OAuth 应用审核和 bot 权限 grant 均必须有效;令牌主体始终是绑定的 bot user。事件保留 90 天,清理不重置序号;无新事件时 next_after 不小于请求的 after。
参数:
queryafterquerylimit