# 查询客户/群的统计列表

请求方式: POST(HTTPS

请求地址: https://nbd-api.myscrm.cn/open-nbd-qw-groupmsg/v1/groupmsg/customer/statistical

请求参数说明:

名称 类型 必须 说明
groupmsg_id string 群发 id
qw_user_id string 企微成员 id
qw_user_name string 成员名称(模糊匹配)
keyword string 关键字搜索(客户/客户群名称)
receive_status int32 送达状态:1-未送达,2-已送达
is_filter_status int32 是否过滤状态:1-是
status int32 送达状态:0-未发送 1-已发送 2-因客户不是好友导致发送失败 3-因客户已经收到其他群发消息导致发送失败
pager object 分页信息
pager.page int64 页码
pager.page_size int64 分页行数

请求示例:

{
  "groupmsg_id": "3a007784-085e-2039-4c86-6261fe641d20",
  "pager": {
    "page": 1,
    "page_size": 10
  }
}

返回数据:

{
  "errcode": 0,
  "errmsg": "ok",
  "list": [
    {
      "external_userid": "wm-TUtCAAALRrnWHTymv0Htg2Z-RAp0A",
      "name": "谪餮",
      "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM5cExWicvmKAjOjH0lH96kDONLrD6XcWMkcVGZxB0qanAA/0",
      "type": 1,
      "gender": 2,
      "send_time": 0,
      "status": 0,
      "qw_user_id": "xxx",
      "qw_user_name": "胡江",
      "chat_id": "string"
    }
  ],
  "pager": {
    "page": "1",
    "page_size": "10",
    "total_rows": "1"
  }
}

返回参数说明:

名称 类型 说明
list array 客户列表
list.external_userid string 外部联系人的 userid
list.name string 外部联系人的名称
list.avatar string 外部联系人头像,
list.type int32 外部联系人的类型,1 表示该外部联系人是微信用户,2 表示该外部联系人是企业微信用户
list.gender int32 外部联系人性别 0-未知 1-男性 2-女性
list.qw_user_id string 所属成员 id
list.qw_user_name string 所属成员
list.send_time int64 送达时间
list.status int32 送达状态:0-未发送 1-已发送 2-因客户不是好友导致发送失败 3-因客户已经收到其他群发消息导致发送失败
list.chat_id string 客户群 id
pager object 分页信息
pager.page string 页码
pager.page_size string 分页行数
pager.total_rows string 总行数