文档
测试

获取客户联系数据接口

GET
http://blg.baidukongjian.com/api/external/getExternalBehaviorData

业务实现

从simple_list遍历企业的user_id,通过获取联系客户统计数据接口,获取该用户的统计信息https://work.weixin.qq.com/api/doc/90000/90135/92132,存到一个数据表external_statistics里,存储数据格式是,corp_id,user_id,"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

请求参数

参数名
类型
描述
必填
corp_id
string(6-16)
企业id
必填
start_time
int
开始时间戳
必填
end_time
int
结束时间戳
必填

响应参数

参数名
类型
描述
必填
ret
string
返回请求结果
必填
ok
string
响应成功
必填
提示信息
string
服务器根据不同情况返回的提示信息
必填
data_arr
arr
必填
id
int
主键
必填
corpId
string
企业id
必填
userId
string
用户id
必填
statTime
int
当日0点的时间戳
必填
chatCnt
int
聊天总数, 成员有主动发送过消息的单聊总数
必填
messageCnt
int
发送消息数,成员在单聊中发送的消息总数
必填
replyPercentage
float
已回复聊天占比,浮点型,客户主动发起聊天后,成员在一个自然日内有回复过消息的聊天数/客户主动发起的聊天数比例,不包括群聊,仅在确有聊天时返回
必填
avgReplyTime
int
平均首次回复时长,单位为分钟,即客户主动发起聊天后,成员在一个自然日内首次回复的时长间隔为首次回复时长,所有聊天的首次回复总时长/已回复的聊天总数即为平均首次回复时长,不包括群聊,仅在确有聊天时返回
必填
negativeFeedbackCnt
int
删除/拉黑成员的客户数,即将成员删除或加入黑名单的客户数
必填
newApplyCnt
int
发起申请数,成员通过「搜索手机号」、「扫一扫」、「从微信好友中添加」、「从群聊中添加」、「添加共享、分配给我的客户」、「 添加单向、双向删除好友关系的好友」、「从新的联系人推荐中添加」等渠道主动向客户发起的好友申请数量
必填
newContactCnt
int
新增客户数,成员新添加的客户数量
必填

说明 / 示例

``` { "ret": "ok", "data_arr": [ { "id": 85, "corpId": "wwb044e1f927109dbd", "userId": "Felix", "statTime": 1603123200, "chatCnt": 0, "messageCnt": 0, "replyPercentage": null, "avgReplyTime": null, "negativeFeedbackCnt": 0, "newApplyCnt": 212, "newContactCnt": 0 }, { "id": 86, "corpId": "wwb044e1f927109dbd", "userId": "Felix", "statTime": 1603209600, "chatCnt": 0, "messageCnt": 0, "replyPercentage": null, "avgReplyTime": null, "negativeFeedbackCnt": 0, "newApplyCnt": 124, "newContactCnt": 0 } ] } ```