# 查询单个群发消息客户接收结果(平台号)
目前仅支持平台号
[异步回调]
该接口用于查询单个群发消息客户接收的结果,可通过该接口得知推送的客户的接收情况。该回调以分页形式返回,每页最多返回2000个客户接收情况。如该条群发消息发送的客户数据较多,若好友数据量较大,请耐心等候回调返回~
请求方式:POST
请求地址:https://$basehost/gateway/qopen/BroadcastMessagesSentCustomers
body参数:
{
"robot_id": "机器人id",
"msg_id": "群发的消息编号"
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
msg_id | string | 是 | 群发的消息编号,可在【客户联系群发助手回调】中获取 |
返回值:
{
"data": {
"serial_no": ""
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 请求序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值:
{
"event_type": 705011,
"serial_no": "",
"err_code": 0,
"err_msg": "success",
"data": {
"msg_id": "消息编号",
"last_page": true,
"customers": [
{
"customer_id": "客户id",
"status": 2
}
]
}
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,705011 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
data | object | 返回数据 |
data.msg_id | int | 消息编号 |
data.last_page | bool | 是否最后一页,true表示最后一页 |
data.customers[x].customer_id | string | 客户id |
data.customers[x].status | int | 0 待发送;1 已发送;2 客户已拒收;3 客户接收已达上限 |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/BroadcastMessagesSentCustomers \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{"robot_id": "", "msg_id": ""}'
← 客户联系群发助手接口 转发视频号消息 →