更新时间:2023-09-26 GMT+08:00
同步企业系统与云客服的账号信息
如果您希望直接获取已配置的坐席账号信息,可在云客服的
目录进行获取。操作步骤
- 调用座席软电话信息查询接口(queryAgentInfo)获取可用于同步的信息。
- 按以下格式要求获取URL,选择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协议。
表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" } ] }
- 按以下格式要求获取URL,选择GET方式。
- 同步到座席相关信息后,您可能还需要在您的系统中完成如下事项:
- (可选)将您业务系统中的账户与云客服座席对象做关联,在开发集成页面步骤请求云客服时需要用到关联好的账户。如果您期望企业业务系统的用户每次登录时自行选择云客服账号登录云客服,可以跳过该步骤。
- (可选)为座席提供软电话号码、软电话密码以及软电话注册地址/端口号,座席需要使用这些信息登录OpenEye客户端,进行呼入呼出操作。如果您使用OpenEye以外的SIP软电话工具进行呼叫操作可以跳过该步骤。
父主题: 集成开发