Виртуална PBX Rostelecom: какво и как може да се направи чрез API

Съвременният бизнес възприема стационарните телефони като остаряла технология: клетъчните комуникации осигуряват мобилност и постоянна наличност на служителите, социалните мрежи и месинджърите са по-лесен и бърз канал за комуникация. За да бъдат в крак с конкурентите си, офис телефонните централи стават все по-подобни на тях: те се преместват в облака, управляват се чрез уеб интерфейс и се интегрират с други системи чрез API. В тази публикация ще ви разкажем какви функции има API за виртуална PBX Rostelecom и как да работите с основните функции на виртуалната PBX чрез него.

Основната задача на API на виртуалната PBX Rostelecom е взаимодействието с CRM или фирмени уебсайтове. Например, API имплементира джаджи за „обратно обаждане“ и „обаждане от сайт“ за основните системи за управление: WordPress, Bitrix, OpenCart. API позволява:

• Получаване на информация, уведомяване за статус и извършване на повиквания при поискване от външна система;
• Вземете временна връзка за запис на разговора;
• Управление и получаване на параметри за ограничаване от потребителите;
• Получаване на информация за потребителя на виртуална телефонна централа;
• Поискайте хронологията на дебитите и таксите за разговори;
• Качване на регистър на обажданията.

Как работи API

Интеграционният API и външната система взаимодействат помежду си чрез HTTP заявки. В личния акаунт администраторът задава адресите, на които да пристигат заявките към API и на които да се изпращат заявките от API. Външната система трябва да има публичен адрес, достъпен от Интернет с инсталиран SSL сертификат.

Също така в личния акаунт администраторът на домейна може да ограничи източниците на заявки при достъп до API чрез IP. 

Получаваме информация за потребителите на виртуална телефонна централа 

За да получите списък с потребители или групи, трябва да изпратите заявка до виртуалната 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, трябва да използвате метода /get_number_info, който генерира списък с обаждания с информация за групата, към която се разпределя обаждането. Да приемем, че виртуалният 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":""
}

След това трябва да свържете манипулатора /get_number_info. Заявката трябва да бъде изпълнена, когато входящо повикване пристигне на входящата линия, преди повикванията да бъдат маршрутизирани. Ако отговор на заявка не бъде получен в рамките на определеното време, тогава повикването се насочва според правилата, установени в домейна.

Пример за манипулатор от страна на 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>"
}

Проследяваме състоянието и изтегляме записи на разговори

Във виртуалната PBX на Rostelecom записването на разговори се активира в личния ви акаунт. С помощта на API можете да проследявате състоянието на тази функция. При обработка на терминиране на разговор в call_events можете да видите знамето 'is_record', който уведомява потребителя за статуса на записа: вярно означава, че функцията за запис на разговори на потребителя е активирана.

За да изтеглите запис, трябва да използвате идентификатора на сесията на разговора сесиен идентификатор изпрати заявка до 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"
        }

След това извикайте метода call_info за обработка на масива и показване на обаждането в 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) е това, което чуваме в слушалката, преди лицето да отговори. По същество това е електронен оператор, който пренасочва обажданията към съответните отдели и отговаря автоматично на някои въпроси. Скоро ще бъде възможно да работите с IVR чрез API: в момента разработваме софтуер, който ще ви позволи да проследявате напредъка на разговор чрез IVR и да получавате информация за натискане на клавиши с тонално докосване, когато абонатът е в гласовото меню.

За да прехвърлите корпоративната телефония към мобилни телефони, можете или да използвате софтфон приложения, или отделно да активирате услугата Fixed Mobile Convergence (FMC). С който и да е от методите разговорите в мрежата са безплатни, става възможно да се работи с кратки номера, като разговорите могат да се записват и да се води обща статистика за тях. 

Разликата е, че софтуерните телефони се нуждаят от интернет, за да комуникират, но не са обвързани с оператор, докато FMC е обвързан с определен оператор, но може да се използва дори на стари телефони с бутони.

Източник: www.habr.com