什么是「升级服务」

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

获取配置的专员与客户群

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

请求方式: GET(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/kf/customer/get_upgrade_service_config?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"
		]
	}
}

参数说明:

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

企业可通过其他接口获知客户的 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": "欢迎加入你的专属服务群"
	}
}

参数说明：

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

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

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

返回结果:

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

参数说明:

为客户取消推荐

当企业通过 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"
}

参数说明：

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

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

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

返回结果:

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

参数说明: