来自落地电话、呼叫中心等语音和IVR、短信的SDK文档—云通讯平台
座席管理是云通讯平台提供的关于IVR座席的一系列REST API，包括，，，，，，，，，，，，，，，，，，，，，，等23个接口。通过这些REST API能够实现功能全面的座席管理。
创建用户排队的队列，客户可以创建多个不同属性技能的队列，具体属性技能类型由应用侧管理。
/{SoftVersion}/Accounts/{accountSid}/ivr/createqueue
请参阅 ，使用主账户进行验证
应用Id节点
CreateQueue
创建队列主节点
队列类型，定义为正整数(支持最大10位)，具体属性类型的含义由应用侧维护，例如：1英语技能组，2足球技能组，3法语技能组。队列类型与座席类型相一致。默认为0队列。
队列类型描述
队列工作时间，格式：hh:mi-hh:mi。非工作时间不接听电话，为用户播放提示音后挂机，若需设置多个时间段，用分号隔开。
offworkprompt
非工作时间队列提示，填写语音库中上传的语音文件名
offworkdate
非工作日期，默认值为空，格式为 yyyy-mm-dd:yyyy-mm-dd，开始及结束日期以英文冒号隔开。相同时表示为一天。
offworkweekday
每周的非工作时间，默认值为空。若是多天以#分隔，输入值为每日英文缩写，如：Mon、Tue、Wed、Thu、Fri、Sat、Sun
offworktalk
非工作时间是否允许继续外呼坐席通话，0、否 1、是 默认0
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/createqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &CreateQueue queuetype="1" typedes="test" worktime="09:00-18:00" offworkprompt="offworktime.wav" offworkdate=":" offworkweekday="Sun#Sat"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
应用侧删除队列。
/{SoftVersion}/Accounts/{accountSid}/ivr/delqueue
请参阅 ，使用主账户进行验证
应用Id节点
删除队列主节点
队列类型，定义为正整数
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/delqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &DelQueue queuetype="1"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
修改用户排队的队列，queyetype为查询条件不能修改。
/{SoftVersion}/Accounts/{accountSid}/ivr/modifyqueue
请参阅 ，使用主账户进行验证
应用Id节点
ModifyQueue
修改队列主节点
队列类型，定义为正整数，具体属性类型的含义由应用侧维护，例如：1英语技能组，2足球技能组，3法语技能组。队列类型与座席类型相一致。默认为0队列
队列类型描述
队列工作时间，格式：hh:mi-hh:mi。非工作时间不接听电话，为用户播放提示音后挂机，若需设置多个时间段，用分号隔开。
offworkprompt
非工作时间队列提示，填写语音库中上传的语音文件名
offworkdate
非工作日期，默认值为空，格式为 yyyy-mm-dd:yyyy-mm-dd，开始及结束日期以英文冒号隔开。相同时表示为一天。
offworkweekday
每周的非工作时间，默认值为空。若是多天以#分隔，输入值为每日英文缩写，如：Mon、Tue、Wed、Thu、Fri、Sat、Sun
offworktalk
非工作时间是否允许继续外呼坐席通话（取值0或1）
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/modifyqueue?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &ModifyQueue  queuetype="1" typedes="1" worktime="09:00-18:00" offworkprompt="上班时间.wav" offworkdate=":" offworkweekday="Sun#Sat"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
座席在指定队列上班，上班后状态变为准备就绪才可接听电话。支持应用侧重复调用此命令来修改上班的号码。
/{SoftVersion}/Accounts/{accountSid}/ivr/agentonwork
请参阅 ，使用主账户进行验证
应用Id节点
AgentOnWork
座席上班主节点
座席号码，手机号或座机号或VoIP帐号
座席Id，大于0的正整数，建议4位。注意：必须是大于0的正整数，否则上班准备就绪成功后会转接不到该坐席。
座席类型，定义为正整数，与队列类型一致，默认值为0，可以填多个值，使用英文逗号分隔。
agentstate
座席状态：0坐席准备中不能接电话，可以坐席外呼；1坐席准备就绪可以接听来电，也可以坐席外呼； 2坐席锁定中，锁定中是云通讯平台在转接到坐席的时候先对坐席进行锁定操作，以避免其他用户呼入后分配到同一个坐席，不能接听其他来电和坐席外呼；3坐席通话中不能接听其他来电和坐席外呼；4座席线路忙，如果用云通讯的voip为坐席可能是voip不在线或者占线中，如果用落地电话则是在占线中(占线中不是通过云通讯平台的坐席进行呼叫)。默认值为0。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentonwork?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentOnWork  number="" agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
座席从所有队列中下班，座席退出队列，不会再接入用户。
/{SoftVersion}/Accounts/{accountSid}/ivr/agentoffwork
请参阅 ，使用主账户进行验证
应用Id节点
AgentOffWork
座席下班主节点
座席号码，手机号或座机号或VoIP帐号
座席Id，4位正整数
座席服务队列类型，指定下班队列；默认空，下班所有队列。 
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentoffwork?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentOffWork agentid="1000" /&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
将座席状态变为准备就绪或准备中。只有准备就绪座席才可以接听电话。
/{SoftVersion}/Accounts/{accountSid}/ivr/agentready
请参阅 ，使用主账户进行验证
应用Id节点
AgentReady
座席准备就绪主节点
座席Id，4位正整数
的回调url，默认值为空
true表示状态更新为准备就绪，false表示状态更新为准备中，默认值为true
是否优先接听客户电话。false：顺序接听，true：优先接听。默认值为false
是否强制设置状态。默认值为false
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentready?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentReady agentid="1000" state="true" priority="true" force="true"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
征得用户同意后座席可主动结速通话，但用户通话未挂断，应用侧可继续为用户执行后续业务逻辑。若action内容为空则使用中agenthangupurl参数作为回调地址，若都为空则挂断用户电话。
注意：只有当座席和用户在通话中发起请求才有效。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentServiceEnd
座席结束通话主节点
平台侧为每个用户呼叫分配唯一Id
座席Id，4位正整数
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentServiceEnd callid =""  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
通话中座席将用户的呼叫转接到另外一个座席或第三方号码接听。只要agentid或number或queuetype参数有效就会向action发送转接结果的通知。如果转接失败需要应用侧通过此通知对用户的控制权转交进行后续业务处理，否则就会挂机。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
座席呼叫转接主节点
平台侧为每个用户呼叫分配唯一Id
座席Id，4位正整数。agentid和number二者必须有一个不为空，当agentid不为空时number无效。
被转接的电话号码，可以是VoIP号、座机号、手机号。当agentid为空时才有效，当号码无效时则会执行副命令中的命令。
转接队列的类型，定义为正整数，默认值为0
转座席是指接听超时时长；转入队列则是指排队超时时长，单位是秒，默认值为120秒
的回调url地址，默认值为空
的回调url地址，默认值为空
queuetimes
排队次数，从1开始，默认是3
promptvoice
超时提示音，用户按#号键则退出排队
排队超时播放提示音时退出排队的按键内容，默认是#号键，超时未按键表示继续排队
的回调url地址。座席通话默认会录音，默认值空
agenthangupurl
通话过程中的回调url地址，默认值为空，为空时自动挂断用户电话
通话模式，false表示点对点，true表示会议模式。若是点对点模式，则不支持班长监听功能，默认值为true
playanswerprompt
是否为用户播放接通后的提示音。默认值为true
answerprompt
应答后播放的自定义提示音，默认为空，为空则为用户播放平台自定义文件：****工号为您服务。
队列工作时间，格式：hh:mi-hh:mi。非工作时间不接听电话，为用户播放提示音后挂机
offworkdate
非工作日期，默认值为空，格式为 yyyy-mm-dd:yyyy-mm-dd，开始及结束日期以英文冒号隔开。相同时表示为一天。
offworkweekday
每周的非工作时间，默认值为空。若是多天以#分隔，输入值为每日英文缩写，如：Mon、Tue、Wed、Thu、Fri、Sat、Sun
offworkqueue
非工作时间的转移的工作队列
overflowurl
回调url，默认值为空
userhangupurl
回调url，默认值为空
注意：转接的优先顺序是先判断agentid、再判断number、最后判断queuetype，三个参数必须有一个存在。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&   &Appid&&/Appid&          &Transfer callid =""  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
班长监听某个座席人员与用户的通话。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
座席班长监听主节点
平台侧为每个用户呼叫分配唯一Id
座席Id，4位正整数
班长号码，手机号或座机号或VoIP帐号
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &Monitor callid =""  agentid="1000" number=""/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
查询所有座席的工作状态
/{SoftVersion}/Accounts/{accountSid}/ivr/queryagentstate
请参阅 ，使用主账户进行验证
应用Id节点
QueryAgentState
查询座席状态主节点
座席Id,无此属性返回全部座席。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/queryagentstate?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &QueryAgentState agentid='8001'/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
座席列表主节点
座席二级节点
座席Id，4位正整数
座席状态：0准备中 ，1：准备就绪，2：用户锁定，3：咨询通话中
座席号码，手机号或座机号或VoIP帐号
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&&/number&    &/agent&     ...  &/agents&&/Response&
查询队列信息及队列相关设置。
/{SoftVersion}/Accounts/{accountSid}/ivr/queryqueueinfo
请参阅 ，使用主账户进行验证
应用Id节点
QueryQueueInfo
查询座席队列主节点
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/queryqueueinfo?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1 Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&           &QueryQueueInfo/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
队列列表主节点
队列二级节点
队列类型描述
队列工作时间，格式：hh:mi-hh:mi。非工作时间不接听电话，为用户播放提示音后挂机
offworkprompt
非工作时间队列提示，填写语音库中上传的语音文件名
offworkdate
非工作日期，默认值为空，格式为 yyyy-mm-dd:yyyy-mm-dd，开始及结束日期以英文冒号隔开。相同时表示为一天。
offworkweekday
每周的非工作时间，默认值为空。若是多天以#分隔，输入值为每日英文缩写，如：Mon、Tue、Wed、Thu、Fri、Sat、Sun
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&
座席人员主动发起外呼。座席状态只有在准备中、准备就绪、状态下才能进行外呼。
/{SoftVersion}/Accounts/{accountSid}/ivr/agentmakecall
请参阅 ，使用主账户进行验证
AgentMakeCall
座席外呼主节点
外呼号码，手机号或座机号或VoIP账号。
座席Id，4位正整数
外呼操作结果通知的回调地址，默认值为空   
用户方的显号号码，根据平台侧显号规则控制。
的回调url，默认值为空
agenthangupurl
的回调url，默认值为空的回调url默认值为空。为空时自动挂断用户电话。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agentmakecall?sig=155EAA68C5DFB6B762A42D88F406ABCD&queuetype=1 HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentMakeCall agentid="8001" number=""/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
一个由32个字符组成的唯一电话标识符
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&  &callSid&&/callsid&  &/Response&
座席与用户通话过程中可以发送此请求咨询其他座席或电话。
注：此接口不可以与用户静音接口一起使用，坐席咨询默认会将用户端静音，如果调用用户静音会导致无法转接。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentConsult
座席咨询主节点
平台侧为每个用户呼叫分配唯一Id
座席Id，4位正整数，为空则呼叫number参数号码
电话号码或VoIP帐号
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentConsult callid =""  agentid="1000" number=""/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
在后使用，将用户通话转移给被咨询者。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentShift
座席转移呼叫主节点
平台侧为每个用户呼叫分配唯一Id
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentShift callid =""  action="shift"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
在后使用，座席结束咨询，继续与用户进行通话。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentConsultBack
座席咨询返回主节点
平台侧为每个用户呼叫分配唯一Id
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentConsultBack callid=""  action="back"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
后使用，可进行三方通话。　若想退出与用户的通话调用座席结束通话即可。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
TripartiteTalk
三方通话主节点
平台侧为每个用户呼叫分配唯一Id
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &TripartiteTalk callid =""  action="trip"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
将用户静音，听不到座席人员的声音，并为用户播放等待音。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentMuteUser
用户静音主节点
平台侧为每个用户呼叫分配唯一Id
promptvoice
用户听到的等待音，默认值为agentmuteuser.wav
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentMuteUser callid =""  action="mute"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
取消用户静音，座席与用户继续进行通话。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentUnMuteUser
取消用户静音主节点
平台侧为每个用户呼叫分配唯一Id
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentUnMuteUser callid =""  action="unmute"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
用于座席呼叫座席。
/{SoftVersion}/Accounts/{accountSid}/ivr/agent
请参阅 ，使用主账户进行验证
应用Id节点
AgentCallAgent
座席内呼主节点
callagentid
被叫座席Id
发起者座席Id
的回调url，默认值为空
playanswerprompt
true为用户播放接通后的提示音，false则不播放。播放默认提示音 agentid+.wav
answerprompt
应答后播放的自定义提示音，默认为空，则为用户播放自定义的文件：****号客服代表为您服务，该文件需要通过云通讯官网上传进行审核通过后才可使用，文件名用坐席id命名，例如坐席id为8001，则文件名为8001.wav。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/agent?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentCallAgent callagentid ="1001"  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
在后使用，用于班长介入座席与用户的通话。强插后即为三方通话。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentInsert
座席强插主节点
平台侧为每个用户呼叫分配唯一Id
被强插的座席Id，4位正整数
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentInsert callid =""  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
强制挂断某座席通话，在或后使用。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
AgentBreak
座席强拆主节点
平台侧为每个用户呼叫分配唯一Id
被强拆的座席Id，4位正整数
的回调url，默认值为空
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &AgentBreak callid =""  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
用户电话转给座席后，座席未接听时可通过此命令将电话转出，处理逻辑与完全相同。主要可用于座席长时间未接用户通话的处理。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用Id节点
NoAnswerTransfer
座席未应答前转主节点
平台侧为每个用户呼叫分配唯一Id
座席Id，4位正整数
被转接的电话号码，可以是VoIP号、座机号、手机号。
转接队列的类型，定义为正整数，默认值为0
转座席是指接听超时时长；转入队列则是指排队超时时长，单位是秒，默认值为120秒
的回调url地址，默认值为空
的回调url地址，默认值为空
queuetimes
排队次数，从1开始，默认是3
promptvoice
超时提示音，用户按#号键则退出排队
排队超时播放提示音时退出排队的按键内容，默认是#号键，超时未按键表示继续排队
的回调url地址。座席通话默认会录音，默认值空
agenthangupurl
通话过程中的回调url地址，默认值为空，为空时自动挂断用户电话
通话模式，false表示点对点，true表示会议模式。若是点对点模式，则不支持班长监听功能，默认值为true
playanswerprompt
是否为用户播放接通后的提示音。默认值为true
answerprompt
应答后播放的自定义提示音，默认为空，为空则为用户播放平台自定义文件：****工号为您服务。
队列工作时间，格式：hh:mi-hh:mi。非工作时间不接听电话，为用户播放提示音后挂机
offworkdate
非工作日期，默认值为空，格式为 yyyy-mm-dd:yyyy-mm-dd，开始及结束日期以英文冒号隔开。相同时表示为一天。
offworkweekday
每周的非工作时间，默认值为空。若是多天以#分隔，输入值为每日英文缩写，如：Mon、Tue、Wed、Thu、Fri、Sat、Sun
offworkqueue
非工作时间的转移的工作队列
overflowurl
回调url，默认值为空
userhangupurl
回调url，默认值为空
注意：转接的优先顺序是先判断agentid、再判断number、最后判断queuetype，三个参数必须有一个存在。
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&&/Appid&          &NoAnswerTransfer callid =""  agentid="1000"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&
座席与用户通话时，通过此命令可随时获取用户的按键输入。
注：此接口URL上在拼接sig的同时还需拼接callid
/{SoftVersion}/Accounts/{accountSid}/ivr/call?callid={callid}
请参阅 ，使用主账户进行验证
应用id节点
GetUserData
获取用户数据主节点
平台侧为每个用户呼叫分配唯一id；此处为用户侧callid
的回调地址；相对url
datanotifyurl
的回调地址，默认值：/ datanotifyurl；相对url
取值为0:按键输入
当type值为0时有效；*#；默认值为#
当type值为0时有效；按键超时时长，默认值为-1，不超时
POST //Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= HTTP/1.1Accept:application/Host:192.168.0.1:8883content-length: 139Content-Type:application/charset=utf-8;Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= &?xml version='1.0' encoding='utf-8'?&&Request&  &Appid&appid&/Appid&          &GetUserData action="sendoptok" callid="" datanotifyurl="getuserdtmfok" finishkey="#" timeout="20"/&&/Request&
statusCode
请求状态码，取值000000（成功），可参考。
HTTP/1.1 200 OK Content-Length: 641 &?xml version="1.0" encoding="UTF-8" standalone="yes"?&&Response&  &statusCode&000000&/statusCode&&/Response&}