事件模型
Webhook 事件使用统一信封,业务数据位于 data:
{
"eventId": "evt_01",
"eventType": "im.message.receive_v1",
"occurredAt": "2026-08-05T12:00:00Z",
"appId": "APP_xxx",
"data": {}
}
常见事件类型:
| 事件 | 用途 |
|---|---|
im.message.receive_v1 | 机器人收到单聊或群 Mention 消息 |
customer.message | 客服会话产生新消息 |
customer.session | 客服会话创建、关闭或转交 |
customer.agent | 客服在线状态变化 |
事件处理必须允许字段向后兼容扩展,未知字段不得导致整个事件失败。