批量增加座席

场景描述

调用该接口批量增加座席(批量增加座席数不超过500个)。

接口方法

该接口仅支持POST方法。

接口URI

https://ip:port/agentgateway/resource/config/vdn/batchAgent

其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。

日志中的方法

batchAgent

请求消息

• 消息头

  表1 消息头参数说明

  序号	名称	参数类型	是否必选	说明
  1	Content-Type	string	True	消息主体编码方式，缺省值：application/json; charset=UTF-8
  2	Guid	string	True	Guid的取值为C5 智能辅助类接口鉴权方式接口返回的guid。

• 消息体
  该消息体为List形式，最多一次调用可添加500组。

  表2 消息体元素说明

  序号	名称	参数类型	是否必选	说明
  1	agentId	number	True	座席的工号。 取值的类型为整数，取值范围为101～999999。
  2	name	string	False	业务代表名。 最大长度为20字节，不含"[]'&()=;<>,特殊字符
  3	fullName	string	False	业务代表全名 最大长度为100字节，不含"[]'&()=;<>,特殊字符
  4	agentPwd	string	False	密码。 长度为8字节，只能是单字节字符。密码有效期默认为90天
  5	userClassId	number	True	角色编号。 取值类型为整数，根据实际的角色编号填写。
  6	asrInd	number	False	是否开启智能识别。 取值类型为整数，取值如下： 0：不开启 1：开启 默认值为0。
  7	socialChatNum	number	False	座席并发多媒体呼叫数。取值类型为整数。 默认值为0。
  8	enableDualChannelRec	number	False	是否开启双声道录音。 0：不开启 1：开启 默认值为0。 须知： “开启双声道录音”和“开启智能识别”不能同时打开，双声道录音和座席智能识别互斥，即在开启双声道录音，则不能开启智能识别，在开启智能识别时，不能开启双声道录音。
  9	skills	array	False	技能信息。目前没有按照技能组配置。 取值类型为整数数组。该对象的参数说明请参见表3。
  10	h5VideoNum	number	可选	H5 视频呼叫最大呼叫数，默认为0，表示不生效。 输入范围 0-1
  11	validTime	int	false	密码过期时间，单位天，默认值 90，值域范围：0~180，0表示永不失效。 说明： 永不失效有安全风险，请谨慎使用，建议设置取值范围内的值，保证定期修改密码。
  12	skillGroupIds	array	false	座席具备的技能组信息，取值类型为整数数组。
  13	mediaChanTotalCallNum	number	false	VDN级座席多媒体全渠道总并发数 取值范围：[0,60] 0表示不限制全渠道总并发数
  14	mmConcurrentCallNum	array	false	座席并发处理多媒体呼叫数, 为空则不按照媒体类型设置，兼容老数据。 如果传值，则原座席多媒体并发数（socialChatNum）字段失效。 字段说明如表4所示。

  表3 skills数组参数说明

  序号	名称	参数类型	是否必选	说明
  9.1	skillId	number	False	技能编号。 取值类型为整数，根据实际的技能编号填写。
  9.2	skillPower	number	False	技能权值。 取值类型为整数，取值范围为1～100。
  9.3	agentPower	number	False	座席权值。 取值类型为整数，取值范围为1～300。

  表4 mmConcurrentCallNum多媒体渠道配置

  序号	名称	参数类型	是否必选	说明
  12.1	chnType	number	True	媒体类型。其中： 50：多媒体Email 51：多媒体Web Chat 52：多媒体SMS 53：Social Chat 56：多媒体Wechat 57：多媒体Facebook 58：多媒体Twitter 59：多媒体5G 60：多媒体Line 61：多媒体WhatsApp 62：多媒体Instagram 63：多媒体Telegram
  13.2	mmCallNum	number	True	座席最大会话数，取值范围：[-1,60] (默认)0表示使用vdn配置 -1表示无并发数

响应消息

报文样例

• 消息头

  Content-Type:application/json; charset=UTF-8
  Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1

• 请求参数

  [
      {
          "agentId": 114,
          "name": "zhang",
          "fullName": "zhangsan",
          "agentPwd": "********",
          "userClassId": 1,
          "asrInd": 1,
          "socialChatNum": 1,
          "enableDualChannelRec": 0,
          "skills": [
              {
                  "skillId": 1,
                  "skillPower": 1,
                  "agentPower": 1
              }
          ],
          "skillGroupIds":[1,2],
          "mediaChanTotalCallNum": "8",
          "mmConcurrentCallNums": [{
              "chnType": "53",
              "mmCallNum": "1"
          }]
      },
      {
          "agentId": 115,
          "name": "zhang",
          "fullName": "zhangsan",
          "agentPwd": "********",
          "userClassId": 1,
          "asrInd": 1,
          "socialChatNum": 1,
          "enableDualChannelRec": 0,
          "skills": [
              {
                  "skillId": 1,
                  "skillPower": 1,
                  "agentPower": 1
              }
          ],
          "skillGroupIds":[1,2],
          "mediaChanTotalCallNum": "8",
          "mmConcurrentCallNums": [{
              "chnType": "53",
              "mmCallNum": "1"
          }]
      },
      {
          "agentId": 116,
          "name": "zhang",
          "fullName": "zhangsan",
          "agentPwd": "********",
          "userClassId": 1,
          "asrInd": 1,
          "socialChatNum": 1,
          "enableDualChannelRec": 0,
          "skills": [
              {
                  "skillId": 1,
                  "skillPower": 1,
                  "agentPower": 1
              }
          ],
          "skillGroupIds":[1,2],
          "mediaChanTotalCallNum": "8",
          "mmConcurrentCallNums": [{
              "chnType": "53",
              "mmCallNum": "1"
          }]
      }
  ]

• 响应参数

  {
      "message": "success",
      "retcode": "0"
  }