跳到主要内容

事件模型

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客服在线状态变化

事件处理必须允许字段向后兼容扩展,未知字段不得导致整个事件失败。