获取企业的全部群发记录-获取群发成员发送任务列表

POST

/cgi-bin/externalcontact/get_groupmsg_task

服务端API第三方应用开发企业内部开发

权限说明:
企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
自建应用调用，只会返回应用可见范围内用户的发送情况。
第三方应用调用需要企业授权客户联系下群发消息给客户和客户群的权限

2020-11-17日之前创建的消息无发送任务列表，请通过获取企业群发成员执行结果接口获取群发结果

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_groupmsg_task?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"msgid":"msgGCAAAXtWyujaWJHDDGi0mACAAAA","limit":50,"cursor":"CURSOR"}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "CURSOR",
  "task_list": [
    {
      "userid": "zhangsan",
      "status": 2,
      "send_time": 1552536375
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

cursor

string

可选

用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit

integer <int32>

可选

返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值

msgid

string

必需

群发消息的id，通过获取群发记录列表接口返回

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

next_cursor

string

可选

分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空

errmsg

string

可选

对返回码的文本描述内容

task_list

array [object {3}]

可选

群发成员发送任务列表

send_time

integer <int32>

可选

userid

string

可选

status

integer <int32>

可选

获取企业的全部群发记录-获取群发记录列表

获取企业的全部群发记录-获取企业群发成员执行结果