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

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

• URL：https://api-hk.nxlink.ai/saas/cc/openapi/agentGroup/page
• 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, 从牛信页面查询到并配置
queueName	string	Y	NX10000001	坐席组编号(唯一值)
size	Integer	Y	200	Page Size (最大200)
page	Integer	Y	1	Page Number (从 1开始)

请求示例

body（application/json）：

{
    "tenantId": 144,
    "queueName": "NXQueue0001",
    "size": 100,
  	"page": 1
    
}

响应参数

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

请求成功

• data 参数：

参数名	类型	必选	说明
groupName	string	Y	坐席组名称
groupNo	string	Y	坐席组编号
remark	string	N	备注
familiarizeFirst	bool	N	是否开启熟客优先
ringPolicy	int	Y	振铃策略 1:同振, 2:顺振

响应示例

成功示例

{
    "reqId": "a23738fb613d889026fa2c8f4e4378f1",
    "code": 0,
    "msg": "Success",
    "data": [
        {
            "groupName": "测试坐席组",
      	    "groupNo": "NX60029101086000001",
     	    "remark": "重要坐席组,不要轻易删除",
            "familiarizeFirst": false,
     	    "ringPolicy": 2
        },
        {
            "groupName": "坐席组2",
      	    "groupNo": "NX60029101086000002",
     	    "remark": "",
            "familiarizeFirst": false,
     	    "ringPolicy": 2,
        }
    ]
}

失败示例

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

响应码说明

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