获取联系客户统计数据
企业可通过此接口获取成员联系客户的数据，包括发起申请数、新增客户数、聊天数、发送消息数和删除/拉黑成员的客户数等指标
POST https://qw-openapi-tx.dustess.com/external_contact/v1/get_user_behavior_data?accessToken=
Content-Type: application/json| 字段 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| accessToken | String | accessToken | true |
| 请求参数名 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| qw_user_ids | String[] | 企微员工ID列表(单次不超过100) | false |
| cf_user_ids | String[] | 尘锋员工ID列表(单次不超过100) | false |
| dept_ids | Int[] | 尘锋部门ID列表(单次不超过100) | false |
| start_time | Int | 数据起始时间 (时间戳) | true |
| end_time | Int | 数据起始时间 (时间戳) | true |
员工ID和部门ID不可同时为空;
qw_user_ids优先级高于cf_user_ids;
此接口提供的数据以天为维度，查询的时间范围为[start_time,end_time]，即前后均为闭区间，支持的最大查询跨度为30天；
客户最多可获取最近180天内的数据；
当传入的时间不为0点时间戳时，会向下取整，如传入1554296400(Wed Apr 3 21:00:00 CST 2019)会被自动转换为1554220800（Wed Apr 3 00:00:00 CST > 2019）;
如传入多个员工ID，则表示获取这些员工总体的联系客户数据。
{
"cf_user_ids": [
"0",
"1"
],
"qw_user_ids": [
"user1",
"user2"
],
"dept_ids": [
1001,
1002
],
"start_time": 1536508800,
"end_time": 1536595200
}| 响应参数名 | 类型 | 说明 |
|---|---|---|
| success | Bool | 是否成功 |
| code | Int | 响应码 |
| msg | String | 消息提示 |
| data | Object | 返回数据 |
| data.list | Object[] | 返回数据列表 |
| data.list.stat_time | Int | 数据日期，为当日0点的时间戳 |
| data.list.new_apply_cnt | Int | 发起申请数，成员通过「搜索手机号」、「扫一扫」、「从微信好友中添加」、「从群聊中添加」、「添加共享、分配给我的客户」、「添加单向、双向删除好友关系的好友」、「从新的联系人推荐中添加」等渠道主动向客户发起的好友申请数量 |
| data.list.new_contact_cnt | Int | 新增客户数，成员新添加的客户数量 |
| data.list.chat_cnt | Int | 聊天总数， 成员有主动发送过消息的单聊总数 |
| data.list.message_cnt | Int | 发送消息数，成员在单聊中发送的消息总数 |
| data.list.reply_percentage | Float | 已回复聊天占比，浮点型，客户主动发起聊天后，成员在一个自然日内有回复过消息的聊天数/客户主动发起的聊天数比例，不包括群聊，仅在确有聊天时返回 |
| data.list.avg_reply_time | Int | 平均首次回复时长，单位为分钟，即客户主动发起聊天后，成员在一个自然日内首次回复的时长间隔为首次回复时长，所有聊天的首次回复总时长/已回复的聊天总数即为平均首次回复时长，不包括群聊，仅在确有聊天时返回 |
| data.list.negative_feedback_cnt | Int | 删除/拉黑成员的客户数，即将成员删除或加入黑名单的客户数。 |
{
"success": true,
"code": 0,
"msg": "OK",
"data": {
"list": [
{
"stat_time": 1536508800,
"chat_cnt": 100,
"message_cnt": 80,
"reply_percentage": 60.25,
"avg_reply_time": 1,
"negative_feedback_cnt": 0,
"new_apply_cnt": 6,
"new_contact_cnt": 5
},
{
"stat_time": 1536595200,
"chat_cnt": 20,
"message_cnt": 40,
"reply_percentage": 100,
"avg_reply_time": 1,
"negative_feedback_cnt": 0,
"new_apply_cnt": 6,
"new_contact_cnt": 5
}
]
}
}