应用服务器侧向云通讯平台发送的命令,包括进入进入排队系统、座席准备就绪。
让用户进到排队系统,嵌套的<Play>命令是用户在进到队列后播放的等待音,若进入队列呼叫座席失败则执行后续副命令中的呼转命令。命令名称<EnterCCS>
属性
名称 |
属性值 |
默认值 |
说明 |
---|---|---|---|
action |
相对url |
空 |
若用户进入队列成功后排队的回调url,当用户有空座席接听则不回调,后续命令也不再执行,若进入队列失败则执行后续副命令中的呼转命令。 |
method |
GET、POST |
POST |
请求方法。 |
queuetype |
正整数 |
0 |
进入队列的类型。 |
timeout |
正整数 |
60秒 |
排队超时时长。 |
queuetimes |
正整数,大于0 |
3 |
排队次数。到达最大排队次数后自动退出排队,当quiturl不为空,会执行用户退出排队。 |
promptvoice |
语音文件名 |
queuetimeoutprompt.wav |
超时提示音,用户按#号键则退出排队。 |
quiturl | 相对url |
空 |
当用户选择退出排队时发送请求的URL。 |
callid |
十六进制串 |
必填 |
平台侧为每个用户呼叫分配唯一id |
finishkey | 数字、#、* | # |
排队超时播放提示音时退出排队的按键内容,超时未按键表示继续排队,符合按键的时候退出排队,当quiturl不为空,会执行用户退出排队。 |
recordurl | 相对url | 空 |
录音完成通知的回调地址。座席通话默认会录音。 |
agenthangupurl | 相对url |
空 |
座席结束通话通知的回调url。为空时自动挂断用户电话。 |
talkmod | true or false | true | 通话模式,false表示点对点,true表示会议模式。若是点对点模式,则不支持班长监听功能。 |
playanswerprompt | true or false | true | true为用户播放接通后的提示音,提示音文件必须上传审核,false则不播放。 |
answerprompt |
语音文件名 |
空 |
应答后播放的自定义提示音,默认为空,则为用户播放自定义的文件:****号客服代表为您服务,该文件需要通过云通讯官网上传进行审核通过后才可使用,文件名用坐席id命名,例如坐席id为8001,则文件名为8001.wav。 |
playdefaultpromp | true or false | false | 是否播放自定义文件名前播放平台标准提示语;默认为false,不播放。 |
worktime |
时间时分 |
空 |
队列工作时间,格式:hh:mi-hh:mi。非工作时间不接听电话,为用户播放提示音后挂机。空则不限制工作时间。若创建队列与进入队列同时设置此参数,则以创建队列为主。 |
offworkdate |
日期年月日 |
空 |
非工作日期,格式为:yyyy-mm-dd:yyyy-mm-dd。空则不限制工作日志。 |
offworkweekday |
Mon、Tue、Wed、Thu、Fri、Sat、Sun |
空 | 每周的非工作时间,若是多天以#分隔。空则不限制工作时间。 |
offworkqueue |
正整数 |
0 | 非工作时间的转移的工作队列。 |
overflowurl |
相对url |
空 |
队列溢出通知回调url。 |
agentid | 正整数,推荐4位 | 空 | 座席Id,若指定坐席有效且空闲则此座席会优先接听,否则执行转接给queuetype中的空闲坐席。当此参数有效时座席状态通知中的queuetype值忽略,为云通讯平台的默认值0(因为该坐席可能上班到两个队列中云通讯无法判断返回哪个队列值所以统一默认值0)。 |
userhangupurl | 相对url | 空 | 用户挂机通知,如设置此参数用户挂机后平台不会主动将坐席挂断,如需挂断需响应hangup来挂断坐席(坐席的callid在stopservice通知中返回)。 |
嵌套规则
只能嵌套<Play>命令,进入队列后播放的等待音。
示例
<?xml version="1.0" encoding="UTF-8"?> <Response> <EnterCCS queuetype="1" agenthangupurl="satisfaction_survey" timeout="5" quiturl="timeout_quit"> <Play>waitmusic.wav</Play> </EnterCCS> <Redirect>transferAgentFail</Redirect> </Response>
座席准备就绪命令,将座席状态变为准备就绪或准备中,只有准备就绪座席才可以接听电话,不需要副命令。命令名称<AgentReady>。
属性
名称 |
属性值 |
默认值 |
说明 |
---|---|---|---|
action |
相对url |
空 |
就绪失败的回调url,修改成功会发送座席状态通知请求。 |
state | true or false | true | true表示状更新为准备就绪,false表示状态更新为准备中。 |
agentid |
4位正整数 |
无 |
座席ID,4位正整数,由应用侧管理。 |
priority | true or false | false | true表示优先接听客户电话,false表示顺序接听。 |
force | true or false | false | true表示强制就绪,false表示不强制就绪。 |
Appid | 字符串 | 无 | 应用id,元素节点。 |
嵌套规则
不可嵌套。
示例
<?xml version="1.0" encoding="UTF-8"?> <Response> <Appid>a346467ca321c71dbd5e12f627123456</Appid> <AgentReady agentid="8001"/> </Response>