1、座席功能通知消息
云通訊平臺向應(yīng)用服務(wù)器側(cè)發(fā)送的請求通知，包括座席狀態(tài)通知、座席操作結(jié)果通知、用戶進入排隊成功通知、用戶退出排隊通知、座席與用戶通話結(jié)束通知、用戶與座席通話結(jié)束后的錄音完成通知、座席外呼用戶應(yīng)答通知、隊列排隊人數(shù)溢出通知、班長監(jiān)聽結(jié)束通知、座席外呼用戶振鈴?fù)ㄖ⒂脩糨斎霐?shù)據(jù)通知、獲取用戶信息通知等。
1.1 座席狀態(tài)通知
當座席的狀態(tài)發(fā)生變化后，云平臺會向應(yīng)用服務(wù)器側(cè)發(fā)送此請求消息，其中“agentstate”相對url地址段是固定內(nèi)容不可變。
請求地址
POST /agentstate?appid={appid}&callid={callid}&agentid={agentid}&agentstate={agentstate}&number={number}&time={time}&queuetype={queuetype}&alertingtime={alertingtime}&isqueue={isqueue} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| agentid |
整數(shù) |
座席ID，4位正整數(shù)，由應(yīng)用側(cè)管理。 |
| agentstate |
整數(shù) |
座席狀態(tài)：0坐席準備中不能接電話 ；1坐席準備就緒可以接聽來電； 2坐席鎖定中，鎖定中是云通訊平臺在轉(zhuǎn)接到坐席的時候先對坐席進行鎖定操作，以避免其他用戶呼入后分配到同一個坐席； 3坐席通話中不能接聽其他來電；4座席線路忙，如果用云通訊的網(wǎng)絡(luò)坐席可能是坐席不在線或者占線中，如果用落地電話則是在占線中(占線中不是通過云通訊平臺的坐席進行呼叫)。默認值為0。</span> |
| callid |
字符串 |
用戶呼叫id，當座席狀態(tài)agentstate為2、3、由3變?yōu)?時，此值不為空。默認值為空。 |
| time |
字符串 |
狀態(tài)切換時間，yyyymmddHHmiss。 |
| queuetype | 整數(shù) | 用戶排隊類型，當agentstate變?yōu)?、3時此值有效。只有呼入進入排隊制定隊列時為有效值，坐席外呼和進入排隊制定坐席時無效為默認值0。 |
| number | 整數(shù) | 與座席通話的用戶號碼，當狀態(tài)為2、3時值有效。 |
| appid | 字符串 | 應(yīng)用id。 |
| alertingtime | 日期串 | 座席振鈴時間，格式y(tǒng)yyymmddHHmiss，agentstate值為3時此參數(shù)有效 |
| isqueue |
0、1 |
是否有排隊，agentstate值為2時此參數(shù)有效；0表示未排隊、1表示有排隊 |
請求回復(fù)
可回復(fù)空指令。當座席狀態(tài)為“準備中”時，AS側(cè)可根據(jù)實際設(shè)置座席狀態(tài)自動切換為“準備就緒”，此時可復(fù)座席準備就緒命令，讓座席立刻進入準備接電話的狀態(tài)中。
1.2 座席操作結(jié)果通知
云平臺會向應(yīng)用服務(wù)器側(cè)發(fā)送此請求消息，包括班長監(jiān)聽、呼叫轉(zhuǎn)接、準備就緒、座席結(jié)束通話等操作通知。
請求地址
POST /<customurl>?appid={appid}&agentid={agentid}&type={type}&reason={reason}&time={time} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| agentid |
整數(shù) |
座席ID，4位正整數(shù)。 |
| type |
整數(shù) |
操作類型1班長監(jiān)聽、2呼叫轉(zhuǎn)接、3準備就緒、4座席咨詢、5呼叫轉(zhuǎn)移、6咨詢反回、7三方通話、8用戶靜音操作、9取消靜音操作、10 座席主動外呼、11座席內(nèi)呼、12|強插、13強拆、14 獲取用戶數(shù)據(jù)。 |
| result | 整數(shù) |
0表示成功，其它值則失敗。 |
| callid | 十六進制串 | 用戶的callid。 |
| appid |
字符串 |
應(yīng)用id。 |
| time | 字符串 | 操作時間；type值為1、2、4、5、6、7、8、9、10、11、12、13時有效。 |
請求回復(fù)
回復(fù)空指令。
1.3 用戶進入排隊成功通知
座席呼叫轉(zhuǎn)接時用戶進入排隊隊列的通知請求。URL中“<customurl>”可通過<Transfer>命令中的enterurl屬性自定義
請求地址
POST /<customurl>?appid={appid}&callid={callid}&queuetype={queuetype}&count={count}&entertime={entertime} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| queuetype |
整數(shù) |
用戶進入的隊列類型。 |
| count |
整數(shù) |
進入后當前隊列的排隊人數(shù)。 |
| entertime |
字符串 |
進入隊列的時間,yyyymmddHHmiss。 |
| appid |
必須 |
應(yīng)用id |
請求回復(fù)
回復(fù)空指令。
1.4 用戶退出排隊通知
座席呼叫轉(zhuǎn)接當排隊超時用戶選擇退出隊列時發(fā)送此請求消息。URL中“<customurl>”可通過<Transfer>命令中的quiturl屬性自定義
請求地址
POST /<quitccs>?appid={appid}&callid={callid}&type={type}&queuetype={queuetype}&count={count}&quittime={quittime} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| type |
整數(shù) |
退出排隊類型：0超時主動退出 1達到最大排隊次數(shù)強制退出 2用戶掛機退出 3用戶轉(zhuǎn)接坐席正常退出 |
| queuetype |
整數(shù) |
退出隊列的類型。 |
| count |
整數(shù) |
退出后隊列當前的排隊人數(shù)。 |
| quittime |
字符串 |
退出隊列的時間，yyyymmddHHmiss |
| appid |
必須 |
應(yīng)用id |
請求回復(fù)
可回復(fù)其它IVR命令，進入相關(guān)的業(yè)務(wù)邏輯。
1.5 座席與用戶通話結(jié)束通知
當調(diào)用座席結(jié)束通話命令或座席或用戶掛機，云平臺會向應(yīng)用側(cè)發(fā)送此通知請求，成功結(jié)束，應(yīng)用側(cè)可以回復(fù)其它IVR命令。當非用戶掛機時，進入后續(xù)的業(yè)務(wù)邏輯，座席結(jié)束通話命令失敗則用戶與座席的通話將繼續(xù)，URL中“<customurl>”可通過用戶進入排隊命令中的agenthangupurl屬性自定義。
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&duration={duration}&recordurl={recordurl}&endtype={endtype} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| endtime | 字符串 | 用戶與座席通話結(jié)束時間,格式：yyyymmddHHmiss。 |
| endtype | 整數(shù) |
通話結(jié)束類型：0座席結(jié)束通話、1座席掛機、2強拆結(jié)束、3用戶掛機、4咨詢反回結(jié)束通話、5座席咨詢后轉(zhuǎn)移呼叫、6座席轉(zhuǎn)接呼叫、7咨詢過程中咨詢側(cè)主動掛機、8咨詢過程中用戶掛機。 |
| recordurl | 字符串 | 錄音下載地址。 |
| appid | 字符串 | 應(yīng)用id。 |
請求回復(fù)
可回復(fù)其它IVR命令，進入相關(guān)的業(yè)務(wù)邏輯。
1.6 用戶與座席通話結(jié)束后的錄音完成通知
用戶進入排隊或座席呼叫轉(zhuǎn)接命令中座席與用戶通話結(jié)束后，云通訊平臺向應(yīng)用側(cè)發(fā)送此通知。URL中“<customurl>”可通過<EnterCCS>或<Transfer>命令中的recordurl屬性自定義
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&duration={duration}&recordurl={recordurl} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| duration |
整數(shù) |
用戶與座席通話時長。 |
| recordurl |
字符串 |
錄音文件下載地址。 |
| appid |
必須 |
應(yīng)用id |
請求回復(fù)
回復(fù)空指令。
1.7 座席外呼用戶應(yīng)答通知
座席主動外呼用戶，當用戶接聽后云平臺會向AS側(cè)發(fā)送此通知。
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid}&number={number} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| appid |
必須 |
應(yīng)用id |
| number |
用戶號碼 | 手機號碼，座機號碼或者通訊賬號 |
請求回復(fù)
回復(fù)空指令。
1.8 隊列排隊人數(shù)溢出通知
用戶進入排隊時，若隊列已經(jīng)達到最大等待人數(shù)，且設(shè)置了后會發(fā)出此通知。URL中“<customurl>”可通過<EnterCCS>命令中的overflowurl屬性自定義
請求地址
POST /<customurl>?appid={appid}&callid={callid}&queuetype={queuetype} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| queuetype | 整數(shù) |
隊列類型。 |
| appid |
必須 |
應(yīng)用id。 |
請求回復(fù)
回復(fù)空指令。
1.9 班長監(jiān)聽結(jié)束通知
座席班長監(jiān)聽時班長掛機后會收到此通知請求。URL中“<customurl>”可通過<Monitor>命令中的notifyurl屬性自定義
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={agentid} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| appid |
必須 |
應(yīng)用id |
請求回復(fù)
回復(fù)其它IVR命令，讓用戶執(zhí)行后續(xù)業(yè)務(wù)流程。
1.10 座席外呼用戶振鈴?fù)ㄖ?/h3>
座席外呼用戶或座席后，當被叫有回音鈴音時發(fā)送此通知，URL中“<customurl>”可通過坐席外呼中的action屬性設(shè)置
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={answertime}&answertime={answertime} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| appid |
必須 |
應(yīng)用id |
| answertime |
字符串 |
應(yīng)答時間。 |
請求回復(fù)
回復(fù)空指令。
1.11 用戶輸入數(shù)據(jù)通知
座席調(diào)用命令獲取用戶輸入數(shù)據(jù)<GetUserData＞命令后發(fā)送此通知。
請求地址
POST /<customurl>?appid={appid}&callid={callid}&agentid={answertime}&data={data}&type={type}&downloadurl={downloadurl}&result={result} HTTP/1.1
請求參數(shù)
| 參數(shù)名 |
類型 |
說明 |
|---|---|---|
| callid |
字符串 |
一個由32位數(shù)字、字符組成的唯一呼叫標識符。 |
| agentid |
整數(shù) |
與其通話的座席id。 |
| appid |
必須 |
應(yīng)用id |
| data |
字符串 |
用戶按鍵內(nèi)容。 |
| type |
整數(shù) |
0按鍵內(nèi)容。 |
| result |
字符串 |
0正常；1 按鍵超時。 |
請求回復(fù)
回復(fù)IVR空命令。