体育万博app下载_manbetx客户端网页版_bet万博网站

座席管理是云通讯平台提供的关于IVR座席的一系列REST API,包括创建队列删除队列修改队列座席上班座席下班座席准备就绪座席结束通话呼叫转接座席班长监听查询座席状态查询队列信息座席外呼座席咨询座席转移呼叫座席咨询返回三方通话用户静音取消用户静音座席内呼座席强插座席强拆座席未应答前转获取用户输入数据等23个接口。通过这些REST API能够实现功能全面的座席管理。

1创建队列

  • 创建用户排队的队列,客户可以创建多个不同属性技能的队列,具体属性技能类型由应用侧管理。
  • 1.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/createqueue
  • 1.2 请求包头

  • 请参阅统一请求包头,使用主账户进行验证
  • 1.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    CreateQueue
    -----
    String
    必选
    创建队列主节点
    queuetype
    String
    必选
    队列类型,定义为正整数(支持最大9位),具体属性类型的含义由应用侧维护,例如:1英语技能组,2足球技能组,3法语技能组。队列类型与座席类型相一致。默认为0队列。
    typedes
    String
    必选
    队列类型描述
    worktime
    String
    可选
    队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机,若需设置多个时间段,用分号隔开。
    offworkprompt
    String
    可选
    非工作时间队列提示,填写语音库中上传的语音文件名
    offworkdate
    String
    可选
    非工作日期,默认值为空,格式为 yyyy-mm-dd:yyyy-mm-dd,开始及结束日期以英文冒号隔开。相同时表示为一天。
    offworkweekday
    String
    可选
    每周的非工作时间,默认值为空。若是多天以#分隔,输入值为每日英文缩写,如:Mon、Tue、Wed、Thu、Fri、Sat、Sun
    offworktalk
    String
    可选
    非工作时间是否允许继续外呼坐席通话,0、否 1、是 默认0

    1.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/createqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <CreateQueue queuetype="1" typedes="test" worktime="09:00-18:00" offworkprompt="offworktime.wav" offworkdate="2014-10-01:2014-10-07" offworkweekday="Sun#Sat"/>
    </Request>

    1.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    1.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    2 删除队列

  • 应用侧删除队列。
  • 2.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/delqueue
  • 2.2 请求包头

  • 请参阅 统一请求包头,使用主账户进行验证
  • 2.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    DelQueue
    -----
    String
    必选
    删除队列主节点
    queuetype
    String
    必选
    队列类型,定义为正整数

    2.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/delqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <DelQueue queuetype="1"/>
    </Request>

    2.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    2.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    3 修改队列

  • 修改用户排队的队列,queyetype为查询条件不能修改。
  • 3.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/modifyqueue
  • 3.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 3.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    ModifyQueue
    -----
    String
    必选
    修改队列主节点
    queuetype
    String
    必选
    队列类型,定义为正整数,具体属性类型的含义由应用侧维护,例如:1英语技能组,2足球技能组,3法语技能组。队列类型与座席类型相一致。默认为0队列
    typedes
    String
    可选
    队列类型描述
    worktime
    String
    可选
    队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机,若需设置多个时间段,用分号隔开。
    offworkprompt
    String
    可选
    非工作时间队列提示,填写语音库中上传的语音文件名
    offworkdate
    String
    可选
    非工作日期,默认值为空,格式为 yyyy-mm-dd:yyyy-mm-dd,开始及结束日期以英文冒号隔开。相同时表示为一天。
    offworkweekday
    String
    可选
    每周的非工作时间,默认值为空。若是多天以#分隔,输入值为每日英文缩写,如:Mon、Tue、Wed、Thu、Fri、Sat、Sun
    offworktalk
    String
    可选
    非工作时间是否允许继续外呼坐席通话(取值0或1)

    3.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/modifyqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <ModifyQueue  queuetype="1" typedes="1" worktime="09:00-18:00" offworkprompt="上班时间.wav" offworkdate="2014-10-01:2014-10-07" offworkweekday="Sun#Sat"/>
    </Request>

    3.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    3.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    4 座席上班

  • 座席在指定队列上班,上班后状态变为准备就绪才可接听电话。支持应用侧重复调用此命令来修改上班的号码。
  • 4.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/agentonwork
  • 4.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证

  • 4.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentOnWork
    -----
    String
    必选
    座席上班主节点
    number
    String
    必选
    座席号码,手机号或座机号或通讯账号
    agentid
    String
    必选
    座席Id,大于0的正整数,建议4位。注意:必须是大于0的正整数,否则上班准备就绪成功后会转接不到该坐席。
    agenttype
    String
    可选
    座席类型,定义为正整数,与队列类型一致,默认值为0,可以填多个值,使用英文逗号分隔。
    agentstate
    String
    可选
    座席状态:0坐席准备中不能接电话,可以坐席外呼;1坐席准备就绪可以接听来电,也可以坐席外呼; 2坐席锁定中,锁定中是云通讯平台在转接到坐席的时候先对坐席进行锁定操作,以避免其他用户呼入后分配到同一个坐席,不能接听其他来电和坐席外呼;3坐席通话中不能接听其他来电和坐席外呼;4座席线路忙,如果用云通讯的通讯账号为坐席可能是通讯账号不在线或者占线中,如果用落地电话则是在占线中(占线中不是通过云通讯平台的坐席进行呼叫)。默认值为0。

    4.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentonwork?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentOnWork  number="13800138000" agentid="1000"/>
    </Request>

    4.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    4.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    5 座席下班

  • 座席从所有队列中下班,座席退出队列,不会再接入用户。
  • 5.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/agentoffwork
  • 5.2 请求包头

  • 请参阅 统一请求包头,使用主账户进行验证
  • 5.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentOffWork
    -----
    String
    必选
    座席下班主节点
    number
    String
    必选
    座席号码,手机号或座机号或通讯账号
    agentid
    String
    必选
    座席Id,4位正整数
    agenttype
    String
    必选
    座席服务队列类型,指定下班队列;默认空,下班所有队列。  

    5.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentoffwork?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentOffWork agentid="1000" />
    </Request>

    5.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    5.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    6 座席准备就绪

  • 将座席状态变为准备就绪或准备中。只有准备就绪座席才可以接听电话。
  • 6.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/agentready
  • 6.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 6.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentReady
    -----
    String
    必选
    座席准备就绪主节点
    agentid
    String
    必选
    座席Id,4位正整数
    action
    String
    可选
    就绪失败的回调url,默认值为空
    state
    String
    可选
    true表示状态更新为准备就绪,false表示状态更新为准备中,默认值为true
    priority
    String
    可选
    是否优先接听客户电话。false:顺序接听,true:优先接听。默认值为false
    force
    String
    可选
    是否强制设置状态。默认值为false;设置为true时,不会发送状态改变通知。此参数主要用于非正常流程使用,普通操作不建议使用。

    6.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentready?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentReady agentid="1000" state="true" priority="true" force="true"/>
    </Request>

    6.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    6.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    7 座席结束通话

  • 征得用户同意后座席可主动结速通话,但用户通话未挂断,应用侧可继续为用户执行后续业务逻辑。若action内容为空则使用进入排队系统命令中agenthangupurl参数作为回调地址,若都为空则挂断用户电话。

  • 注意:只有当座席和用户在通话中发起请求才有效。
  • 7.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 7.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 7.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentServiceEnd
    -----
    String
    必选
    座席结束通话主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    座席Id,4位正整数
    action
    String
    可选
    结束成功的回调url,默认值为空

    7.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentServiceEnd callid ="13421304281638380000100"  agentid="1000"/>
    </Request>

    7.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    7.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    8 座席呼叫转接

  • 通话中座席将用户的呼叫转接到另外一个座席或第三方号码接听。只要agentid或number或queuetype参数有效就会向action发送转接结果的通知。如果转接失败需要应用侧通过此通知对用户的控制权转交进行后续业务处理,否则就会挂机。
  • 8.1 请求地址

  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 8.2 请求包头

  • 请参阅 统一请求包头,使用主账户进行验证
  • 8.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    Transfer
    -----
    String
    必选
    座席呼叫转接主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    可选
    座席Id,4位正整数。agentid和number二者必须有一个不为空,当agentid不为空时number无效。
    number
    String
    可选
    被转接的电话号码,可以是通讯账号、座机号、手机号。当agentid为空时才有效,当号码无效时则会执行副命令中的呼转命令。
    queuetype
    String
    必选
    转接队列的类型,定义为正整数,默认值为0
    action
    String
    可选
    转接结果通知的回调url
    timeout
    String
    可选
    转座席是指接听超时时长;转入队列则是指排队超时时长,单位是秒,默认值为120秒
    enterurl
    String
    可选
    用户进入排队成功通知的回调url地址,默认值为空
    quiturl
    String
    可选
    退出队列通知的回调url地址,默认值为空
    queuetimes
    String
    可选
    排队次数,从1开始,默认是3
    promptvoice
    String
    可选
    超时提示音,用户按#号键则退出排队
    finishkey
    String
    可选
    排队超时播放提示音时退出排队的按键内容,默认是#号键,超时未按键表示继续排队
    recordurl
    String
    可选
    录音完成通知的回调url地址。座席通话默认会录音,默认值空
    agenthangupurl
    String
    可选
    通话过程中座席侧挂断电话通知的回调url地址,默认值为空,为空时自动挂断用户电话
    talkmod
    String
    可选
    通话模式,false表示点对点,true表示会议模式。若是点对点模式,则不支持班长监听功能,默认值为true
    playanswerprompt
    String
    可选
    是否为用户播放接通后的提示音。默认值为true
    answerprompt
    String
    可选
    应答后播放的自定义提示音,默认为空,为空则为用户播放平台自定义文件:****工号为您服务。
    worktime
    String
    可选
    队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机
    offworkdate
    String
    可选
    非工作日期,默认值为空,格式为 yyyy-mm-dd:yyyy-mm-dd,开始及结束日期以英文冒号隔开。相同时表示为一天。
    offworkweekday
    String
    可选
    每周的非工作时间,默认值为空。若是多天以#分隔,输入值为每日英文缩写,如:Mon、Tue、Wed、Thu、Fri、Sat、Sun
    offworkqueue
    String
    可选
    非工作时间的转移的工作队列
    overflowurl
    String
    可选
    队列溢出通知回调url,默认值为空
    userhangupurl
    String
    可选
    用户挂机通知回调url,默认值为空

  • 注意:转接的优先顺序是先判断agentid、再判断number、最后判断queuetype,三个参数必须有一个存在。
  • 8.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request> 
      <Appid>12591111</Appid>        
      <Transfer callid ="13421304281638380000100"  agentid="1000"/>
    </Request>

    8.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    8.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    9 座席班长监听

  • 班长监听某个座席人员与用户的通话。
  • 9.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 9.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 9.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    Monitor
    -----
    String
    必选
    座席班长监听主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    座席Id,4位正整数
    number
    String
    必选
    班长号码,手机号或座机号或通讯账号
    action
    String
    可选
    监听结果通知的回调url
    notifyurl
    String
    可选

    9.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <Monitor callid ="13421304281638380000100"  agentid="1000" number="13800138000"/>
    </Request>

    9.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    9.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    10 查询座席状态

  • 查询所有座席的工作状态
  • 10.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/queryagentstate
  • 10.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 10.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    QueryAgentState
    -----
    String
    必选
    查询座席状态主节点
    agentid
    String
    可选
    座席Id,无此属性返回全部座席。

    10.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/queryagentstate?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <QueryAgentState agentid='8001'/>
    </Request>

    10.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码
    agents
    String
    必选
    座席列表主节点
    agent
    String
    必选
    座席二级节点
    id
    String
    必选
    座席Id,4位正整数
    state
    String
    必选
    座席状态:0准备中 ,1:准备就绪,2:用户锁定,3:咨询通话中
    number
    String
    必选
    座席号码,手机号或座机号或通讯账号

    10.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
      <agents>
        <agent>
         <id>1000</id>
         <state>1</state>
         <number>123456789</number>
        </agent>
         ...
      </agents>
    </Response>

    11 查询队列信息

  • 查询队列信息及队列相关设置。
  • 11.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/queryqueueinfo
  • 11.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 11.3 请求包体

    属性
    类型
    约束
    说明
    Appid
    String
    必选
    应用Id节点
    QueryQueueInfo
    String
    必选
    查询座席队列主节点

    11.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/queryqueueinfo?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1 
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>         
      <QueryQueueInfo/>
    </Request>

    11.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码
    queues
    String
    必选
    队列列表主节点
    queue
    String
    必选
    队列二级节点
    type
    String
    必选
    队列类型
    typedes
    String
    可选
    队列类型描述
    worktime
    String
    可选
    队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机
    offworkprompt
    String
    可选
    非工作时间队列提示,填写语音库中上传的语音文件名
    offworkdate
    String
    可选
    非工作日期,默认值为空,格式为 yyyy-mm-dd:yyyy-mm-dd,开始及结束日期以英文冒号隔开。相同时表示为一天。
    offworkweekday
    String
    可选
    每周的非工作时间,默认值为空。若是多天以#分隔,输入值为每日英文缩写,如:Mon、Tue、Wed、Thu、Fri、Sat、Sun

    11.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
      <queues>
        <queue>
         <type>1</type>
         <typedes>描述</typedes>
         <count>12</count>
        </queue>
         ...
      </queues>
    </Response>

    12 座席外呼

  • 座席人员主动发起外呼。座席状态只有在准备中、准备就绪、状态下才能进行外呼。
  • 12.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/agentmakecall
  • 12.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 12.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id
    AgentMakeCall
    -----
    String
    必选
    座席外呼主节点
    number
    String
    必选
    外呼号码,手机号或座机号或通讯账号。
    agentid
    String
    必选
    座席Id,4位正整数
    action
    String
    可选
    外呼操作结果通知的回调地址,默认值为空    
    disnumber
    String
    可选
    用户方的显号号码,根据平台侧显号规则控制。
    answerurl
    String
    可选
    用户应答通知的回调url,默认值为空
    agenthangupurl
    String
    可选
    通话过程中座席与用户通话结束通知的回调url,默认值为空的回调url默认值为空。为空时自动挂断用户电话。

    12.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentmakecall?sig=155EAA68C5DFB6B762A42D88F406ABCD&queuetype=1 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentMakeCall agentid="8001" number="13800138000"/>
    </Request>

    12.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码
    callSid
    string
    必选
    一个由32个字符组成的唯一电话标识符

    12.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
      <callSid>12345678909876543211234</callsid>  
    </Response>

    13 座席咨询

  • 座席与用户通话过程中可以发送此请求咨询其他座席或电话。
  • 注:此接口不可以与用户静音接口一起使用,坐席咨询默认会将用户端静音,如果调用用户静音会导致无法转接。
  • 13.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 13.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 13.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentConsult
    -----
    String
    必选
    座席咨询主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    座席Id,4位正整数,为空则呼叫number参数号码
    number
    String
    必选
    电话号码或通讯账号
    action
    String
    可选
    咨询操作结果通知的回调url,默认值为空

    13.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentConsult callid ="13421304281638380000100"  agentid="1000" number="13812345678"/>
    </Request>

    13.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    13.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    14 座席转移呼叫

  • 座席咨询后使用,将用户通话转移给被咨询者。
  • 14.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 14.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 14.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentShift
    -----
    String
    必选
    座席转移呼叫主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    action
    String
    可选
    呼叫转移操作结果通知的回调url,默认值为空

    14.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentShift callid ="13421304281638380000100"  action="shift"/>
    </Request>

    14.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    14.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    15 座席咨询返回

  • 座席咨询后使用,座席结束咨询,继续与用户进行通话。
  • 15.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 15.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 15.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentConsultBack
    -----
    String
    必选
    座席咨询返回主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    action
    String
    可选
    座席咨询返回结果通知的回调url,默认值为空

    15.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentConsultBack callid="13421304281638380000100"  action="back"/>
    </Request>

    15.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    15.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    16 三方通话

  • 座席咨询后使用,可进行三方通话。 若想退出与用户的通话调用座席结束通话即可。
  • 16.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 16.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 16.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    TripartiteTalk
    -----
    String
    必选
    三方通话主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    action
    String
    可选
    三方通话操作结果通知的回调url,默认值为空

    16.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <TripartiteTalk callid ="13421304281638380000100"  action="trip"/>
    </Request>

    16.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    16.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    17 用户静音

  • 将用户静音,听不到座席人员的声音,并为用户播放等待音。
  • 17.1 请求地址

  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 17.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 17.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentMuteUser
    -----
    String
    必选
    用户静音主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    promptvoice
    String
    可选
    用户听到的等待音,默认值为agentmuteuser.wav
    action
    String
    可选
    操作结果通知的回调url,默认值为空

    17.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentMuteUser callid ="13421304281638380000100"  action="mute"/>
    </Request>

    17.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    17.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    18 取消用户静音

  • 取消用户静音,座席与用户继续进行通话。
  • 18.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 18.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 18.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentUnMuteUser
    -----
    String
    必选
    取消用户静音主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    action
    String
    可选
    操作结果通知的回调url,默认值为空

    18.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentUnMuteUser callid ="13421304281638380000100"  action="unmute"/>
    </Request>

    18.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    18.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    19 座席内呼

  • 用于座席呼叫座席。
  • 19.1 请求地址

  • /{SoftVersion}/Accounts/{accountSid}/ivr/agent
  • 19.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 19.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentCallAgent
    -----
    String
    必选
    座席内呼主节点
    callagentid
    String
    必选
    被叫座席Id
    agentid
    String
    必选
    发起者座席Id
    action
    String
    可选
    操作结果通知的回调url,默认值为空
    playanswerprompt
    String
    可选
    true为用户播放接通后的提示音,false则不播放。播放默认提示音 agentid+.wav
    answerprompt
    String
    可选
    应答后播放的自定义提示音,默认为空,则为用户播放自定义的文件:****号客服代表为您服务,该文件需要通过云通讯官网上传进行审核通过后才可使用,文件名用坐席id命名,例如坐席id为8001,则文件名为8001.wav。

    19.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agent?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentCallAgent callagentid ="1001"  agentid="1000"/>
    </Request>

    19.5 响应包体

    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    19.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    20 座席强插

  • 座席班长监听后使用,用于班长介入座席与用户的通话,强插其他座席加入通话。强插后即为三方通话。
  • 20.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 20.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 20.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentInsert
    -----
    String
    必选
    座席强插主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    被强插的座席Id,4位正整数
    action
    String
    可选
    操作结果通知的回调url,默认值为空

    20.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentInsert callid ="13421304281638380000100"  agentid="1000"/>
    </Request>

    20.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    20.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    21 座席强拆

  • 强制挂断某座席通话,在座席强插三方通话后使用。
  • 21.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 21.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 21.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    AgentBreak
    -----
    String
    必选
    座席强拆主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    被强拆的座席Id,4位正整数
    action
    String
    可选
    操作结果通知的回调url,默认值为空

    21.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <AgentBreak callid ="13421304281638380000100"  agentid="1000"/>
    </Request>

    21.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    21.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    22 座席未应答前转

  • 用户电话转给座席后,座席未接听时可通过此命令将电话转出,处理逻辑与座席呼叫转接完全相同。主要可用于座席长时间未接用户通话的处理。
  • 22.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 22.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 22.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用Id节点
    NoAnswerTransfer
    -----
    String
    必选
    座席未应答前转主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一Id
    agentid
    String
    必选
    座席Id,4位正整数
    number
    String
    必选
    被转接的电话号码,可以是通讯账号、座机号、手机号。
    queuetype
    String
    必选
    转接队列的类型,定义为正整数,默认值为0
    action
    String
    可选
    转接结果通知的回调url
    timeout
    String
    可选
    转座席是指接听超时时长;转入队列则是指排队超时时长,单位是秒,默认值为120秒
    enterurl
    String
    可选
    用户进入排队成功通知的回调url地址,默认值为空
    quiturl
    String
    可选
    退出队列通知的回调url地址,默认值为空
    queuetimes
    String
    可选
    排队次数,从1开始,默认是3
    promptvoice
    String
    可选
    超时提示音,用户按#号键则退出排队
    finishkey
    String
    可选
    排队超时播放提示音时退出排队的按键内容,默认是#号键,超时未按键表示继续排队
    recordurl
    String
    可选
    录音完成通知的回调url地址。座席通话默认会录音,默认值空
    agenthangupurl
    String
    可选
    通话过程中座席侧挂断电话通知的回调url地址,默认值为空,为空时自动挂断用户电话
    talkmod
    String
    可选
    通话模式,false表示点对点,true表示会议模式。若是点对点模式,则不支持班长监听功能,默认值为true
    playanswerprompt
    String
    可选
    是否为用户播放接通后的提示音。默认值为true
    answerprompt
    String
    可选
    应答后播放的自定义提示音,默认为空,为空则为用户播放平台自定义文件:****工号为您服务。
    worktime
    String
    可选
    队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机
    offworkdate
    String
    可选
    非工作日期,默认值为空,格式为 yyyy-mm-dd:yyyy-mm-dd,开始及结束日期以英文冒号隔开。相同时表示为一天。
    offworkweekday
    String
    可选
    每周的非工作时间,默认值为空。若是多天以#分隔,输入值为每日英文缩写,如:Mon、Tue、Wed、Thu、Fri、Sat、Sun
    offworkqueue
    String
    可选
    非工作时间的转移的工作队列
    overflowurl
    String
    可选
    队列溢出通知回调url,默认值为空
    userhangupurl
    String
    可选
    用户挂机通知回调url,默认值为空

  • 注意:转接的优先顺序是先判断agentid、再判断number、最后判断queuetype,三个参数必须有一个存在。
  • 22.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304281638380000100 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>12591111</Appid>        
      <NoAnswerTransfer callid ="13421304281638380000100"  agentid="1000"/>
    </Request>

    22.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    22.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>

    23 获取用户输入数据

  • 座席与用户通话时,通过此命令可随时获取用户的按键输入。
  • 23.1 请求地址


  • 注:此接口URL上在拼接sig的同时还需拼接callid

  • /{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
  • 23.2 请求包头


  • 请参阅 统一请求包头,使用主账户进行验证
  • 23.3 请求包体

    节点
    属性
    类型
    约束
    说明
    Appid
    -----
    String
    必选
    应用id节点
    GetUserData
    -----
    String
    必选
    获取用户数据主节点
    callid
    String
    必选
    平台侧为每个用户呼叫分配唯一id;此处为用户侧callid
    action
    String
    必选
    操作结果通知的回调地址;相对url
    datanotifyurl
    String
    必选
    用户输入数据通知的回调地址,默认值:/ datanotifyurl;相对url
    type
    String
    可选
    取值为0:按键输入
    finishkey
    String
    可选
    当type值为0时有效;0123456789*#;默认值为#
    timeout
    String
    可选
    当type值为0时有效;按键超时时长,默认值为-1,不超时

    23.4 请求示例

    POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid=13421304000100000001 HTTP/1.1
    Accept:application/xml;
    Host:192.168.0.1:8883
    content-length: 139
    Content-Type:application/xml;charset=utf-8;
    Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
     
    <?xml version='1.0' encoding='utf-8'?>
    <Request>
      <Appid>appid</Appid>        
      <GetUserData action="sendoptok" callid="13421304000100000001" datanotifyurl="getuserdtmfok" finishkey="#" timeout="20"/>
    </Request>

    23.5 响应包体

    属性
    类型
    约束
    说明
    statusCode
    String
    必选
    请求状态码,取值000000(成功),可参考Rest 错误代码

    23.6 响应示例

    HTTP/1.1 200 OK 
    Content-Length: 641 

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Response>
      <statusCode>000000</statusCode>
    </Response>