回调事件
Bot 的消息与群聊事件会通过配置的回调地址推送到你的服务端。
回调地址
Bot 的回调事件会发送到配置中设置的 callback_url。
| 项目 | 说明 |
|---|---|
| 请求方式 | POST |
| Content-Type | application/json |
消息事件
事件类型
| 事件类型 | 说明 |
|---|---|
message.add | 新消息 |
message.update | 消息编辑 |
message.delete | 消息撤回/删除 |
回调字段
| 字段 | 类型 | 说明 |
|---|---|---|
event_type | string | 事件类型 |
message_type | int | 事件动作类型 |
chat_type | int | 会话类型（单聊/群聊） |
chat_id | string | 会话 ID |
thread_id | string/uint64 | 线程 ID |
id | string | 消息 ID |
sender_id | string | 发送者 ID |
message_type_id | int | 消息类型 ID |
content | string | 标准化后的消息内容 JSON |
群事件
事件类型
| 事件类型 | 说明 |
|---|---|
group.member.add | 新成员加入群聊 |
group.member.remove | 成员退出/被移出群聊 |
group.update | 群资料更新 |
回调字段
| 字段 | 类型 | 说明 |
|---|---|---|
event_type | string | 事件类型 |
chat_type | int | 会话类型 |
chat_id | string | 会话 ID |
content | object | 原有群事件内容 |
回调触发限制
以下情况下，回调可能不会下发：
- Bot 未配置
callback_url - Bot 已被封禁
- 群维度权限
chat_bot_permission不允许接收当前事件 - 命令/消息未命中对应权限位
命令命中示例
{
"chat_id": "7602566729281049630",
"sender_id": "7569434771739130881",
"command": "/start",
"content": "<p><at userid=\"7569434771739130881\">test bot</at> test webhook</p>"
}