本文档描述了机器人各类事件回调消息的格式和字段说明。
511、512、513、515 查询指令。通过 SaaS 发送指令接口 下发:robotId 为必填参数。请求体见各查询章节的“指令下发示例”。接口响应表示指令提交结果,查询数据由客户端另行 POST 到机器人配置的消息回调地址,不在本次 HTTP 响应中返回。| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 固定值 512 |
| groupName | string | 是 | 目标群聊名称或群备注名 |
{
"socketType": 2,
"list": [
{
"type": 512,
"groupName": "技术交流群-南京"
}
]
}groupName 和 groupRemark 分别表示查询到的群名与群备注。{
"type": 512,
"groupName": "技术交流群",
"groupRemark": "技术交流群-南京",
"groupOwner": "张三",
"groupAnnouncement": "欢迎加入技术交流群",
"memberList": ["张三", "李四", "王五", "赵六"],
"memberCount": 4
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 消息类型,固定值 512 |
| groupName | string | 是 | 群名称 |
| groupRemark | string | 是 | 群备注名称 |
| groupOwner | string | 是 | 群主名称,未获取到时为空字符串 |
| groupAnnouncement | string | 是 | 群公告,未获取到时为空字符串 |
| memberList | string[] | 是 | 群成员名称列表 |
| memberCount | integer | 是 | 返回的成员列表数量 |
{
"code": 200,
"message": "success"
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 固定值 511 |
| objectName | string | 是 | 会议日期,格式 yyyy-MM-dd;填写今天或未来 28 天内日期 |
{
"socketType": 2,
"list": [
{
"type": 511,
"objectName": "2026-10-16"
}
]
}{
"type": 511,
"messageId": "msg_123456789",
"date": "2026-10-16",
"meetingInfoList": [
{
"meetingName": "产品需求评审会议",
"meetingTime": "2026-10-16 14:00:00",
"actualMeetingTime": "2026-10-16 14:05:00",
"orgName": "张三"
},
{
"meetingName": "技术周会",
"meetingTime": "2026-10-16 10:00:00",
"actualMeetingTime": "2026-10-16 10:00:00",
"orgName": "李四"
}
]
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 消息类型,固定值 511 |
| messageId | string | 是 | 消息唯一标识符 |
| date | string | 是 | 日期,格式 yyyy-MM-dd |
| meetingInfoList | object[] | 是 | 会议信息列表 |
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| meetingName | string | 是 | 会议名称 |
| meetingTime | string | 是 | 会议时间,按企微页面文本返回 |
| actualMeetingTime | string | 是 | 参会时间,按企微页面文本返回 |
| orgName | string | 是 | 会议组织人名称 |
{
"code": 200,
"message": "success"
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 固定值 513 |
{
"socketType": 2,
"list": [
{
"type": 513
}
]
}{
"type" : 513,
"data" : {
"totalMemory" : 15190,
"availableMemory" : 4674,
"usedMemory" : 10516,
"appMaxMemory" : 512,
"appAllocatedMemory" : 64,
"totalInternalStorage" : 476532,
"availableInternalStorage" : 164509,
"totalExternalStorage" : 476532,
"availableExternalStorage" : 164509,
"deviceModel" : "2407FRK8EC",
"androidVersion" : "16",
"sdkVersion" : 36,
"memoryUsagePercent" : 69.22976
}
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 消息类型,固定值 513 |
| data | object | 是 | 设备资源信息对象 |
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| totalMemory | long | 是 | 设备总内存 (MB) |
| availableMemory | long | 是 | 可用内存 (MB) |
| usedMemory | long | 是 | 已使用内存 (MB) |
| appMaxMemory | long | 是 | 应用最大内存 (MB) |
| appAllocatedMemory | long | 是 | 应用已分配内存 (MB) |
| totalInternalStorage | long | 是 | 内部存储总容量 (MB) |
| availableInternalStorage | long | 是 | 内部存储可用容量 (MB) |
| totalExternalStorage | long | 否 | 外部存储总容量 (MB) |
| availableExternalStorage | long | 否 | 外部存储可用容量 (MB) |
| deviceModel | string | 是 | 设备型号 |
| androidVersion | string | 是 | Android 版本 |
| sdkVersion | integer | 是 | SDK 版本号 |
| memoryUsagePercent | float | 是 | 内存使用率 (%) |
{
"code": 200,
"message": "success"
}{
"spoken": "",
"rawSpoken": "",
"receivedName": "张三",
"groupName": "技术交流群",
"groupRemark": "技术交流群-深圳",
"roomType": 1,
"atMe": "false",
"textType": 2,
"fileBase64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAn/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAX/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCwAB//2Q=="
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| spoken | string | 是 | 解析后的文本内容,图片消息为空字符串 |
| rawSpoken | string | 是 | 原始文本内容,图片消息为空字符串 |
| receivedName | string | 是 | 图片发送者名称 |
| groupName | string | 是 | 群名称 |
| groupRemark | string | 是 | 群备注名称 |
| roomType | integer | 是 | 群聊类型 |
| atMe | string | 是 | 是否@机器人,"true" 或 "false" |
| textType | integer | 是 | 消息类型,固定值 2 表示图片 |
| fileBase64 | string | 是 | 图片的 Base64 编码数据 |
{
"code": 200,
"message": "success"
}{
"type": 101,
"groupName": "技术交流群",
"groupRemark": "技术交流群-深圳",
"roomType": 1,
"memberList": ["张三", "李四", "王五"]
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 固定值 101 |
| groupName | string | 是 | 群名称 |
| groupRemark | string | 是 | 群备注名称 |
| roomType | integer | 是 | 群聊类型 |
| memberList | string[] | 否 | 当前群成员名称列表 |
{
"code": 200,
"message": "success"
}{
"type": 103,
"groupName": "技术交流群",
"groupRemark": "技术交流群-深圳",
"roomType": 1
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| groupName | string | 是 | 群名称 |
| type | integer | 是 | 固定值 103 |
| groupRemark | string | 是 | 群备注名称 |
| roomType | integer | 是 | 群聊类型 |
{
"code": 200,
"message": "success"
}{
"type": 104,
"groupName": "技术交流群",
"groupRemark": "技术交流群-深圳",
"roomType": 1
}| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | integer | 是 | 固定值 104 |
| groupName | string | 是 | 群名称 |
| groupRemark | string | 是 | 群备注名称 |
| roomType | integer | 是 | 群聊类型 |
{
"code": 200,
"message": "success"
}