获取客服帐号链接 - Developer OpenAPI

企业可通过此接口获取带有不同参数的客服链接，不同客服帐号对应不同的客服链接。获取后，企业可将链接嵌入到网页等场景中，微信用户点击链接即可向对应的客服帐号发起咨询。企业可依据参数来识别用户的咨询来源等。

1.
若scene非空，返回的客服链接开发者可拼接scene_param=SCENE_PARAM参数使用，用户进入会话事件会将SCENE_PARAM原样返回。其中SCENE_PARAM需要urlencode，且长度不能超过128字节。
如 https://work.weixin.qq.com/kf/kfcbf8f8d07ac7215f?enc_scene=ENCGFSDF567DF**&scene_param=a%3D1%26b%3D2**
2.
历史调用接口返回的客服链接（包含encScene=XXX参数），不支持scene_param参数。
3.
返回的客服链接，不能修改或复制参数到其他链接使用。否则进入会话事件参数校验不通过，导致无法回调。

权限说明:

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

第三方应用需具有“微信客服->获取基础信息”权限

文档ID: 31144
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/94692
https://open.work.weixin.qq.com/api/doc/90000/90135/94665

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

open_kfid

string

客服帐号ID

必需

scene

string

必需

场景值，字符串类型，由开发者自定义。不多于32字节字符串取值范围(正则表达式)：[0-9a-zA-Z_-]*

示例

{
  "open_kfid": "OPEN_KFID",
  "scene": "12345"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

对返回码的文本描述内容

url

string

必需

客服链接，开发者可将该链接嵌入到H5页面中，用户点击链接即可向对应的微信客服帐号发起咨询。开发者也可根据该url自行生成需要的二维码图片

示例

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