1、座席功能IVR命令
應用服務器側向云通訊平臺發送的命令，包括進入進入排隊系統、座席準備就緒。
1.1 進入排隊系統
讓用戶進到排隊系統，嵌套的<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>
1.2 座席準備就緒
座席準備就緒命令，將座席狀態變為準備就緒或準備中，只有準備就緒座席才可以接聽電話，不需要副命令。命令名稱<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>