极速群发

POST

/msg/send_group_msg

此接口等同于工作台-群发助手，一个客户一天只能收到一次，发送无需员工手动确认

需要传入 user_list 或 room_list ，两者仅能传一个并且最多200条，多的需要分批处理

请求参数

Body 参数application/json

示例

{
  "guid": "087c16d6-050e-3eda-8e04-68de09780291",
  "user_list": [
    "7881301xxxxxxx"
  ],
  "room_list": [
    "10779xxxxxxxx"
  ],
  "content": "你好",
  "image_msg_list": [
    {
      "image_url": "https://wework.qpic.cn/wwpic/816939_13XbcgvqQimlLzs_1688522339/0",
      "size": 10000,
      "thumb_width": 300,
      "thumb_height": 240
    }
  ],
  "video_msg_list": [
    {
      "file_id": "",
      "size": 0,
      "file_name": "",
      "aes_key": "",
      "md5": "",
      "video_duration": 15,
      "video_width": 300,
      "video_height": 240
    }
  ],
  "weapp_msg_list": [
    {
      "username": "",
      "appid": "",
      "appname": "",
      "appicon": "",
      "title": "",
      "page_path": "",
      "file_id": "",
      "size": 0,
      "aes_key": "",
      "md5": ""
    }
  ],
  "link_msg_list": [
    {
      "title": "",
      "description": "",
      "url": "",
      "image_url": ""
    }
  ],
  "file_msg_list": [
    {
       "file_id": "",
       "size": 1024,
       "file_name": "xxxx",
       "aes_key": "",
       "md5": ""
   }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/msg/send_group_msg' \
--header 'Content-Type: application/json' \
--data '{
  "guid": "087c16d6-050e-3eda-8e04-68de09780291",
  "user_list": [
    "7881301xxxxxxx"
  ],
  "room_list": [
    "10779xxxxxxxx"
  ],
  "content": "你好",
  "image_msg_list": [
    {
      "image_url": "https://wework.qpic.cn/wwpic/816939_13XbcgvqQimlLzs_1688522339/0",
      "size": 10000,
      "thumb_width": 300,
      "thumb_height": 240
    }
  ],
  "video_msg_list": [
    {
      "file_id": "",
      "size": 0,
      "file_name": "",
      "aes_key": "",
      "md5": "",
      "video_duration": 15,
      "video_width": 300,
      "video_height": 240
    }
  ],
  "weapp_msg_list": [
    {
      "username": "",
      "appid": "",
      "appname": "",
      "appicon": "",
      "title": "",
      "page_path": "",
      "file_id": "",
      "size": 0,
      "aes_key": "",
      "md5": ""
    }
  ],
  "link_msg_list": [
    {
      "title": "",
      "description": "",
      "url": "",
      "image_url": ""
    }
  ],
  "file_msg_list": [
    {
       "file_id": "",
       "size": 1024,
       "file_name": "xxxx",
       "aes_key": "",
       "md5": ""
   }
  ]
}'

返回响应

🟢200Successful Response

application/json

Bodyapplication/json

示例

"string"

🟠422Validation Error

修改于 2026-09-07 11:11:02

发送H5视频号

查询群发确认的消息的状态