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

POST

http://127.0.0.1/cgi-bin/kf/customer/upgrade_service

最后修改时间：2022-08-30 03:03:37

责任人：未设置

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

权限说明:
企业需要使用“微信客服”secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“微信客服权限->服务工具->配置「升级服务」”权限
要求userid/chatid已配置在微信客服中的“升级服务”中专员服务或客户群服务才可使用API进行设置，否则会返回95021错误码。

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

请求参数

Query 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/kf/customer/upgrade_service?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "open_kfid": "kfxxxxxxxxxxxxxx",
    "external_userid": "wmxxxxxxxxxxxxxxxxxx",
    "type": 1,
    "member": {
        "userid": "zhangsan",
        "wording": "你好，我是你的专属服务专员zhangsan"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2022-08-30 03:03:37

「升级服务」配置-获取配置的专员与客户群

「升级服务」配置-为客户取消推荐