企业内部开发 服务端API 客户联系 获客助手 获客助手额度管理与使用统计
获客助手额度管理与使用统计
最后更新:2023/08/08
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获客助手额度管理与使用统计
最后更新:2023/08/08

目录

  • 查询剩余使用量
  • 查询链接使用详情
  • 查询剩余使用量

    企业可通过此接口查询当前剩余的使用量。

    请求方式:GET(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition_quota?access_token=ACCESS_TOKEN

    参数说明:

    参数必须说明
    access_token调用接口凭证

     

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?);
    • 第三方或代开发应用需具有“企业客户权限->获客助手”权限
    • 不支持客户联系系统应用调用

     

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
       "total":1000,
       "balance":500,
       "quota_list":
       [
       		{
    		 		"expire_date":1689350400,
    				"balance":200
    			},
    			{
    				"expire_date":1692028800,
    				"balance":300
    			}
       ]
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    total历史累计使用量
    balance剩余使用量
    quota_list.expire_date额度过期时间戳,为过期日的零点,实际过期时间取决于额度的购买时间
    quota_list.balance即将过期额度数量

     

    查询链接使用详情

    企业可通过此接口查询指定获客链接在指定时间范围内的访问情况。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/statistic?access_token=ACCESS_TOKEN

    请求示例

    {
       "link_id":"caxxxxxxx",
       "start_time":1688140800,
       "end_time":1688486400
    }

     

    参数说明:

    参数必须说明
    access_token调用接口凭证
    link_id获客链接的id
    start_time统计起始时间戳
    end_time统计结束时间戳
    注意:
    1.统计范围的最小粒度为日,将自动转换为时间戳所在日进行统计,区间为闭区间。
    2.仅可查询最近180天内的使用记录,起始和结束时间相差不可超过30天

    权限说明:

    • 企业需要使用配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?);
    • 第三方或代开发应用需具有“企业客户权限->获客助手”权限
    • 不支持客户联系系统应用调用

     

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
       "click_link_customer_cnt":1000,
       "new_customer_cnt":500,
    
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    click_link_customer_cnt点击链接客户数
    new_customer_cnt新增客户数

     

    上一篇
    获取由获客链接添加的客户信息
    下一篇
    提升广告有效率