Appearance
群发助手-获取待发送列表
拉取「待发送」队列（企微侧已排入、尚未真正下发的群发任务）。
说明与注意
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
appid | 是 | string | 实例 appid，标识操作哪个已登录账号。示例：we_xxxxxxxxxxxxxxx |
请求示例
http
POST {BASE_URL}/wx-api/api/message/getPendingGroupSendList
Authorization: Bearer <你的 App Token>
Content-Type: application/json
{
"appid": "we_xxxxxxxxxxxxxxx"
}1
2
3
4
5
6
7
2
3
4
5
6
7
bash
curl -X POST '{BASE_URL}/wx-api/api/message/getPendingGroupSendList' \
-H 'Authorization: Bearer <你的 App Token>' \
-H 'Content-Type: application/json' \
--data-raw '{
"appid": "we_xxxxxxxxxxxxxxx"
}'1
2
3
4
5
6
2
3
4
5
6
python
import requests
url = "{BASE_URL}/wx-api/api/message/getPendingGroupSendList"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
"appid": "we_xxxxxxxxxxxxxxx"
}"""
resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
String url = "{BASE_URL}/wx-api/api/message/getPendingGroupSendList";
String body = "{\n" +
" \"appid\": \"we_xxxxxxxxxxxxxxx\"\n" +
"}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
.header("Authorization", "Bearer <你的 App Token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
php
<?php
$url = '{BASE_URL}/wx-api/api/message/getPendingGroupSendList';
$body = <<<'JSON'
{
"appid": "we_xxxxxxxxxxxxxxx"
}
JSON;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer <你的 App Token>',
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
响应示例
json
{
"code": 0,
"data": {
"hasMore": true,
"list": null,
"nextKey": {
"msgId": 0
}
},
"detail": "",
"message": "ok",
"time": "2026-09-11 20:20:00"
}1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
响应字段
响应字段（9 项）
| 字段 | 类型 | 说明 |
|---|---|---|
code | int64 | 统一封套状态码：0=成功，负数=失败 |
data | object | 业务数据 |
data.hasMore | boolean | 是否还有更多 |
data.list | object | 消息对象数组 |
data.nextKey | object | 翻页游标对象 |
data.nextKey.msgId | int64 | 下一页起始 msgId |
detail | string | 附加明细，通常为空 |
message | string | 文案：成功为 ok；失败形如 -码|描述 |
time | string | 服务端处理时间 YYYY-MM-DD HH:MM:SS |