「升级服务」配置-为客户升级为客户群服务

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

权限说明:

企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）

第三方应用需具有“微信客服权限->服务工具->配置「升级服务」”权限

代开发自建应用需具有“微信客服权限->服务工具->配置「升级服务」”权限

要求userid/chatid已配置在微信客服中的“升级服务”中专员服务或客户群服务才可使用API进行设置，否则会返回95021错误码。

要求userid在“客户联系->权限配置->客户联系和客户群"的使用范围内

文档ID: 31085
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/94674
https://open.work.weixin.qq.com/api/doc/90001/94702

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/kf/customer/upgrade_service?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{ "open_kfid": "kfxxxxxxxxxxxxxx", "external_userid": "wmxxxxxxxxxxxxxxxxxx", "type": 2, "groupchat": { "chat_id": "wraaaaaaaaaaaaaaaa", "wording": "欢迎加入你的专属服务群" } }'

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

open_kfid

string

客服帐号ID

必需

external_userid

string

必需

微信客户的external_userid

type

integer

必需

表示是升级到专员服务还是客户群服务。1:专员服务。2:客户群服务

groupchat

object

可选

推荐的客户群，type等于2时有效

userid

string

客户群id

必需

wording

string

推荐语

必需

示例

「升级服务」配置-为客户升级为客户群服务

请求参数

返回响应