查询群聊数据统计-按自然日聚合方式

POST https://qw-openapi-tx.dustess.com/externalContact/v1/groupchat/statistic_by_day?accessToken=

Content-Type: application/json

注意:

获取指定日期的统计数据。注意，企业微信仅存储180天的数据。

接口限制：每分钟调用600次；

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
day_begin_time	`Int`	起始日期的时间戳，填当天的0时0分0秒（否则系统自动处理为当天的0分0秒）。取值范围：昨天至前180天。	true
day_end_time	`Int`	结束日期的时间戳，填当天的0时0分0秒（否则系统自动处理为当天的0分0秒）。取值范围：昨天至前180天。如果不填，默认同 day_begin_time（即默认取一天的数据）	false
owner_filter	`Object`	群主过滤。如果不填，表示获取应用可见范围内全部群主的数据（但是不建议这么用，如果可见范围人数超过1000人，为了防止数据包过大，会报错 81017）	true
owner_filter.userid_list	`String[]`	群主ID(即尘锋员工id)列表, 与企微群主ID列表任选一, 当企微群主ID列表不为空时忽略此值。最多100个	true
owner_filter.qw_userid_list	`String[]`	群主ID(即企微员工id)列表, 与尘锋群主ID列表任选一, 最多100个	true

请求参数示例

{
  "day_begin_time": 1600272000,
  "day_end_time": 1600444800,
  "owner_filter": {
    "userid_list": [
      "123"
    ],
    "qw_userid_list": [
      "zhangsan"
    ]
  }
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码
msg	`String`	消息提示
success	`Bool`	是否成功
data	`Object[]`	返回数据
data.errcode	`Int`	企微返回码
data.errmsg	`String`	对返回码的文本描述内容
data.items	`Object[]`	记录列表。表示某个群主所拥有的客户群的统计数据
data.items.stat_time	`Int`	数据日期，为当日0点的时间戳, 单位秒
data.items.data	`Object`	详情
data.items.data.new_chat_cnt	`Int`	新增客户群数量
data.items.data.chat_total	`Int`	截至当天客户群总数量
data.items.data.chat_has_msg	`Int`	截至当天有发过消息的客户群数量
data.items.data.new_member_cnt	`Int`	客户群新增群人数
data.items.data.member_total	`Int`	截至当天客户群总人数
data.items.data.member_has_msg	`Int`	截至当天有发过消息的群成员数
data.items.data.msg_total	`Int`	截至当天客户群消息总数
data.items.data.migrate_trainee_chat_cnt	`Int`	截至当天新增迁移群数(仅教培行业返回)

成功响应示例

{
  "success": true,
  "code": 0,
  "msg": "OK",
  "data": {
    "errcode": 0,
    "errmsg": "ok",
    "items": [
      {
        "stat_time": 1600272000,
        "data": {
          "new_chat_cnt": 2,
          "chat_total": 2,
          "chat_has_msg": 0,
          "new_member_cnt": 0,
          "member_total": 6,
          "member_has_msg": 0,
          "msg_total": 0,
          "migrate_trainee_chat_cnt": 3
        }
      },
      {
        "stat_time": 1600358400,
        "data": {
          "new_chat_cnt": 2,
          "chat_total": 2,
          "chat_has_msg": 0,
          "new_member_cnt": 0,
          "member_total": 6,
          "member_has_msg": 0,
          "msg_total": 0,
          "migrate_trainee_chat_cnt": 3
        }
      }
    ]
  }
}