🥇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^_^]
                            }
              ]

यो विधि दुई arrays पास गर्दछ। डोमेन प्रयोगकर्ताहरूसँग एक, डोमेन समूहहरूको साथ। समूहसँग अनुरोधमा पठाइने इमेल निर्दिष्ट गर्ने अवसर पनि छ।

आगमन कल बारे जानकारी प्रशोधन गर्दै

विभिन्न 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>"
}

हामी स्थिति ट्र्याक र कल रेकर्डिङ डाउनलोड

Rostelecom को भर्चुअल PBX मा, कल रेकर्डिङ तपाईंको व्यक्तिगत खातामा सक्रिय छ। एपीआई प्रयोग गरेर, तपाइँ यस प्रकार्यको स्थिति ट्र्याक गर्न सक्नुहुन्छ। कल टर्मिनेसन प्रशोधन गर्दा कल_घटनाहरू तपाईं झण्डा देख्न सक्नुहुन्छ 'is_record', जसले प्रयोगकर्तालाई प्रविष्टिको स्थिति बारे सूचित गर्दछ: साँचो यसको मतलब प्रयोगकर्ताको कल रेकर्डिङ प्रकार्य सक्षम छ।

रेकर्डिङ डाउनलोड गर्न, तपाईंले कल सत्र 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"
}

फाइल भण्डारण समय तपाईंको व्यक्तिगत खाता सेटिङहरूमा सेट गरिएको छ। पछि फाइल मेटिनेछ।

तथ्याङ्क र रिपोर्टिङ

तपाईंको व्यक्तिगत खातामा छुट्टै पृष्ठमा तपाईंले सबै कलहरूमा तथ्याङ्क र रिपोर्टिङ हेर्न सक्नुहुन्छ र स्थिति र समय अनुसार फिल्टरहरू लागू गर्न सक्नुहुन्छ। एपीआई मार्फत, तपाईंले पहिले विधिको साथ कल प्रक्रिया गर्नुपर्छ /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

Rostelecom भर्चुअल PBX: API मार्फत के र कसरी गर्न सकिन्छ