<ruby id="vtv9t"></ruby>

      <p id="vtv9t"><del id="vtv9t"><thead id="vtv9t"></thead></del></p>

            OMAPI技術開發文檔20180208

             

             

            上海迅時通信設備有限公司 

             

            OM API技術開發文檔V6.0

             

             

             

            電話:0531-86950915

            文檔版本:V6.0

            更新時間:20180208

             

             

             

             

            版權所有©上海迅時通信設備有限公司2018。保留一切權利。

            非經本公司書面許可,任何單位和個人不得擅自摘抄、復制本文檔內容的部分或全部,并不得以任何形式傳播。

             

            OM API技術開發文檔(小·logoV6.0

             

            本文主要介OM API的作用及使用方法,幫助程序開發人員學習并掌OM API,最終利OM API開發出更多更好的應用程序。

                    點擊這里PDF版。

                    點擊這里Word版。

            讀前須知

            閱讀本文檔之前,您最好對我司的OM系列的IPPBX產品有一定了解。

            推薦資料:OM用戶手冊》、OM管理員手冊》、OM 功能學習指導書》。

            資料下載OM相關資料可到迅時官網下載。

            說明:所有OM系列產品OM API都是一樣的,只是版本不同而已。

            技術支持與服務

            為保障開發者能夠基OM API順利開發應用產品,我們提供了論壇、QQ群、微信公共號等多渠道的技術支持與服務。

            OM API技術咨詢電話:0531-86950915

            微信公眾號:

            img2

            發布時間:2017-02-08

             

            目錄

            OM API技術開發文檔(V6.0        

            1 快速入門        

            1.1 初次見面        

            1.2 交互原理        

            1.3 測試demo        

            1.4 API認證        

            2 OM API接口        

            2.1 控制命令(Control)        

            2.1.1 查詢(Query)        

            2.1.2 配置(Assign)        

            2.1.3 呼叫保持和接回(Hold/Unhold)        

            2.1.4 靜音開啟與解除(Mute/Unmute)        

            2.1.5 監聽和插播(Monitor/Talk/Listen)        

            2.1.6 強插(Bargein)        

            2.1.7 強拆(Clear)        

            2.2 呼叫轉接命令(Transfer        

            2.2.1 連接(Connect        

            2.2.2 隊列(Queue        

            2.2.3 會議(Conference        

            2.3 語音管理命令(Manage        

            2.3.1 查詢語音文件        

            2.3.2 刪除語音文件        

            2.4 來電受理(Accept        

            2.5 事件報告        

            2.5.1 系統事件        

            2.5.2 分機狀態變更事件        

            2.5.3 呼叫狀態變更事件        

            2.5.4 來電呼入控制流程事件        

            2.5.5 按鍵信息事件(DTMF)        

            2.5.6 語音文件播放完畢事件(EndOfAnn)        

            2.5.7 分機組隊列事件(QUEUE        

            2.6 通話記錄報告        

            2.6.1 呼入(IN)        

            2.6.2 呼出(OU)        

            2.6.3 內部互撥(LO)        

            2.6.4 呼叫轉移(FI/FW)        

            2.6.5 雙向外呼(CB)        

            3 實現方案        

            3.1 點擊撥號        

            3.2 /去電彈屏        

            3.3 多級IVR        

            3.4 來電黑名單        

            3.5 來電直通車        

            3.6 指定中繼外呼        

            3.7 酒店叫醒解決方案        

            3.8 API+TTS實現方案        

            3.9 語音播報實現方案        

            3.10 API中間件解決方案        

            3.11 API+儂好解決方案        

            3.12 API+云平臺解決方案        

            3.13 分機外呼控制實現方案        

            3.14 監聽+插播+強拆實現方案        

            3.15 接通后播放語音實現方案        

            3.16 滿意度評價實現方案        

            3.17 公網服務器訪問私網內OM        

            3.17.1 端口映射        

            3.17.2 配置云平臺做代理轉發        

            3.17.3 客戶端直接訪問OM        

            4 專題介紹        

            4.1 IPPBX        

            4.2 語法和對象        

            4.3 API認證        

            4.4 API反向認證        

            4.5 API功能開關        

            4.6 API控制模式功能介紹        

            4.7 外轉外功能開關        

            4.8 錄音        

            4.9 FSP錄音下載        

            4.10 語音文件配置說明        

            4.11 語音菜單        

            4.12 出隊列判斷方法        

            4.13 插播TTS遠程語音文件        

            4.14 迅時云平臺配置方法        

            4.15 跨域訪問OM的解決方法        

            4.16 Telnet登錄OM后臺的方法        

            5 常見問題解答        

            5.1 網絡環境相關問題解答        

            5.2 API認證相關問題解答        

            5.3 menu相關問題解答        

            5.4 配置相關問題解答        

            5.5 呼叫相關問題解答        

            5.6 事件相關問題解答        

            5.7 CDR相關問題解答        

            5.8 其他問題        

            6 附錄        

            6.1 系統參數列表        

            6.2 系統參數查詢和配置方法        

            6.3 軟件版本迭代        

            Rev 2.1.5.121(GA)        

            Rev 2.1.5.113(GA)        

            Rev 2.1.5.107(GA)        

            Rev 2.1.5.102(GA)        

            Rev 2.1.5.92(GA)        

            Rev 2.1.5.86(GA)        

            6.4 文檔更新說明        

             

             


            1 快速入門

             

            本章簡單介紹OM API基本概念及應用服務器OM之間的基本交互原理,手把手教你完OM API認證配置,并使用測試工具體驗應用服務器OM之間的消息交互,助您快速入門。

            1.1 初次見面

            OM API

            迅時OM系列的IPPBX設備提供統一的開放式接OM API,開發者可以通OM APIOM設備進行控制、監控和數據統計等。

            OM API本質上是經過封裝的簡單XML消息,應用服務器OM設備之間通過HTTP協議進行通信。

            1.       應用服務器通過OM APIOM進行操作:參數查詢、參數配置、狀態查詢、呼叫控制、呼叫轉接等。

            2.       OM實時向應用服務器推送報告:分機狀態變化、呼叫狀態、配置變化、服務啟動、DTMF、語音播放完畢和通話記錄等。

            OM API使OM設備具有更大的靈活性和可操作性,開發者可利OM API開發或對接呼叫中心、計費系統、酒管系統、CRM、OA辦公系統等豐富多彩的應用。

            OM API有如下四類本領:

            http://app.newrocktech.com/omapi/assets/OMAPI%E7%9A%84%E5%9B%9B%E7%B1%BB%E6%9C%AC%E9%A2%86.png

            可實現的主要功能有:點擊撥號、/去電彈屏、通話記錄、錄音、狀態監控、分機組和隊列、IVR語音導航、滿意度調查、酒店叫醒服務、語音信箱、語音驗證碼、來電/白名單等。

            成功案例和合作共贏

            迅時搭建了一個類似于第三方應用市場的平—— 企業應用平臺,所有利用OM API開發的應用產品都可以申請上架到該平臺。

            上架該平臺至少有兩大好處:

            1.       擴展渠道:迅時的渠道就等于你的渠道。迅時在全國大約1200家渠道和合作伙伴,這些渠道會向用戶推薦你的應用產品。當用戶需要購買時,渠道人員會聯系你。另外,我們也會定期推廣優質的應用產品。

            2.       數據統計和分析:迅時會定期將您的應用產品的訪問量、用戶喜歡數量、排名等統計結果以郵件或微信形式發送給你,讓你輕松掌握市場反饋。

            迅時歡迎更多合作伙伴的參與,共同解決中小型企業的辦公和通信問題。

            1.2 交互原理

            簡單認OM API之后,我們來了解OM API的通信方式。

            傳輸協議

            應用服務器和OM之間基于HTTP協議進行通信,API消息封裝在HTTP包體中。

            http://app.newrocktech.com/omapi/assets/%E4%BC%A0%E8%BE%93%E5%8D%8F%E8%AE%AE.png

            消息內容如:

            HTTP請求消息:

            POST /xml HTTP/1.0

            Content-Type:text/xml

            Content-Length:101

             

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <DeviceInfo/>

            </Control>

            HTTP響應消息:

            HTTP/1.0 200 OK

             

            <?xml version="1.0" encoding="utf-8" ?>

             <DeviceInfo>

                <manufacturer>New Rock Technologies, Inc</manufacturer>

                <model>Rev 1.0.1 WROC2000-1S/1</model>

                <version>Rev 2.2.5.81.1</version> 

                <mac>00:0E:A9:00:12:BD </mac>

                <devices>

                    <ext lineid="Phone 1" id="200" />

                    <ext lineid="IPPhone 50" id="208" />

                    <line lineid="Line 2" id="02161208234" />

                    <line lineid="IPLine 21" id="02161204000" />

                </devices>

             </DeviceInfo>

            通信方式

            應用服務器OM之間的交互是雙向的,雙方互為HTTP服務端和客戶端。

            正向:應用服務器作HTTP 客戶端,OMHTTP服務端

            應用服務器請OM執行某個功能(如,發起呼叫)或提供某些信息(如,查詢狀態)。此時,采用的HTTP POST方法、TCP短連接方式(注OM只支TCP短連接接收)。

            流程為:  斷開。

            交互圖如下:

            http://app.newrocktech.com/omapi/assets/OM%E4%BD%9C%E4%B8%BAHTTP%E6%9C%8D%E5%8A%A1%E5%99%A8.png

            情況二OM作為HTTP客戶端,應用服務器作HTTP服務端

            OM主動向應用服務器推送某些消息(如,分機振鈴事件),應用服務器收到消息后斷TCP連接(注:這里不是標準HTTP請求響應流程,不需要應用服務器回復響應)。

            此時,采用的HTTP GETPOST方法(默認GET,若參數API_METHOD = 1,則POST)。

            注:OM默認以短連接方式推送消息,也可通過參數CONTROL_TYPE配置為長連接。建議采用短連接方式。

            流程為:接收消 斷開。

            http://app.newrocktech.com/omapi/assets/%E5%BA%94%E7%94%A8%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%BD%9C%E4%B8%BAHTTP%E6%9C%8D%E5%8A%A1%E5%99%A8.png

            1.3 demo

            我們提供多種語(PHP、JAVA、C#、C)編寫的發送和接收消息demo,詳情請參考API新編開發指南。

            下面,我們用測試工具(相當于一個簡單的應用服務器)來演OMAPI應用服務器的配置方法及收發消息過程。

            配置

            注:這里我們采用IP方式。

            步驟一:配OM設備認證地址

            OM設備頁面,點擊應用服務 > API,在應用服務器一欄選擇自定義(默認選中為儂好,儂好是內置在設備里的小型呼叫中心),填寫應用服務器地址(即測試工具所在的電IPOM發送端口,可自定義)如,192.168.130.27:8989。

            步驟二:配置分機和外線API開關

            進入應用服務 > API,在API功能開關一欄將分機和外線的狀態監控、來電應答/來電應答后控制開關打開,點擊保存,并重啟設備。

            設備配置如下圖所示:

            http://app.newrocktech.com/omapi/assets/%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87%E9%85%8D%E7%BD%AE.png

            步驟三:配置測試工具

            1.       點擊下載測試工具及其源代碼,并在電腦桌面打開,填寫一HTTP監聽端口(該端口與設備上配置OM發送端口保持一致,應8989 ),點擊開始監聽。(注:測試工具的源碼可點擊這里下載)。

            2.       填寫發送地址OMIP地址HTTP端口,192.168.130.219:80。

            注:OMHTTP端口默認80,可在設備高級設>安全配>Web管理處修改。

            測試工具配置如下圖所示:

            http://app.newrocktech.com/omapi/assets/%E6%B5%8B%E8%AF%95%E5%B7%A5%E5%85%B7.png

             

            跑個流程

            完成了配置以后,接下來我們演示一個分機呼叫分機的流程,為第二章的接口使用和理解奠定基礎。

            發送命令

            如何通OM API實現分機呼分機呢?

            只需OM發送一API消息:

            <?xml version="1.0" encoding="utf-8" ?>

            <Transfer attribute="Connect">

              <ext id="200"/>

              <ext id="201"/>

            </Transfer>

            說明:

            Ÿ                      第一行XML聲明,每API消息都有且相同。它定義XML的版本1.0)和所使用的編碼方式utf-8)。

            Ÿ                      第二行XML的根。根元Transfer表明這個是一個呼叫轉接類API。屬性Connect表示本次轉接的屬性為連接。

            Ÿ                      第三、第四行ext的英文單extension的簡寫,200為主叫分機號碼,201為被叫分機號碼。

            Ÿ                      第五行為根節點的閉合標簽。

            注: XML 的語法參見XML教程,更OM API語法詳解請參見第二章。

            觀察執行結果

            執行完 API 后,后續流程為:

            1.                      主叫分200會先振(默認,先呼誰后呼誰由參數API_CALLING);

            2.                      200摘機后,被叫分201開始振鈴,并200可以聽的回鈴音;

            3.                      201也摘機后,雙方成功建立通話;

            4.                      任意一方掛機后通話結束。

            觀察收到API消息

            查看測試工具,可以看到接收到很多API消息。這些消息中,有兩個消息是話單CDR),其他的為事件Event)。

            Ÿ                      CDR為通話記錄,在通話結束時產生。2CDR中一個是主叫分機的通話記錄,另一個是被叫分機的通話記錄;

            Ÿ                      Event表示事件消息,由呼叫過程OM自動觸發。

            1事件

            本次呼叫過程中,收到的事件屬性有這些BUSY、IDLE、RING、ALERT、ANSWER、ANSWERED、BYE。

            其中:

            Ÿ                      BUSYIDLE是一對,在分機狀態發生變化時產生。BUSY表示分機由空閑變為忙狀態, IDLE 表示分機由忙變為空閑狀態;

            Ÿ                      RING、ALERT、ANSWER、ANSWERED、BYE屬于一個系列,在呼叫過程中產生。其中:

            。       RINGALERT是一對, RING表示分機開始振鈴,ALERT表示收到對方的回鈴ringback)信號。

            。       ANSWERANWERED是一對,ANSWER 表示分機應答,ANSWERED表示收到對方應答的信號。

            。       BYE表示通話結束。

            通過以上事件,你可以實時監控分機的線路狀態和呼叫情況,并可以實現一些應用功能,比如:/去電彈屏(當分機振鈴時將來電號碼對應的客戶資料彈屏顯示在電腦屏幕上)。

            注:更多關于事件的介紹,參見2.5章節。

            2通話記錄CDR

            通話結束后,OM會立即將通話記錄推送給應用服務器(這里指測試工具)。

            消息格式

            <?xml version="1.0" encoding="utf-8" ?>

            <Cdr id="13620170308103713-0">

              <callid>32820</callid>

              <TimeStart>20170308103709</TimeStart>

              <Type>IN</Type>

              <Route>IC</Route>

              <CPN>200</CPN>

              <CDPN>201</CDPN>

              <TimeEnd>20170308103713</TimeEnd>

              <Duration>2</Duration>

              <TrunkNumber></TrunkNumber>

              <Recording>20170308/200_201_20170308_103711_8034_cd.wav</Recording>

              <RecCodec>PCMU</RecCodec>

            </Cdr>

            參數說明

            參數名稱

            解釋說明

            Cdr id

            通話記錄的編號。格式:系列+年月日時分+固定內(-0)

            callid

            通話的相對唯一標識符

            TimeStart

            呼叫起始時間戳,格式:年月日時分秒

            Type

            話務類型,IN表示呼入,LO表示內部呼叫

            Route

            路由類型,IC表示內部路由

            CPN

            主叫號碼

            CDPN

            被叫號碼

            TimeEnd

            呼叫釋放時間戳,格式:年月日時分秒

            Duration

            通話時長,單位:秒。即,從呼叫接通到呼叫釋放的時長,不包括振鈴時間。

            Trunk

            中繼號碼(本次是內部呼叫,沒有用到中繼,所以值為空)

            Recording

            錄音文件的相對保存路徑,格式:生成日/錄音文件名稱

            注:更多關CDR的介紹,參見2.6章節。

            1.4 API認證

            API認證方式包括正向認證和反向認證兩種。

            正向認證:應用服務器OM發送請求命令時,需通OM的認證。

            反向認證:OM向應用服務器發送消息時,需通過應用服務器的認證。

            一、正向認證

            正向認證分IP認證和數字簽名認證兩種方式,您可以根據自己的實際場景選擇一種來完成認證。

            IP認證

            IP認證,只允許某一固IP地址OMAPI請求,其他地址統統認為沒有權限。

            適用的應用場景:

            1.                      應用服務器IP/域名固定;

            2.                      一個應用服務器對接一OM;

            3.                      應用服務器OM之間網絡互通。

            配置

            配置方法,如下圖所示:

            img9

            參數說明:

            Ÿ                      服務器地址: 應用服務器IP/域名和監聽端口,如192.168.130.27:8989。如果用戶未指定端口時默認80端口。

            Ÿ                      URL API報告的相對路徑(也可不填寫)。格式為{part1}/{part2}/{part3}/{},如omapi/report。

            服務器地址URL組合起來即為應用服務器接API報告的全路徑,如192.168.130.27:8989/omapi/report。

            應用服務器地址的作用:

            1.                      API報告:OMAPI消息推送給這個地址;

            2.                      訪問權限控制: OM只受理從該服務器IP地址(端口不影響)發送API請求;拒絕受理從其它地址發送API請求,并對該請求響Unauthorized。

            點擊這里查看更多詳情。

            數字簽名認證

            數字簽名認證本質上是通過驗OM和應用服務器雙方持有的秘鑰來完成認證。

            版本要求

            OM軟件版本Rev 2.1.5.99及其以上。

            適用的應用場景:

            1.                      應用服務器采用動態域名,IP地址不固定;

            2.                      OM要對接多API應用服務器;

            3.                      API應用客戶端要直接訪OM;

            4.                      API消息的源地址容易發生變化;

            5.                      應用服務器通過迅時云平臺轉發消息OM。

            配置

            配置參數:數字簽名認證密碼(接收)和數字簽名有效期。

            配置界面,如下圖所示:

            img10

            參數說明:

            1.                      API數字認證密碼(接收):OM對應用服務器認證的秘鑰,可自定義,需和應用服務器發送請求時攜帶的秘鑰保持一致。

            2.                      API數字認證有效期:可自定義,范圍0~86400,單位:秒,只有在該有效期內認證參數才有效,0表示永久有效。

            點擊這里查看更多詳情。

            注:不論IP認證還是數字簽名認證,都需要OM頁面配置應用服務器地址,用來接API消息。

            二、反向認證

            反向認證,即應用服務器OM的認證。OM向應用服務器推API消息時攜Auth認證信息,應用服務器根據收到的消息是否滿足認證條件來選擇是否接收該消息。

            注:只有應用服務器要求OM進行認證時才配置,若不要求,可不配置。

            版本要求

            Rev 2.1.5.116及以上

            配置

            配置參數:數字簽名認證密碼(發送)和數字簽名有效期。

            配置界面,如下圖所示:

            img11

            參數說明:

            1.                      API數字認證密碼(發送):應用服務器OM進行認證的秘鑰,可自定義,需和應用服務器接收消息時配置的秘鑰保持一致。

            2.                      API數字認證有效期:可自定義,范圍0~86400,單位:秒,只有在該有效期內認證參數才有效,0表示永久有效。

            點擊這里查看更多詳情。

             

             

            2 OM API接口

             

            本章OM API接口部分,包括API請求命令API報告兩部分內容。

            Ÿ                      API請求命令,指應用服務器OM發送API消息,包括制命令、轉接命令來電受理命令三種類型。

            Ÿ                      API報告,OM主動向應用服務器推送API消息,包括事件報告通話記錄報告兩種類型。

            2.1 控制命(Control)

            控制命令包括查詢、配置、呼叫保持與接回、靜音與解除靜音、監聽、強插、強拆。

            2.1.1 查詢(Query)

            API用于查OM設備上指定對象的相關信(如,配置參數和狀)。這些對象包括:設備信deviceInfo、分(ext)、中繼trunk)、來電visitor)、去電(outer)、分機(group)、語音菜(menu)。

            查詢請求的規則說明

            Ÿ                      最小的查詢單位是對象,即不支持單獨查詢該對象的某一個具體參數。

            查詢結果的規則說明

            Ÿ                      查詢結果中包含該對象的所有可提供的相關參數和狀態信息。

            Ÿ                      如果查詢結果中沒有攜帶某個參數信息,則可能原因為:

            °                      該參數值為默認值;

            °                      該參數不存在;

            °                      不支持查詢該參數。

            查詢設備信息

            API用于查OM設備自身的相關信息,如:生產商、硬件版本、軟件版本,以及所有的分機、分機組和中繼等。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <DeviceInfo/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <DeviceInfo>

            string

            OM設備的基本信息

            無值

            響應示例

            <?xml version="1.0" encoding="utf-8" ?>

            <DeviceInfo> 

                <manufacturer>New Rock Technologies, Inc</manufacturer>

                <model>Rev 6.0.0 OM20-2S/2</model>

                <version>Rev 2.1.5.111</version>

                <mac>00:0E:A9:00:12:BD </mac>

                <devices> 

                    <ext lineid="Phone 1" id="200" /> 

                    <ext lineid="IPPhone 50" id="208" /> 

                    <line lineid="Line 2" id="02161208234" /> 

                    <line lineid="IPLine 21" id="02161204000" /> 

                    <group id="1"> 

                        <ext id="200" /> 

                    </group>

                </devices>

            </DeviceInfo>

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數),| 表示或者關系

            參數名稱

            類型

            參數說明

            參數值說明

            DeviceInfo

            object

            OM設備信息

            <manufacturer>

            string

            生產商

            New Rock Technologies, Inc

            <model>

            string

            硬件版本

             Rev 6.0.0 OM20-2S/2

            <version>

            string

            軟件版本

             Rev 2.1.5.111

            [mac]

            string

            物理地址

             00:0E:A9:00:12:BD(由系統參數API_MAC決定是否攜MAC地址)

            [ext]

            object

            分機

             

            <ext lineid>

            string

            分機的線路編號,是分機的唯一固定標識

            <Phone | IPPhone> {NO.},如Phone 1

            <ext id>

            string

            分機號

             

            [line]

            object

            中繼(外線)

            linetrunk是指同一個對象,即中繼(外線)

            <line lineid>

            string

            中繼的線路編號,是中繼的唯一固定標識

            <Line | IPLine> { NO.},如Line 13

            [line id]

            string

            中繼號

             

            [group id]

            int

            分機組的序號

            1~50

            注:

            Ÿ                      響應結果中包含所有的分機線路和中繼線路信息,如果設備線路量很大,注意查詢接收的緩存空間;

            Ÿ                      設備線路量大時,建議使用web的分頁查詢接口分別獲取分機或中繼線路。

            查詢分機

            API用于查詢指定分機的相關信息,如:配置參數、分機狀態、通話方等。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <ext id="208"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <ext id>

            string

            分機號

            必須OM上的有效分機,值不能為空

            響應示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Status>

                <ext id="208">                            

                    <lineid>Phone 1</lineid>                

                    <group id="1"/>                            

                    <group id="2"/>                            

                    <staffid>1304081</staffid>                

                    <Call_Pickup>yes</Call_Pickup>            

                    <Fwd_Number>18603752801</Fwd_Number>    

                    <Call_Restriction>3</Call_Restriction>    

                    <Off_Line_Num>200</Off_Line_Num>        

                    <mobile>18603752800</mobile>    

                    <fork>18603752802</fork>                

                    <email>admin@hotmail.com</email>        

                    <record>on</record>    

                    <api>7</api>                            

                    <voicefile>welcome</voicefile>            

                    <state>active</state>                    

                    <outer id="8" from="208" to="13012345678" trunk="02161208234" callid="28680">

                        <state>talk</state>                    

                    </outer>

                </ext>

            </Status>

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數),| 表示或者關系

            參數名稱

            類型

            參數說明

            參數值說明

            <ext id>

            string

            分機號

            純數字字符串

            <lineid>

            string

            分機的線路編號,是分機的唯一固定標識

            IPPhone | Phone XXX

            [staffid]

            string

            工號,分機接通前會向來電方播放該工號

            純數字字符串

            [group]

            int

            分機組,這里為該分機所屬的分機組

            1~50

            [voicefile]

            string

            語音文件,這里為分機隊列中排隊等待時播放的語音文件

            只支.dat.pcm格式

            [email]

            string

            員工的電子郵件地(暫無對應功)

             

            [Call_Restriction]

            int

            呼叫權限

            0: 內線,1: 市話,
            2: 國內,3: 國際

            [Call_Pickup]

            string

            代接權限,是否允許來電被其它分機代接

            Yes:允許,no:不允許

            [No_Disturb]

            string

            免打擾功能開關,開啟免打擾后分機將屏蔽所有來電,但能主動發起呼叫

            on: 開啟,off: 關閉

            [Fwd_Type]

            int

            呼叫轉移方式

            0: 關閉,1: 全轉,
            2: 遇忙或無應答轉

            [Fwd_Number]

            string

            呼叫轉移號碼

            值為空時關閉

            [fork]

            string

            同振號碼

            值為空時關閉

            [mobile]

            string

            分機綁定的手機號,該手機號可作為呼叫轉移、離線轉移的缺省配置

            值為空時關閉

            [record]

            string

            實時錄音功能開關

            on: 開啟,off: 關閉

            [api]

            int

            API的功能開關

            0:API狀態監控
            7: API狀態監控

            點擊查API功能開關詳細介紹

            [state]

            string

            線路狀態

            Ready: 空閑可用
            Active: 振鈴、回鈴或通話中
            Progress:模擬分機摘機后等待撥號以及撥號過程中
            Offline: IP分機離線
            Offhook:模擬分機聽催掛音時的狀態

            [outer]

            object

            去電,這里作為該查詢分機的通話方

             

            [id]

            int

            去電的編,可依據該參數進行呼叫轉接

             

            [from]

            string

            原始主叫號碼

             

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入中繼號碼)

             

            [trunk]

            string

            中繼號,即該去電從該中繼呼出

             

            [callid]

            int

            通話的相對唯一標識符

             

            [state]

            string

            通話狀態

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            [visitor]

            object

            來電,這里作為該查詢分機的通話方

             

            <id>

            int

            來電的編號,可依據該參數進行呼叫轉接等操作

             

            <from>

            string

            原始主叫號碼

             

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入的中繼號碼)

             

            <callid>

            int

            通話的相對唯一標識符

             

            [state]

            string

            通話狀態

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            [ext]

            object

            分機,這里作為該查詢分機的通話方

             

            <id>

            string

            分機號

             

            [state]

            string

            通話狀態

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            查詢中繼

            API用于查詢指定中繼(又稱為外線)的相關信息,如:配置參數、線路狀態、呼叫狀態等。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <trunk id="2174"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <trunk id>

            string

            中繼號碼(外線號碼)

            必須OM上的有效中繼,值不能為空

            響應示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Status>

                <trunk id="2174">

                    <lineid>Line 75</lineid>

                    <state>active</state>

                    <visitor id="2" from="202" to="2174" callid="36866">

                        <state>talk</state>

                    </visitor>

                </trunk>

            </Status>

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數),| 表示或者關系

            參數名稱

            類型

            參數說明

            參數值說明

            <trunk id>

            string

            中繼(外線)號

            數字字符串

            <lineid>

            string

            中繼的線路編號,是中繼的唯一固定標識

            IPLine | Line XXX

            <state>

            string

            中繼的線路狀態

            ready: 可用
            active: 摘機、振鈴或通話中
            unwired:未接線
            offline:離線
            注:IP中繼多路并發時,只要有一路空閑可用,其狀態就ready。

            [outer]

            object

            去電

             

            <id>

            int

            去電的編,可通過該參數對去電進行轉接、查詢、掛斷等操作

             

            <from>

            string

            原始主叫號碼

             

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入中繼號碼)

             

            <trunk>

            string

            中繼, 該去電通過該中繼呼出

             

            <callid>

            int

            通話的相對唯一符

             

            <state>

            string

            通話狀態

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            [visitor]

            object

            來電

             

            <id>

            int

            來電的編號,可通過該參數對來電進行轉接、查詢、掛斷等操作

             

            <from>

            string

            原始主叫號碼

             

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入的中繼號碼)

             

            <callid>

            int

            該路通話的相對唯一的編號

             

            <state>

            string

            通話狀態

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            查詢來電

            API用于查詢指定來電的相關信息,如:來電的屬性參(編號、原始主叫、原始被叫、通話狀態、相對唯一標識)、來電的通話方、呼叫狀態。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <visitor id="1"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <visitor id>

            int

            來電的編號

            數字,值為空時列舉所有來電

            響應示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Status>

                <visitor id="1" from="02167103750" to="02161208234" callid="49189">  

                    <ext id=" 200" />

                    <state> progress </state>

                </visitor>

            </Status>

            解釋: 1是由外部電02167103750通過中繼02161208234呼入OM設備,并且當前正在和分200通話中。

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數),| 表示或者關系

            參數名稱

            類型

            說明

            [visitor]

            object

            來電,為由中繼呼OM的外部通話

            <id>

            int

            來電的編號,可依據該參數對來電進行轉接、查詢、掛斷等操作

            <from>

            string

            原始主叫號碼

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入的中繼號碼)

            <callid>

            int

            通話的相對唯一標識符

            [ext | menu | outer]

            object

            來電的通話方,可能為分機、語音菜單、呼叫寄存區、廣播區、去電,為空時表明來電呼OM后尚未被轉接

            [state]

            string

            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            查詢去電

            API用于查詢指定去電的相關信息,如:去電的編號、主叫方、被叫方、通過的中繼號碼、通話狀態以及通話的相對唯一標識符。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <outer id="5"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <outer id>

            int

            去電的編號

            數字,值為空時列舉所有去電

            響應示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Status>

                <outer id="5" from="200" to="13012345678" trunk="02161208234" callid="32773">

                    <outer id="5" from="200" to="13012345678" trunk="02161208234" callid="32773"/>

                </outer>

            </Status>

            解釋: 5是由分200對外部電13012345678發起的呼叫,該路通話所經過的中繼線02161208234。

             

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數)

            參數名稱

            類型

            說明

            [outer]

            object

            去電,OM設備的中繼呼出的通話

            <id>

            int

            去電的編,可依據該參數進行轉接、掛斷、查詢等操作

            <from>

            string

            原始主叫號碼

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入的中繼號碼)

            <trunk>

            string

            中繼號,這里為該去電呼出時通過的中繼

            <callid>

            int

            通話的相對唯一標識符

            [state]

            string

            通話狀態,
            Talk: 通話進行中
            Progress: 呼叫處理過程中
            Wait: 呼叫等待中

            查詢分機組

            API用于查詢分機組的相關信息,如:配置參數(分機成員、呼叫排隊時播放的背景音樂、呼叫分配規則)、正在該分機組隊列中等待的來電。

            注: 分機組隊列中的呼叫排隊順序為從上到下。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <group id="1"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <group id>

            int

            分機組的編號

            1~50,值為空時列舉所有分機組

            響應示例

            <?xml version="1.0" encoding="UTF-8"?>

            <Status> 

                <group id="1"> 

                    <ext id="200"/>

                    <ext id="208"/> 

                    <voicefile>NowMorning</voicefile>

                    <distribution>sequential</distribution>

                    <visitor id="27" from="02167103750" to="02161208234" callid="49162"/>

                    <visitor id="28" from="13012345678" to="02161204000" callid="49164"/>

                </group>

            </Status>

            解釋: 分機1內有兩個分機成員(分200和分208),當來電轉接到該分機組后,分機組按distribution(呼叫分配規則)的類型將呼叫分配給分機。當組內分機全忙,來電將會在分機組隊列中等待,等待音樂voicefile指定的語音文件。

            參數說明

            說明:<>表示必選項,[]表示可選項(當參數值為默認值或空時,響應消息可能不攜帶該參數)

            參數名稱

            類型

            說明

            <group id>

            int

            分機組的序號

            [voicefile]

            int

            語音文件,支datpcm兩種格式,這里為呼叫等待時播放的音樂

            [distribution]

            string

            有效值sequential(順選)、circular(輪選)、group(群振),默認值circular

            [ext]

            string

            分機,這里為該分機組中的分機成員

            [visitor]

            object

            來電,這里為正處于該分機組等待隊列中的來電

            <id>

            int

            來電的編號,可依據該參數對來電進行轉接、掛斷、查詢等操作

            <from>

            string

            原始主叫號碼

            <to>

            string

            原始被叫號碼(對visitor而言,原始被叫為來電呼入的中繼號碼)

            <callid>

            string

            通話的相對唯一標識符

            查詢語音菜單

            API用于查詢語音菜單的相關信息,如:配置參數(語音文件、撥號檢測長度、按鍵檢查結束符)、轉接到該菜單的呼叫信息等。

            請求示例

            <?xml version="1.0" encoding="utf-8" ?>

            <Control attribute="Query">

                <menu id="1"/>

            </Control>

            參數說明

            參數名稱

            類型

            參數說明

            參數值說明

            <menu id>

            int

            語音菜單的編號

            1~50,值為空表示列舉所有語音菜單

            響應示例

            <?xml version="1.0" encoding="utf-8" ?> 

            <Status>

            首頁標題    技術支持    技術文檔    設備類    OMAPI技術開發文檔20180208