华为云首页用户手册

云客服-获取云客服的账号信息:操作步骤

时间：2023-11-01 16:20:00

云客服

操作步骤

调用座席软电话信息查询接口（queryAgentInfo）获取可用于同步的信息。

按以下格式要求获取URL，选择GET方式。
HTTPS方法：GET
URL：http(s)://Domain Address/apiaccess/CC-Mangemant/v1/queryAgentInfo

Domain Address请根据云客服实际的地址或域名进行替换。
例如，在华为公有云生产环境，请将Domain Address替换为service.besclouds.com，则调用URL为https://service.besclouds.com/apigovernance/api/oauth/tokenByAkSk
HTTP协议是不安全协议，可能会对系统带来风险，不推荐使用。建议使用安全的HTTPS协议。

将x-app-key和Authorization的值按调用样例的格式输入到Header，获取所需输出参数，如图1所示。您可以通过表1和表2了解请求参数属性和返回参数属性的要求。
图1 queryAgentInfo调用

表1 RequestHeader说明
参数名	参数类型	参数位置	是否必填	说明
x-app-key	string	header	True	app标识。即您的app_key
Authorization	string	header	True	鉴权信息。为"Bearer "+鉴权接口获得的AccessToken

Example

{"x-app-key":XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"Authorization":Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}

表2 ResponseBody说明
参数名	参数类型	参数位置	是否必填	说明
sipServiceIp	string	body	False	软电话注册地址，IPV4格式。
sipServicePort	int	body	False	软电话注册端口，值为1~65535。
agents	list	body	True	座席集合。
workNo	int	agents	True	座席工号。
sipAccount	string	agents	False	软电话号码。
sipPwd	string	agents	False	软电话密码。
accountCode	string	agents	False	云客服登录账号。

Example

{    "sipServiceIp":"10.100.10.10",    "sipServicePort":1000,    "agents": [        {            "workNo": 1001,            "accountCode": "11",            "sipAccount": "1001",            "sipPwd": "cti-1234"        }    ]}

同步到座席相关信息后，您可能还需要在您的系统中完成如下事项：
1. （可选）将您业务系统中的账户与云客服座席对象做关联，在开发集成页面步骤请求云客服时需要用到关联好的账户。如果您期望企业业务系统的用户每次登录时自行选择云客服账号登录云客服，可以跳过该步骤。
2. （可选）为座席提供软电话号码、软电话密码以及软电话注册地址/端口号，座席需要使用这些信息登录OpenEye客户端，进行呼入呼出操作。如果您使用OpenEye以外的SIP软电话工具进行呼叫操作可以跳过该步骤。

上一篇：云客服-集成步骤

下一篇：云客服-跨域请求报500，第三方鉴权失败:解决办法