更新时间:2024-05-22 GMT+08:00
分享

同步企业系统与云客服的账号信息

您可以通过调用queryAgentInfo接口,获取可同步的座席信息,包括注册服务器信息、座席账户密码、云客服登录账号等信息,调用后将云客服登录账号与您原业务系统中的座席登录账号进行关联同步,使得在企业页面请求接续条时,能自动获取匹配的账户验证信息。

如果您希望直接获取已配置的坐席账号信息,可在云客服的配置中心 > 员工中心 > 员工目录进行获取。

操作步骤

  1. 调用座席软电话信息查询接口(queryAgentInfo)获取可用于同步的信息。

    1. 按以下格式要求获取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协议。
    1. 将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. 同步到座席相关信息后,您可能还需要在您的系统中完成如下事项:

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

相关文档