NXCC API queueAgents - nxtele/http-api-document GitHub Wiki

查询坐席组和坐席的绑定关系

• URL：https://api-hk.nxlink.ai/saas/cc/openapi/agentGroup/member/list
• Method：POST
• Content-Type：application/json
• Required：yes

🌐 服务接入点

NXLink 在全球部署了多个服务区域，请根据您的业务所在地选择对应的服务接入点。不同区域的网站域名和API网关域名不同。

代号	区域	NXLink网站	API网关
APAC	香港	https://app.nxlink.ai	https://api-hk.nxlink.ai
AMER	美洲	https://chl-nxlink.nxcloud.com	https://chl-api.nxlink.ai
APAC(IDN)	印尼	https://idn.nxlink.ai	https://api-idn.nxlink.ai

鉴权机制

鉴权规则请参考地址：API 接口调用约定

请求参数

header：

参数名	类型	必选	示例值	说明
accessKey	String	Y	fme2na3kdi3ki	用户身份标识
ts	String	Y	1655710885431	当前请求的时间戳（单位是毫秒），牛信服务端允许用户端请求最大时间误差为 60 秒
bizType	String	Y	8	业务类型，取固定值“8”
action	String	Y	cc	业务操作，取固定值“cc”
sign	String	Y	6e9506557d1f289501d333ee2c365826	API 入参参数签名，签名算法

|

body ：

参数名	类型	必选	示例值	说明
tenantId	Integer	Y	144	团队ID, 从牛信页面查询到并配置
queueNo	string	Y	NX10000001	坐席组编号(唯一值)

请求示例

body（application/json）：

{
    "tenantId": 144,
    "queueNo": "NXQueue0001"
}

响应参数

参数名	类型	说明
code	Integer	code
data	Object	reponse data
msg	String	message

请求成功

• data 参数：

参数名	类型	必选	说明
nickName	string	N	坐席昵称
userName	string	Y	坐席账号
sipNumber	string	Y	sip 分机号(唯一值，不可修改)

响应示例

成功示例

{
    "reqId": "a23738fb613d889026fa2c8f4e4378f1",
    "code": 0,
    "msg": "Success",
    "data": [
        {
            "sipNumber": "NXAgent000011",
      	    "nickName": "example1",
     	    "userName": "[email protected]"
        },
        {
            "sipNumber": "NXAgent1000013",
      	    "nickName": "example2",
     	    "userName": "NXAgent1000013"
        }
    ]
}

失败示例

{
  "reqId": "FFDD1791E22F4D9DBA967C245C58E544",
  "code": 1001,
  "msg": "Authorization Failed",
  "data": {}
}

响应码说明

code	message	Resolution
0	请求成功
88	请求失败	请联系技术人员排除问题
99	系统错误	请联系技术人员排除问题
1000~100X	鉴权失败	详情查看 API 鉴权部分