第三方应用开发 服务端API 客户联系 统计管理 获取「联系客户统计」数据
获取「联系客户统计」数据

企业可通过此接口获取成员联系客户的数据,包括发起申请数、新增客户数、聊天数、发送消息数和删除/拉黑成员的客户数等指标。

 

请求方式: POST(HTTP)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_user_behavior_data?access_token=ACCESS_TOKEN

请求示例

{
    "userid": [
        "zhangsan",
        "lisi"
    ],
	"partyid":
	[
		1001,
		1002
	],
    "start_time":1536508800,
	"end_time":1536595200
}

参数说明:

参数必须说明
access_token调用接口凭证
userid成员ID列表,最多100个
partyid部门ID列表,最多100个
start_time数据起始时间
end_time数据结束时间
userid和partyid不可同时为空;
此接口提供的数据以天为维度,查询的时间范围为[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);
如传入多个userid,则表示获取这些成员总体的联系客户数据。

 

权限说明:

  • 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?)。
  • 第三方应用使用,需具有“企业客户权限->客户联系->获取成员联系客户的数据统计”权限。
  • 第三方/自建应用调用时传入的userid和partyid要在应用的可见范围内;

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
	"behavior_data":
	[
		{
		"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
		}
	]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
behavior_data.stat_time数据日期,为当日0点的时间戳
behavior_data.new_apply_cnt发起申请数,成员通过「搜索手机号」、「扫一扫」、「从微信好友中添加」、「从群聊中添加」、「添加共享、分配给我的客户」、「添加单向、双向删除好友关系的好友」、「从新的联系人推荐中添加」等渠道主动向客户发起的好友申请数量。
behavior_data.new_contact_cnt新增客户数,成员新添加的客户数量。
behavior_data.chat_cnt聊天总数, 成员有主动发送过消息的单聊总数。
behavior_data.message_cnt发送消息数,成员在单聊中发送的消息总数。
behavior_data.reply_percentage已回复聊天占比,浮点型,客户主动发起聊天后,成员在一个自然日内有回复过消息的聊天数/客户主动发起的聊天数比例,不包括群聊,仅在确有聊天时返回。
behavior_data.avg_reply_time平均首次回复时长,单位为分钟,即客户主动发起聊天后,成员在一个自然日内首次回复的时长间隔为首次回复时长,所有聊天的首次回复总时长/已回复的聊天总数即为平均首次回复时长,不包括群聊,仅在确有聊天时返回
behavior_data.negative_feedback_cnt删除/拉黑成员的客户数,即将成员删除或加入黑名单的客户数。

 

上一篇
入群欢迎语素材管理
下一篇
获取「群聊数据统计」数据