{
"app_key": "applAnm75tj7hx7Q0iq",
"app_secret": "替换为你的 app_secret",
"path": "/msg/send_group_msg",
"data": {
"guid": "af5cd5cc37ddb475",
"group_list": [10728651244869916, 10976447000310532],
"message_list": [
{ "text": { "content": "你好" } }
]
}
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_key | string | 是 | 应用 key |
| app_secret | string | 是 | 应用密钥 |
| path | string | 是 | 固定 /msg/send_group_msg |
| data | object | 是 | 业务参数,见下表 |
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| guid | string | 是 | 设备 guid |
| user_list | uint64[] | 否 | 好友群发目标 VID 列表 |
| group_list | uint64[] | 否 | 群群发目标 ID 列表 |
| message_list | object[] | 是 | 消息列表,按顺序发送 |
user_list 和 group_list 至少传一个,可同时传。type 字段! 消息类型由字段名区分(oneof 结构),每个元素只包含一个类型字段,值为该类型的参数对象:| 类型字段 | 值对象 | 说明 |
|---|---|---|
| text | TextMessage | 文本 |
| image_url | GroupImageUrlMessage | 图片 URL |
| video | VideoMessage | 视频(CDN) |
| file | FileMessage | 文件(CDN) |
| weapp | WeAppMessage | 小程序 |
| link | LinkMessage | 链接卡片 |
| feed_video | FeedVideoMessage | 视频号 |
| h5_feed_video | H5WechatSphFeedMessage | 视频号 H5 |
proto: syntax error):{ "type": "text", "text": "你好" }{ "text": { "content": "你好" } }{ "text": { "content": "群发文本,可包含 {$@} 标记" } }| 字段 | 类型 | 说明 |
|---|---|---|
| content | string | 文本内容,可含 {$@} 标记 |
| at_list | string[] | 可选,@ 用户列表,"0" 表示 @所有人 |
{ "image_url": { "image_url": "https://example.com/a.jpg", "size": 10240, "thumb_width": 200, "thumb_height": 200 } }file_id / aes_key / md5 等来自 /cdn/c2c_upload 上传接口的响应,先上传再群发:{ "video": { "file_id": "xxx", "size": 123456, "file_name": "a.mp4", "aes_key": "xxx", "md5": "xxx", "duration": 15, "width": 720, "height": 1280 } }{ "file": { "file_id": "xxx", "size": 123456, "file_name": "a.pdf", "aes_key": "xxx", "md5": "xxx" } }{ "weapp": { "username": "gh_xxx", "appid": "wx_xxx", "appname": "小程序名", "appicon": "https://...", "title": "卡片标题", "page_path": "pages/index/index", "file_id": "xxx", "size": 1024, "aes_key": "xxx", "md5": "xxx" } }{ "link": { "title": "标题", "desc": "描述", "url": "https://example.com", "image_url": "https://example.com/cover.jpg" } }{
"error_code": 0,
"error_message": "",
"data": {
"result": {
"msgid": 123456789
}
}
}error_code = 0 表示成功,data.result.msgid 为本次群发任务 ID。| 错误信息 | 原因 |
|---|---|
proto: syntax error ... unexpected token | message_list 格式错(如 text 传了字符串、带了 type 字段) |
Unknown command type | 设备 App 版本过旧,不认识该命令,需升级 App |
Failed to serialize request | 设备端必填参数为空(如 message_list 为空) |
fila: unsupported path | path 写错,服务端无此路径 |
group_list / user_list 的 ID 是 64 位整数(超过 JS 安全整数范围 2^53-1)。用 JavaScript 代码构造请求时必须以字符串形式传(protojson 接受 "10728651244869916" 字符串),否则精度丢失导致目标错误。直接在 Apifox 粘贴 JSON 原文则不受影响。message_list 顺序发送。