主持人 > 博客 > 管理 > Rostelecom 虛擬 PBX：透過 API 可以做什麼以及如何做

Rostelecom 虛擬 PBX：透過 API 可以做什麼以及如何做

Rostelecom 虛擬 PBX：透過 API 可以做什麼以及如何做

現代企業認為固定電話是一種過時的技術：蜂窩通訊確保員工的行動性和持續可用性，而社交網路和即時通訊工具是更簡單、更快捷的通訊管道。 為了跟上競爭對手的步伐，辦公室 PBX 變得越來越相似：它們正在遷移到雲端，透過 Web 介面進行管理，並透過 API 與其他系統整合。 在這篇文章中，我們將告訴您Rostelecom虛擬PBX API有哪些功能以及如何透過它來使用虛擬PBX的主要功能。

Rostelecom 虛擬 PBX API 的主要任務是與 CRM 或公司網站互動。 例如，API 為主要管理系統實作了「回呼」和「從網站呼叫」小工具：WordPress、Bitrix、OpenCart。 該 API 允許：

  • 根據外部系統的請求接收訊息、通知狀態並撥打電話；
  • 取得臨時連結來記錄對話；
  • 管理和接收來自使用者的限制參數；
  • 取得虛擬PBX用戶資訊；
  • 請求通話借記和費用的歷史記錄；
  • 上傳通話記錄。

API 的工作原理

整合 API 和外部系統使用 HTTP 請求進行互動。 在個人帳戶中，管理員設定API請求應到達的地址以及API請求應發送的地址。 外部系統必須具有可透過 Internet 存取且已安裝 SSL 憑證的公共位址。

Rostelecom 虛擬 PBX：透過 API 可以做什麼以及如何做

同樣在個人帳戶中，網域管理員可以在透過IP存取API時限制請求來源。 

我們收到有關虛擬 PBX 用戶的信息 

要取得使用者或群組的列表，您需要使用以下方法向虛擬 PBX 發送請求 /使用者資訊.

{
        "domain":"example.ru"
}

作為回應，您將收到一個可以儲存的清單。

{
"result":0,
"resultMessage":"",
"users":[
                           {
                            "display_name":"test_user_1",
                            "name":"admin",
                            "pin":^_^quotʚquot^_^,
                           "is_supervisor":true,
                            "is_operator":false,
                            "email":"[email protected]","recording":1
                             },
                            {
                            "display_name":"test_user_2",
                            "name":"test",
                            "pin":^_^quotʿquot^_^,
                            "is_supervisor":true,
                            "is_operator":false,
                            "email":"",
                           "recording":1
                            }
              ],
"groups":
              [
                            {
                            "name":"testAPI",
                            "pin":^_^quotǴquot^_^,
                            "email":"[email protected]",
                            "distribution":1,
                           "users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^]
                            }
              ]

該方法傳遞兩個數組。 一種是網域用戶，一種是網域群組。 該群組還有機會指定將在請求中發送的電子郵件。

處理有關來電的信息

將企業電話連接到各種 CRM 系統可以節省與客戶互動的員工的時間，並加快來電的處理速度。 例如，噹噹前客戶打來電話時，CRM 可以打開他的卡，並且您可以從 CRM 向該客戶發送電話並將其與員工聯繫。

要獲取有關API呼叫的信息，您需要使用該方法 /獲取號碼信息，它產生一個呼叫列表，其中包含有關呼叫分配到的群組的資訊。 假設虛擬PBX號碼收到號碼1234567890的來電，那麼PBX將發送以下請求：

{
        "session_id":"SDsnZugDFmTW7Sec",
        "timestamp":"2019-12-27 15:34:44.461",
        "type":"incoming",
        "state":"new",
        "from_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
        "from_pin":"",
        "request_number":"sip:</i^_^gt�lt&i;gt^_^@1192.168.0.1",
        "request_pin":^_^quotɟquot^_^,
        "disconnect_reason":"",
        "is_record":""
}

接下來您需要連接處理程序 /獲取號碼信息。 當傳入呼叫到達傳入線路時，必須在呼叫被路由之前執行該請求。 如果在指定時間內未收到對請求的回應，則根據網域中建立的規則路由呼叫。

CRM 端處理程序的範例。

if ($account) {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент найден',
            	'displayName' => $account->name,
            	//'PIN' => $crm_users,
        	];
    	} 
        else 
                {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент не найден',
            	'displayName' => 'Неизвестный абонент '.$contact,
            	//'PIN' => crm_users,
        	];
    	}
    	return $data;

來自處理程序的回應。

{
        "result":0,
        "resultMessage":"Абонент найден",
        "displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}

我們追蹤狀態並下載通話錄音

在 Rostelecom 的虛擬 PBX 中，通話錄音會在您的個人帳戶中啟動。 使用 API，您可以追蹤此功能的狀態。 當處理呼叫終止時 呼叫事件 你可以看到旗幟 '是記錄', 它通知使用者有關條目的狀態： 真 表示使用者的通話錄音功能已開啟。

要下載錄音，您需要使用通話會話 ID 會話ID 發送請求至 api.cloudpbx.rt.ru/get_record。

{
        "session_id":"SDsnZugDFmTW7Sec"
}

作為回應，您將收到一個臨時鏈接，用於下載包含對話錄音的檔案。

{
        "result": ^_^quot�quot^_^,
        "resultMessage": "Операция выполнена успешно",
    	"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}

文件儲存時間在您的個人帳戶設定中設定。 之後該檔案將會被刪除。

統計和報告

在您的個人帳戶的單獨頁面上，您可以查看所有通話的統計資料和報告，並按狀態和時間套用篩選器。 透過API，首先要處理呼叫的方法 /call_events:

       {
        "session_id":"SDsnZugDFmTW7Sec",
        "timestamp":"2019-12-27 15:34:59.349",
        "type":"incoming",
        "state":"end",
        "from_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
        "from_pin":"",
        "request_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
        "request_pin":^_^quotʚquot^_^,
        "disconnect_reason":"",
        "is_record":"true"
        }

然後調用方法 呼叫訊息 處理陣列並在 CRM 系統中顯示通話。

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

作為回應，您將收到一組數據，可以對其進行處理以將數據儲存在 CRM 日誌中。

{
        "result":0,
        "resultMessage":"",
        "info":
        {
                "call_type":1,
                "direction":1,
                "state":1,
                "orig_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
                "orig_pin":null,
                "dest_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
                "answering_sipuri":"[email protected]",
                "answering_pin":^_^quotɟquot^_^,
                "start_call_date":^_^quot�quot^_^,
                "duration":14,
                 "session_log":"0:el:123456789;0:ru:admin;7:ct:admin;9:cc:admin;14:cd:admin;",
                "is_voicemail":false,
                "is_record":true,
                "is_fax":false,
                "status_code":^_^quot�quot^_^,
                "status_string":""
        }
}

其他有用的虛擬 PBX 功能

除了 API 之外，虛擬 PBX 還具有其他幾個可供您使用的實用功能。 例如，這是一個互動式語音選單以及蜂窩和固定通訊的整合。

互動式語音應答 (IVR) 是指在對方應答之前我們在聽筒中聽到的內容。 本質上，這是一個電子接線員，可以將呼叫重定向到適當的部門並自動回答一些問題。 很快就可以透過 API 與 IVR 搭配使用：我們目前正在開發軟體，讓您可以透過 IVR 追蹤呼叫進度，並在訂戶處於語音選單時接收有關按鍵式按鍵的資訊。

若要將公司電話轉移到手機上，您可以使用軟體電話應用程式或單獨啟動固定行動融合 (FMC) 服務。 使用任何一種方法，網路內的通話都是免費的，可以使用短號碼，並且可以記錄通話並對其進行一般統計。 

不同之處在於，軟體電話需要互聯網進行通信，但它們不與運營商綁定，而 FMC 與特定運營商綁定，但甚至可以在舊的按鍵電話上使用。

來源： www.habr.com

添加評論