# 查询单个群发消息客户接收结果(平台号)

目前仅支持平台号

[异步回调]

该接口用于查询单个群发消息客户接收的结果,可通过该接口得知推送的客户的接收情况。该回调以分页形式返回,每页最多返回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": ""}'

最后更新时间: 2023/5/24 10:48:59