1、座席功能IVR命令
應(yīng)用服務(wù)器側(cè)向云通訊平臺(tái)發(fā)送的命令，包括進(jìn)入進(jìn)入排隊(duì)系統(tǒng)、座席準(zhǔn)備就緒。
1.1 進(jìn)入排隊(duì)系統(tǒng)
讓用戶進(jìn)到排隊(duì)系統(tǒng)，嵌套的<Play>命令是用戶在進(jìn)到隊(duì)列后播放的等待音，若進(jìn)入隊(duì)列呼叫座席失敗則執(zhí)行后續(xù)副命令中的呼轉(zhuǎn)命令。命令名稱<EnterCCS>
屬性
| 名稱 |
屬性值 |
默認(rèn)值 |
說(shuō)明 |
|---|---|---|---|
| action |
相對(duì)url |
空 |
若用戶進(jìn)入隊(duì)列成功后排隊(duì)的回調(diào)url，當(dāng)用戶有空座席接聽則不回調(diào)，后續(xù)命令也不再執(zhí)行，若進(jìn)入隊(duì)列失敗則執(zhí)行后續(xù)副命令中的呼轉(zhuǎn)命令。 |
| method |
GET、POST |
POST |
請(qǐng)求方法。 |
| queuetype |
正整數(shù) |
0 |
進(jìn)入隊(duì)列的類型。 |
| timeout |
正整數(shù) |
60秒 |
排隊(duì)超時(shí)時(shí)長(zhǎng)。 |
| queuetimes |
正整數(shù)，大于0 |
3 |
排隊(duì)次數(shù)。到達(dá)最大排隊(duì)次數(shù)后自動(dòng)退出排隊(duì)，當(dāng)quiturl不為空，會(huì)執(zhí)行用戶退出排隊(duì)。 |
| promptvoice |
語(yǔ)音文件名 |
queuetimeoutprompt.wav |
超時(shí)提示音，用戶按#號(hào)鍵則退出排隊(duì)。 |
| quiturl | 相對(duì)url |
空 |
當(dāng)用戶選擇退出排隊(duì)時(shí)發(fā)送請(qǐng)求的URL。 |
| callid |
十六進(jìn)制串 |
必填 |
平臺(tái)側(cè)為每個(gè)用戶呼叫分配唯一id |
| finishkey | 數(shù)字、#、* | # |
排隊(duì)超時(shí)播放提示音時(shí)退出排隊(duì)的按鍵內(nèi)容，超時(shí)未按鍵表示繼續(xù)排隊(duì)，符合按鍵的時(shí)候退出排隊(duì)，當(dāng)quiturl不為空，會(huì)執(zhí)行用戶退出排隊(duì)。 |
| recordurl | 相對(duì)url | 空 |
錄音完成通知的回調(diào)地址。座席通話默認(rèn)會(huì)錄音。 |
| agenthangupurl | 相對(duì)url |
空 |
座席結(jié)束通話通知的回調(diào)url。為空時(shí)自動(dòng)掛斷用戶電話。 |
| talkmod | true or false | true | 通話模式，false表示點(diǎn)對(duì)點(diǎn)，true表示會(huì)議模式。若是點(diǎn)對(duì)點(diǎn)模式，則不支持班長(zhǎng)監(jiān)聽功能。 |
| playanswerprompt | true or false | true | true為用戶播放接通后的提示音，提示音文件必須上傳審核，false則不播放。 |
| answerprompt |
語(yǔ)音文件名 |
空 |
應(yīng)答后播放的自定義提示音，默認(rèn)為空，則為用戶播放自定義的文件：****號(hào)客服代表為您服務(wù)，該文件需要通過(guò)云通訊官網(wǎng)上傳進(jìn)行審核通過(guò)后才可使用，文件名用坐席id命名，例如坐席id為8001，則文件名為8001.wav。 |
| playdefaultpromp | true or false | false | 是否播放自定義文件名前播放平臺(tái)標(biāo)準(zhǔn)提示語(yǔ)；默認(rèn)為false，不播放。 |
| worktime |
時(shí)間時(shí)分 |
空 |
隊(duì)列工作時(shí)間，格式：hh:mi-hh:mi。非工作時(shí)間不接聽電話，為用戶播放提示音后掛機(jī)。空則不限制工作時(shí)間。若創(chuàng)建隊(duì)列與進(jìn)入隊(duì)列同時(shí)設(shè)置此參數(shù)，則以創(chuàng)建隊(duì)列為主。 |
| offworkdate |
日期年月日 |
空 |
非工作日期，格式為:yyyy-mm-dd:yyyy-mm-dd。空則不限制工作日志。 |
| offworkweekday |
Mon、Tue、Wed、Thu、Fri、Sat、Sun |
空 | 每周的非工作時(shí)間，若是多天以#分隔?？談t不限制工作時(shí)間。 |
| offworkqueue |
正整數(shù) |
0 | 非工作時(shí)間的轉(zhuǎn)移的工作隊(duì)列。 |
| overflowurl |
相對(duì)url |
空 |
隊(duì)列溢出通知回調(diào)url。 |
| agentid | 正整數(shù)，推薦4位 | 空 | 座席Id，若指定坐席有效且空閑則此座席會(huì)優(yōu)先接聽，否則執(zhí)行轉(zhuǎn)接給queuetype中的空閑坐席。當(dāng)此參數(shù)有效時(shí)座席狀態(tài)通知中的queuetype值忽略，為云通訊平臺(tái)的默認(rèn)值0(因?yàn)樵撟赡苌习嗟絻蓚€(gè)隊(duì)列中云通訊無(wú)法判斷返回哪個(gè)隊(duì)列值所以統(tǒng)一默認(rèn)值0)。 |
| userhangupurl | 相對(duì)url | 空 | 用戶掛機(jī)通知，如設(shè)置此參數(shù)用戶掛機(jī)后平臺(tái)不會(huì)主動(dòng)將坐席掛斷，如需掛斷需響應(yīng)hangup來(lái)掛斷坐席（坐席的callid在stopservice通知中返回）。 |
嵌套規(guī)則
只能嵌套<Play>命令，進(jìn)入隊(duì)列后播放的等待音。
示例
<?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>
1.2 座席準(zhǔn)備就緒
座席準(zhǔn)備就緒命令，將座席狀態(tài)變?yōu)闇?zhǔn)備就緒或準(zhǔn)備中，只有準(zhǔn)備就緒座席才可以接聽電話，不需要副命令。命令名稱<AgentReady>。
屬性
| 名稱 |
屬性值 |
默認(rèn)值 |
說(shuō)明 |
|---|---|---|---|
| action |
相對(duì)url |
空 |
就緒失敗的回調(diào)url，修改成功會(huì)發(fā)送座席狀態(tài)通知請(qǐng)求。 |
| state | true or false | true | true表示狀更新為準(zhǔn)備就緒，false表示狀態(tài)更新為準(zhǔn)備中。 |
| agentid |
4位正整數(shù) |
無(wú) |
座席ID，4位正整數(shù)，由應(yīng)用側(cè)管理。 |
| priority | true or false | false | true表示優(yōu)先接聽客戶電話，false表示順序接聽。 |
| force | true or false | false | true表示強(qiáng)制就緒，false表示不?強(qiáng)制就緒。 |
| Appid | 字符串 | 無(wú) | 應(yīng)用id，元素節(jié)點(diǎn)。 |
嵌套規(guī)則
不可嵌套。
示例
<?xml version="1.0" encoding="UTF-8"?> <Response> <Appid>a346467ca321c71dbd5e12f627123456</Appid> <AgentReady agentid="8001"/> </Response>