修改

场景描述

调用该接口修改VDN。

接口方法

该接口仅支持PUT方法，不支持POST、GET和DELETE等方法。

接口URI

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

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

日志中的方法名

modifyVdnInfo

请求消息

• 消息头

  表1 消息头参数说明

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

• 消息体

  表2 消息体参数说明

  序号	名称	参数类型	是否必选	说明
  1	vdnInfo	object	False	VDN基本信息。 该对象的参数说明请参见表3。

  表3 vdnInfo对象参数说明

  序号	名称	参数类型	是否必选	说明
  1.1	callDispatchBySkillModel	number	False	呼叫分配方式。 0：技能最佳分配 1：平均分配 2：技能多者优先分配 3：来话比呼出技能优先分配 默认值为0。
  1.2	forceVdnSelfRecord	number	False	VDN强制自录制。 0：禁用 1：对所有话务员启用 2：由质检员选择话务员启用 3：按百分比录制 默认值为1。
  1.3	queueCancelKey	string	False	取消排队键。 最大长度为1字节。 可取值为0123456789*#。
  1.4	recordFormateOki	number	False	CP台会场录音格式。 0：缺省格式，可在CP台配置 2：24K VOX 8：32K VOX 16：64K Alaw 默认值为0。
  1.5	ccSRoutePolicy	number	False	CCS路由策略。 0：无条件按客户级别路由 1：参考客户排队时长路由 2：有条件按客户级别路由 默认值为0。
  1.6	callOutRecord	number	False	呼出呼叫录音发起时机。 0：振铃后 1：通话后 默认值为0。
  1.7	callInRecord	number	False	呼入呼叫录音发起时机。 0：振铃后 1：通话后 默认值为0。
  1.8	singlePhoneDisplayedNo	number	False	单电话座席来电显示。 0：系统主叫 1：客户号码 默认值为0。
  1.9	pcPhoneDisplayNo	number	False	PC+PHONE座席电话来电显示。 0：系统主叫 1：客户号码 默认值为0。
  1.10	mmConcurrentCallNum	array	False	座席并发处理多媒体呼叫数。 该数组中的对象参数说明请参见表4。
  1.11	isUseVdnAlertingVoice	number	False	是否使用VDN配置的回铃音 0：使用系统配置的回铃音 1：使用VDN配置的回铃音 默认值为0
  1.12	alertingVoice	object	False	回铃音信息 该对象的参数说明请参见表5。
  1.13	videoRecordingMode	number	False	视频录制模式 0：三方画面等大 1：客户画面最大 2：坐席画面最大 3：第三方画面最大 默认值为0。
  1.14	restQueueRule	number	False	休息排队策略。 0：先申请者优先休息 1：当天休息时长比例少者优先休息
  1.15	ifReleaseNoAnswerCall	number	False	座席久不应答呼叫是否释放。 0：否 1：是
  1.16	ifBusyNoAnswerAgent	number	False	座席久不应答座席是否示忙。 0：否 1：是
  1.17	multiMediaSynFlag	number	False	允许业务代表同时处理多种媒体呼叫。 0：否 1：是
  1.18	timeZone	string	False	vdn所在的时区。当为空白字符串时，表示使用配置提交时的系统默认时区。
  1.19	dstEnable	number	False	是否启用夏令时，默认值为0。南半球夏令时结束时间可能小于开始时间，需调用方保证夏令时结束时间正确性。 0：不启用，1启用
  1.20	dstOffsetTime	number	False	夏令时偏移时间（单位：分钟），取值范围 为[-1440,1440]，默认值为0。
  1.21	dstStartMonth	number	False	夏令时开始月份，默认值为3。
  1.22	dstStartIndex	number	False	夏令时开始周次，默认值为1。1~4：第1周~第4周；-1~-4：倒数第1周~倒数第4周。
  1.23	dstStartWeekDay	number	False	夏令时开始星期，默认值为1。1：星期天，2：星期1,...7：星期6
  1.24	dstStartTime	string	False	夏令时开始时间点，此时间为本地非夏令时时间，默认值为 "00:00"。
  1.25	dstEndMonth	number	False	夏令时结束月份，默认值为10。
  1.26	dstEndIndex	number	False	夏令时结束周次，默认值为1。1~4：第1周~第4周；-1~-4：倒数第1周~倒数第4周。
  1.27	dstEndWeekDay	number	False	夏令时结束星期，默认值为1。1：星期天，2：星期1,...7：星期6
  1.28	dstEndTime	string	False	夏令时结束时间点，此时间为本地非夏令时时间，默认值为 "00:00"。
  1.29	recordRuleId	string	可选	H5视频录制规则Id，最大长度11 说明： 参数已废弃调用接口时无需传参。
  1.30	recordPath	string	可选	H5视频录制文件存储路径，最大长度255 说明： 参数已废弃调用接口时无需传参。
  1.31	screenshotRuleId	string	可选	H5视频截图规则Id，最大长度11 说明： 参数已废弃调用接口时无需传参。
  1.32	screenshotPath	string	可选	H5视频截图文件存储路径，最大长度255 说明： 参数已废弃调用接口时无需传参。
  1.33	ifCancelBusyWhenCallOut	number	可选	在示忙状态下呼出或放音的处理方式。 0：视频缺省文件格式，在录音资源侧配置 1：AVI格式 2：3GP格式 默认值为0。
  1.34	systemAni	number	可选	系统主叫号码。 可取值为0123456789*#。最大长度24字节。
  1.35	vpLang	number	可选	VP音报工号语种。 0：普通话 1：英语 2：方言1 3：方言2 默认值为0。
  1.36	flowFilePath	string	可选	流程文件存放路径。 最大长度为255字节。
  1.37	allowedAgentRestMaxNum	number	可选	所有队列最大允许休息人数。 取值范围为1～1000。 默认值为1。
  1.38	selfRecordMediaType	number	可选	录制的媒体类型。 0：只录音频 1：录制音频和视频 默认值为0。
  1.39	allowDrvPlayQueueVoice	number	可选	排队处理时是否收号。 0：放排队音时不收号 1：放排队音时收号 默认值为0。
  1.40	recordVideoFormat	number	可选	录制的视频文件格式。 0：视频缺省文件格式，在录音资源侧配置 1：AVI格式 2：3GP格式 默认值为0。
  1.41	dialupRouteStrategy	number	可选	收号信息路由策略。 0：使用呼入被叫 + 收号信息路由 1：使用匹配呼叫 + 收号信息路由 默认值为0。
  1.42	mediaChanTotalCallNum	number	false	VDN级座席多媒体全渠道总并发数 取值范围：[0,60] 0表示不限制全渠道总并发数

  表4 多媒体处理呼叫数参数说明

  序号	名称	参数类型	是否必选	说明
  1.10.1	chnType	number	True	渠道类型
  1.10.2	mmCallNum	number	True	座席能够同时处理的多媒体并发呼叫数，默认为5。 渠道类型为 55 （H5 Video）时并发数只能为1。

  表5 alertingVoice对象参数说明

  序号	名称	参数类型	是否必选	说明
  1.12.1	voiceType	number	True	语音类型 1：SPT放音 2：VP放音 3：SIG放音 4：不播放语音
  1.12.2	voiceChildType	number	False	语音子类型 当voiceType为1时： 1：普通话 2：英语 3：方言1 4：方言2 当voiceType为2时： 5：放提示音 6：放指定文件 当voiceType为3或4时: 不需要配置语音子类型
  1.12.3	voiceValue	string	False	文件/序号 当voiceType为1时：设置为SPT语音编码 当voiceType为2时： voiceChildType为5时，配置提示音序号。如：66。 voiceChileType为6时，配置VP文件名称。如：“ENT66.in”。 当voiceType为3时：设置为语音句柄参数 当voiceType为4时：不需要配置

响应消息

报文样例

• 消息头

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

• 请求参数

  {
      "vdnInfo": {
          "ifCancelBusyWhenCallOut": 1,
          "singlePhoneDisplayedNo": 1,
          "systemAni": "123",
          "recordFormateOki": 0,
          "vpLang": 0,
          "flowFilePath": "C:\\",
          "queueCancelKey": "*",
          "allowedAgentRestMaxNum": 1,
          "pcPhoneDisplayNo": 1,
          "accessCodes": [
              "789654"
          ],
          "selfRecordMediaType": 0,
          "forceVdnSelfRecord": 0,
          "ifBusyNoAnswerAgent": 1,
          "callDispatchBySkillModel": 0,
          "allowDrvPlayQueueVoice": 0,
          "recordVideoFormat": 0,
          "dialupRouteStrategy": 0,
          "videoRecordingMode": 0,
          "timeZone": "+08:00",
          "dstEnable": 0,
          "dstOffsetTime": 1440,
          "dstStartMonth": 6,
          "dstStartIndex": 1,
          "dstStartWeekDay": 1,
          "dstStartTime": "06:00",
          "dstEndMonth": 9,
          "dstEndIndex": 4,
          "dstEndWeekDay": 7,
          "dstEndTime": "20:00",
          "mediaChanTotalCallNum": "12"
      }
  }

• 响应参数

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