2、IVR 咨詢呼叫指南
2.1 示例說明
(1) 使用IVR外呼或者呼入方式后放音提示用戶按鍵：按1語音提示，按2轉接人工；
(2) 用戶超時沒按鍵后繼續放音提示用戶按鍵，再超時放音提示用戶后掛機；
(3) 用戶按1鍵后放一段語音提示：我們會為您提供更好的服務，感謝您的來電收聽，再見！放音完成后掛機；用戶按2鍵后呼叫被叫，在呼叫被叫的同時放音提示：正在為您轉接中，本次通話可能會被錄音；用戶按其他鍵則重新播報主菜單讓用戶進行按鍵操作；
(4) 被叫超時沒有接聽或者拒接后通過呼轉的回調放音提示用戶：轉接的客服人員忙，歡迎您的來電，再見！；
(5) 當被叫接聽后被叫掛機或通話時間到，通過相關的回調放音提示用戶：請對我們的客服人員做評價，滿意請按1，不滿意請按2；
(6) 當用戶超時沒按鍵評價放音提示用戶后掛機；當用戶按鍵后提示用戶：感謝您的來電，再見！放音完成后掛機。
2.2 業務流程圖
2.3 開發指南
(1) 通過外呼或者呼入的方式發起呼叫：
a 調用IVR外呼接口發起rest請求（接口如下）
b 呼入接入號（測試階段可以直接撥打01083035690進行調試,如果正式使用需要聯系售前同事綁定接入號）
(2) 呼叫成功云通訊平臺會向客戶創建應用時填寫的ivr通知地址發送通知消息
(3) 第三方服務器獲取到通知消息響應按鍵放音，響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Get action='firstget' numdigits='1' timeout='30'> <Play>main.wav</Play> </Get> <Play>timeout.wav</Play> <Redirect>gettimeout</Redirect> </Response>
說明：主命令為按鍵命令并且嵌套main.wav的放音提示，在用戶按鍵1就回調通知到'firstget'的地址，如果用戶沒有按鍵就會30秒超時后執行副命令，跳轉通知gettimeout。
(4) 若用戶按鍵超時播放timeout.wav語音，語音播放完或按鍵打斷后業務流程重定向到Redirect指向的URL，重新執行按鍵放音的操作。
(5)獲取到通知消息，繼續1的流程提示用戶按鍵，響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Get action='firstget' numdigits='1' timeout='30'> <Play>main.wav</Play> </Get> <Play>timeoutbye.wav</Play> <Hangup /> </Response>
說明：主命令為按鍵命令并且嵌套confmenu.wav的放音提示，在用戶按鍵1就回調通知到'firstget'的地址，如果用戶沒有按鍵就會20秒超時后執行副命令，直接掛機。
(6)用戶按鍵完成向第三方服務器發送按鍵上報的通知
a）如果用戶按1的響應包體
<?xml version='1.0' encoding='UTF-8'?> <Response> <Play>muzic.wav</Play><Hangup /></Response> 給用戶放音后直接掛機
b）如果用戶按2的響應包體
<?xml version='1.0' encoding='UTF-8'?> <Response> <ConsultationCall number=’13800138000’ record='true' timeout='30' calltime='60' calltimeoverurl='calltimeoverurl' hangupurl='hangupurl'> <Play loop='-1'>wait.wav</Play> </ConsultationCall> <Redirect>connectfail</Redirect> </Response> 咨詢呼叫被叫，設置超時時間30秒、通話時長60秒和通話時長到的回調url calltimeoverurl以及被叫掛機后回調的url 'hangupurl'
c）按其他鍵的響應
<?xml version='1.0' encoding='UTF-8'?> <Response> <Get action='firstget' numdigits='1' timeout='30'> <Play>main.wav</Play> </Get> <Play>timeout.wav</Play> <Redirect>gettimeout</Redirect> </Response>
(7)如果咨詢呼叫轉接失敗，則重定向到Redirect指向的URL connectfail，并響應放音掛機的命令，響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Play>buzy.wav</Play> <Hangup /> </Response>
說明：提示用戶轉接失敗并掛機
(8)轉接成功客服掛機向第三方服務器發送被咨詢側掛機通知
(9)獲取到通知，響應按鍵評價，響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Get action='pingjia' numdigits='1' timeout='20'> <Play loop='-1'>pingjia.wav</Play> </Get> <Play>timeoutbye.wav</Play> <Hangup/> </Response>
說明：獲取按鍵，提示用戶進行評價
(10)如果通話時間到，則向第三方服務器發送設置時間結束咨詢側通知
(11)獲取到通知，響應按鍵評價，響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Get action='pingjia' numdigits='1' timeout='20'> <Play loop='-1'>pingjia.wav</Play> </Get> <Play>timeoutbye.wav</Play> <Hangup/> </Response>
說明：獲取按鍵，提示用戶進行評價
(12)用戶按鍵完成向第三方服務器發送按鍵上報的通知
(13)獲取到按鍵，響應放音：感謝您的來電，再見！響應包體：
<?xml version='1.0' encoding='UTF-8'?> <Response> <Play>thank.wav</Play> <Hangup/> </Response>
說明：放音提示用戶評價成功
(14)掛機向第三方服務器發送掛機通知
(15)掛機后響應空命令即可，響應包體：
<Response>
<CmdNone/>
</Response>
說明：主命令為空命令，因為結束業務了不需要返回其他的IVR命令。
2.4 參考文檔
(1) rest IVR外呼接口文檔
(2) IVR基礎命令接口文檔
(3) IVR基礎通知消息接口文檔
文檔更新時間：2016年9月26日