Rostelecom ვირტუალური PBX: რა და როგორ შეიძლება გაკეთდეს API-ს საშუალებით

თანამედროვე ბიზნესი აღიქვამს სახმელეთო ტელეფონებს, როგორც მოძველებულ ტექნოლოგიას: ფიჭური კომუნიკაციები უზრუნველყოფს თანამშრომლების მობილურობას და მუდმივ ხელმისაწვდომობას, სოციალური ქსელები და მყისიერი მესინჯერები უფრო მარტივი და სწრაფი საკომუნიკაციო არხია. კონკურენტებთან შესანარჩუნებლად, საოფისე PBX-ები სულ უფრო და უფრო ემსგავსებიან მათ: ისინი გადადიან ღრუბელში, იმართება ვებ ინტერფეისის მეშვეობით და ინტეგრირებულია სხვა სისტემებთან API-ის საშუალებით. ამ პოსტში ჩვენ გეტყვით რა ფუნქციები აქვს Rostelecom-ის ვირტუალურ PBX API-ს და როგორ ვიმუშაოთ ვირტუალური PBX-ის ძირითად ფუნქციებთან მისი მეშვეობით.

Rostelecom-ის ვირტუალური PBX API-ის მთავარი ამოცანაა CRM ან კომპანიის ვებსაიტებთან ურთიერთქმედება. მაგალითად, API ახორციელებს ვიჯეტებს „უკან“ და „გამოძახება საიტიდან“ მართვის ძირითადი სისტემებისთვის: WordPress, Bitrix, OpenCart. API იძლევა საშუალებას:

• ინფორმაციის მიღება, სტატუსის შესახებ შეტყობინება და ზარების განხორციელება გარე სისტემიდან მოთხოვნის შემთხვევაში;
• მიიღეთ დროებითი ბმული საუბრის ჩასაწერად;
• შეზღუდვის პარამეტრების მართვა და მიღება მომხმარებლებისგან;
• მოიპოვეთ ინფორმაცია ვირტუალური PBX მომხმარებლის შესახებ;
• მოითხოვეთ ზარის დებეტებისა და გადასახადების ისტორია;
• ატვირთეთ ზარების ჟურნალი.

როგორ მუშაობს API

ინტეგრაციის API და გარე სისტემა ურთიერთქმედებენ ერთმანეთთან HTTP მოთხოვნების გამოყენებით. პირად ანგარიშში ადმინისტრატორი ადგენს მისამართებს, სადაც უნდა მივიდეს მოთხოვნები API-სთვის და სად უნდა გაიგზავნოს მოთხოვნები API-დან. გარე სისტემას უნდა ჰქონდეს საჯარო მისამართი, რომელიც ხელმისაწვდომი იქნება ინტერნეტიდან დაინსტალირებული SSL სერთიფიკატით.

ასევე პირად ანგარიშში, დომენის ადმინისტრატორს შეუძლია შეზღუდოს მოთხოვნის წყაროები IP-ით API-ზე წვდომისას. 

ჩვენ ვიღებთ ინფორმაციას ვირტუალური PBX მომხმარებლების შესახებ 

მომხმარებელთა ან ჯგუფების სიის მისაღებად, თქვენ უნდა გაგზავნოთ მოთხოვნა ვირტუალურ PBX-ზე ამ მეთოდის გამოყენებით /users_info.

{
        "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-ის გამოყენებით შეგიძლიათ თვალყური ადევნოთ ამ ფუნქციის სტატუსს. ზარის შეწყვეტის დამუშავებისას მოწოდება_მოვლენები შეგიძლიათ ნახოთ დროშა 'is_record', რომელიც აცნობებს მომხმარებელს შესვლის სტატუსის შესახებ: მართალია ნიშნავს, რომ ჩართულია მომხმარებლის ზარის ჩაწერის ფუნქცია.

ჩანაწერის ჩამოსატვირთად, თქვენ უნდა გამოიყენოთ ზარის სესიის ID session_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"
        }

შემდეგ გამოიძახეთ მეთოდი 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-ის საშუალებით და მიიღოთ ინფორმაცია სენსორული ღილაკების დაჭერის შესახებ, როდესაც აბონენტი იმყოფება ხმოვან მენიუში.

კორპორატიული ტელეფონის მობილურ ტელეფონებზე გადასატანად შეგიძლიათ გამოიყენოთ რბილი ტელეფონის აპლიკაციები ან ცალკე გაააქტიუროთ ფიქსირებული მობილური კონვერგენციის (FMC) სერვისი. ნებისმიერი მეთოდით ქსელში ზარები უფასოა, შესაძლებელი ხდება მოკლე ნომრებით მუშაობა, ზარების ჩაწერა და მათზე ზოგადი სტატისტიკის შენახვა. 

განსხვავება ისაა, რომ რბილ ტელეფონებს სჭირდებათ ინტერნეტი კომუნიკაციისთვის, მაგრამ ისინი არ არიან მიბმული ოპერატორთან, ხოლო FMC არის მიბმული კონკრეტულ ოპერატორთან, მაგრამ შეიძლება გამოყენებულ იქნას ღილაკიანი ძველ ტელეფონებზეც კი.

წყარო: www.habr.com