3、IVR 會議功能指南
3.1 示例說明
(1) 通過rest接口創建會議，也可以用3和4來實現創建會議；
(2) 會議創建成功后通過rest接口邀請加入會議；
(3) 使用IVR外呼或者呼入方式后提示用戶：按1創建會議，按2加入會議；
(4) 用戶按1后創建會議，會議創建成功后提示創建的會議id，播報完成后自動加入會議；
(5) 用戶按2后提示用戶輸入8位會議id；
(6) 用戶輸入超時后提示用戶加入失敗重新輸入8位會議id，用戶再輸入超時后放音提示掛機；
(7) 用戶輸入錯誤會議id后加入會議失敗提示用戶重新輸入，只有輸入正確后才能加入會議，否則需要用戶自己掛機；
(8) 用戶輸入正確加入會議。
3.2 業務流程圖
3.3 開發指南
(1) 調用rest接口創建會議接口
(2) 會議創建成功調用rest接口邀請加入會議
(3) 如果需要呼入或外呼的方式創建會議和邀請或有則調用IVR外呼接口發起rest請求/呼入接入號
(4) 呼叫成功云通訊平臺會向客戶創建應用時填寫的ivr通知地址發送通知消息
(5) 第三方服務器獲取到通知消息響應按鍵放音，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<Get action='firstget' numdigits='1' timeout='30'>
<Play>confmenu.wav</Play>
</Get>
<Play>timeout.wav</Play>
<Redirect tag='1'>gettimeout</Redirect>
</Response>
說明：主命令為按鍵命令并且嵌套confmenu.wav的放音提示，在用戶按鍵1就回調通知到'firstget'的地址，如果用戶沒有按鍵就會20秒超時后執行副命令，跳轉通知gettimeout。
(6) 若用戶按鍵超時播放timeout.wav語音，語音播放完或按鍵打斷后業務流程重定向到Redirect指向的URL，重新執行按鍵放音的操作。
(7) 獲取到通知消息繼續3的流程提示用戶按鍵，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<Get action='firstget' numdigits='1' timeout='30'>
<Play>confmenu.wav</Play>
</Get>
<Play>timeoutbye.wav</Play>
<Hangup/>
</Response>
說明：主命令為按鍵命令并且嵌套confmenu.wav的放音提示，在用戶按鍵1就回調通知到'firstget'的地址，如果用戶沒有按鍵就會20秒超時后執行副命令，直接掛機。
(8) 用戶按鍵完成向第三方服務器發送按鍵上報的通知
a）如果用戶按1鍵，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<CreateConf action='createconfok' maxmember='10' autojoin='false'/>
</Response>
響應創建會議命令，創建會議成功后會通知到 'createconfok'地址
b) 如果用戶按2鍵，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<Get action='joinconfget' numdigits='8' timeout='30'>
<Play>confjoin.wav</Play>
</Get>
<Play>timeout.wav</Play>
<Redirect tag='2'>gettimeout</Redirect>
</Response>
獲取按鍵命令，接收用戶輸入的會議ID，按鍵超時則跳轉到gettimeout
c) 如果用戶按其他鍵，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<Get action='firstget' numdigits='1' timeout='30'>
<Play>confmenu.wav</Play>
</Get>
<Play>timeout.wav</Play>
<Redirect tag='1'>gettimeout</Redirect>
</Response>
(9) 收到用戶按2鍵的通知，響應加入會議，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<JoinConf action='joinconfok' confid='$digits'/>
<Redirect>joinconffail</Redirect>
</Response>
說明：加入會議命令，加入會議成功會通知到 'joinconfok'
(10) 用戶按1鍵成功創建會議給第三方服務器發創建成功的通知
(11) 獲取到通知消息響應播放提示音并自動加入會議，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<PlayMix type='40'>createconf.wav;$confid</PlayMix>
<Redirect>autojoinconf</Redirect>
</Response>
說明：播放混合音命令播放會議ID，后跳轉到 autojoinconf
(12) 語音文件播報完成定向到Redirect指向的URL：autojoinconf
(13) 第三方服務器獲取不到通知響應加入會議，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<JoinConf action='joinconfok' confid='$confid'/>
<Redirect>joinconffail</Redirect>
</Response>
說明：加入會議命令
(14) 如果加入會議成功則向第三方服務器發送加入成功的通知消息
(15) 不需要后續流程，直接想用空命令即可，響應包體：
<Response> <CmdNone/> </Response>
說明：不需要后續流程，響應空命令
(16) 如果加入會議失敗則定向到Redirect指向的URL：joinconffail并重復5的流程，響應包體：
<?xml version='1.0' encoding='UTF-8'?>
<Response>
<Get action='joinconfget' numdigits='8' timeout='30'>
<Play>confjoinfail.wav</Play>
</Get>
<Play>timeout.wav</Play>
<Redirect tag='2'>gettimeout</Redirect>
</Response>
說明： 獲取按鍵命令，接收用戶輸入的會議ID，按鍵超時則跳轉到gettimeout
(17) 掛機后向第三方服務器發送掛機通知
(18) 掛機后響應空命令即可，響應包體：
<Response>
<CmdNone/>
</Response>
說明：主命令為空命令，因為結束業務了不需要返回其他的IVR命令。
3.4 參考文檔
(1) rest 會議管理接口文檔
(2) IVR基礎命令接口文檔
(3) IVR基礎通知消息接口文檔
(4) IVR會議命令接口文檔
(5) IVR 會議通知消息接口文檔
文檔更新時間：2016年9月7日