本文档详细说明机器人回调时传递的数据结构，适用于所有第三方平台集成（如 Coze、Dify 等）。
回调事件类型说明
回调事件类型及其触发条件请参考文档 回调事件类型列表。
回调消息类型说明
objectName 表示回调事件的消息类型。仅支持以下消息类型：
参数结构说明
基础字段
| 参数路径 | 类型 | 说明 |
|---|
type | String | 事件类型 |
timestamp | Number | 事件触发时间（Unix 毫秒） |
bot_userId | String | 机器人用户 ID |
bot_name | String | 机器人名称 |
bot_profileUrl | String | 机器人头像 URL |
bot_type | String | 机器人类型 |
bot_metadata_{key} | String | 机器人自定义元数据，采用 Map key 扁平化方式 |
message:private 类型
| 参数路径 | 类型 | 说明 |
|---|
data_fromUserId | String | 来源用户 ID |
data_toUserId | String | 接收方 ID，通常为机器人自身 ID |
data_objectName | String | 消息类型，例如文本消息 RC:TxtMsg、图片消息 RC:ImgMsg |
data_channelType | String | 会话类型。PERSON（二人会话）、PERSONS（讨论组会话）、GROUP（群组会话）、TEMPGROUP（聊天室会话）、CUSTOMERSERVICE（客服会话）、NOTIFY（系统通知）、MC（应用公众服务）、MP（公众服务）、 ULTRAGROUP（超级群服务） |
data_msgTimestamp | Number | 消息时间戳 |
data_msgUID | String | 消息唯一 ID |
data_extraContent | String | 附加消息内容 |
message:group_mentioned 类型
| 参数路径 | 类型 | 说明 |
|---|
data_fromUserId | String | 来源用户 ID |
data_toUserId | String | 群聊 Id |
data_objectName | String | 消息类型，例如文本消息 RC:TxtMsg、图片消息 RC:ImgMsg |
data_channelType | String | 会话类型。PERSON（二人会话）、PERSONS（讨论组会话）、GROUP（群组会话）、TEMPGROUP（聊天室会话）、CUSTOMERSERVICE（客服会话）、NOTIFY（系统通知）、MC（应用公众服务）、MP（公众服务）、 ULTRAGROUP（超级群服务） |
data_msgTimestamp | Number | 消息时间戳 |
data_msgUID | String | 消息唯一 ID |
data_extraContent | String | 附加消息内容 |
message:private:proxy 类型
| 参数路径 | 类型 | 说明 |
|---|
data_fromUserId | String | 来源用户 ID |
data_toUserId | String | 接收方 ID，被代聊用户 |
data_objectName | String | 消息类型，例如文本消息 RC:TxtMsg、图片消息 RC:ImgMsg |
data_channelType | String | 会话类型。PERSON（二人会话）、PERSONS（讨论组会话）、GROUP（群组会话）、TEMPGROUP（聊天室会话）、CUSTOMERSERVICE（客服会话）、NOTIFY（系统通知）、MC（应用公众服务）、MP（公众服务）、 ULTRAGROUP（超级群服务） |
data_msgTimestamp | Number | 消息时间戳 |
data_msgUID | String | 消息唯一 ID |
data_extraContent | String | 附加消息内容 |
使用说明
以上参数会根据不同的第三方平台集成 方式，以不同的格式传递给对应的平台。具体的参数传递方式和使用方法，请参考各平台的集成文档：