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

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

  • URL:https://api2.nxcloud.com/saas/cc/openapi/agentGroup/page
  • Method:POST
  • Content-Type:application/json
  • Required:yes

鉴权机制

鉴权规则请参考地址: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 鉴权部分