第三方应用开发 服务端API 微信客服 「升级服务」配置
「升级服务」配置
最后更新:2024/01/22
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
「升级服务」配置
最后更新:2024/01/22

目录

  •       什么是「升级服务」
  • 获取配置的专员与客户群
  • 为客户升级为专员或客户群服务
  • 为客户取消推荐
  • 什么是「升级服务」

    当客户需要长期或多样的服务时,接待人员可发送专员名片或客户群二维码给客户,邀请客户升级服务 了解详情

    获取配置的专员与客户群

    企业需要在管理后台或移动端中的「微信客服」-「升级服务」中,配置专员和客户群。该接口提供获取配置的专员与客户群列表的能力。

    请求方式: GET(HTTPS)

    请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/customer/get_upgrade_service_config?access_token=ACCESS_TOKEN

    参数说明:

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

    权限说明:
    调用的应用需要满足如下的权限

    应用类型权限要求
    自建应用配置到「 微信客服- 可调用接口的应用」中
    第三方应用具有“微信客服->服务工具->配置「升级服务」”权限
    代开发自建应用具有“微信客服->服务工具->配置「升级服务」”权限

    注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

    • 要求 userid/chatid 对应群主在应用可见范围内

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
    	"member_range": {
    		"userid_list": [
    			"zhangsan",
    			"lisi"
    		],
    		"department_id_list": [
    			2,
    			3
    		]
    	},
    	"groupchat_range": {
    		"chat_id_list": [
    			"wraaaaaaaaaaaaaaaa",
    			"wrbbbbbbbbbbbbbbb"
    		]
    	}
    }

    参数说明:

    参数类型说明
    errcodeint返回码
    errmsgstring错误码描述
    member_rangeobject专员服务配置范围
    member_range.userid_liststring专员userid列表
    member_range.department_listunsigned int专员部门列表
    groupchat_rangeobject客户群配置范围
    groupchat_range.chat_id_liststring客户群列表

     

    为客户升级为专员或客户群服务

    企业可通过其他接口获知客户的 external_userid 以及客户与接待人员的聊天内容,因此可以结合实际业务场景,为客户推荐指定的服务专员或客户群。
    通过该 API 为客户指定专员或客户群后,接待人员可在企业微信中,见到特殊的状态提示(Windows 为 icon 样式变化,移动端为出现一条 bar ),便于接待人员知晓企业的指定动作。

    请求方式: POST(HTTPS)

    请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/customer/upgrade_service?access_token=ACCESS_TOKEN

    升级专员服务:

    {
    	"open_kfid": "kfxxxxxxxxxxxxxx",
    	"external_userid": "wmxxxxxxxxxxxxxxxxxx",
    	"type": 1,
    	"member": {
    		"userid": "zhangsan",
    		"wording": "你好,我是你的专属服务专员zhangsan"
    	}
    }

    升级客户群服务:

    {
    	"open_kfid": "kfxxxxxxxxxxxxxx",
    	"external_userid": "wmxxxxxxxxxxxxxxxxxx",
    	"type": 2,
    	"groupchat": {
    		"chat_id": "wraaaaaaaaaaaaaaaa",
    		"wording": "欢迎加入你的专属服务群"
    	}
    }

    参数说明:

    参数是否必须说明
    access_token调用接口凭证
    open_kfid客服账号ID
    external_userid微信客户的external_userid
    type表示是升级到专员服务还是客户群服务。1:专员服务。2:客户群服务
    member推荐的服务专员,type等于1时有效
    member.userid服务专员的userid
    member.wording推荐语
    groupchat推荐的客户群,type等于2时有效
    groupchat.chat_id客户群id
    groupchat.wording推荐语


    权限说明:
    调用的应用需要满足如下的权限

    应用类型权限要求
    自建应用配置到「 微信客服- 可调用接口的应用」中
    第三方应用具有“微信客服->服务工具->配置「升级服务”权限
    代开发自建应用具有“微信客服->服务工具->配置「升级服务”权限

    注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

    • 操作的客服账号对应的接待人员应在应用的可见范围内
    • 要求 userid/chatid 对应群主在应用可见范围内
    • 要求userid/chatid已配置在微信客服中的“升级服务”中专员服务或客户群服务才可使用API进行设置,否则会返回95021错误码。
    • 要求userid在“客户联系->权限配置->客户联系和客户群"的使用范围内

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok"
    }

    参数说明:

    参数类型说明
    errcodeint返回码
    errmsgstring错误码描述

    为客户取消推荐

    当企业通过 API 为客户指定了专员或客户群后,如果客户已经完成服务升级,或是企业需要取消推荐,则可调用该接口清空之前为客户指定的专员或客户群。清空后,企业微信中的特殊状态提示也会同步消失。

    请求方式: POST(HTTPS)

    请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/customer/cancel_upgrade_service?access_token=ACCESS_TOKEN

    请求示例:

    {
    	"open_kfid": "kfxxxxxxxxxxxxxx",
    	"external_userid": "wmxxxxxxxxxxxxxxxxxx"
    }

    参数说明:

    参数是否必须说明
    access_token调用接口凭证
    open_kfid客服账号ID
    external_userid微信客户的external_userid


    权限说明:
    调用的应用需要满足如下的权限

    应用类型权限要求
    自建应用配置到「 微信客服- 可调用接口的应用」中
    第三方应用具有“微信客服->服务工具->配置「升级服务”权限
    代开发自建应用具有“微信客服->服务工具->配置「升级服务”权限

    注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

    • 操作的客服账号对应的接待人员应在应用的可见范围内
    • 要求 userid/chatid 对应群主在应用可见范围内

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok"
    }

    参数说明:

    参数类型说明
    errcodeint返回码
    errmsgstring错误码描述
    上一篇
    发送欢迎语等事件响应消息
    下一篇
    获取客户基础信息