增加

场景描述

调用该接口增加座席。

接口方法

该接口仅支持POST方法。

接口URI

https://ip:port/agentgateway/resource/config/vdn/agents?agentId=103

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

日志中的方法名

addAgent

请求说明

• 消息头

  表2 消息头参数说明

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

• 消息体

  表3 消息体参数说明

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

  表4 skills数组参数说明

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

  表5 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

• 请求参数

  {
      "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"
          }
      ]
  }

• 响应参数

  {
      "result": {
          "agentId": 25004
      },
      "message": "success",
      "retcode": "0"
  }