रोस्टेलकॉम वर्चुअल पीबीएक्स: एपीआई के माध्यम से क्या और कैसे किया जा सकता है

आधुनिक व्यवसाय लैंडलाइन फोन को एक पुरानी तकनीक मानता है: सेलुलर संचार कर्मचारियों की गतिशीलता और निरंतर उपलब्धता सुनिश्चित करता है, सोशल नेटवर्क और त्वरित संदेशवाहक एक आसान और तेज़ संचार चैनल हैं। अपने प्रतिस्पर्धियों के साथ बने रहने के लिए, कार्यालय पीबीएक्स अधिक से अधिक उनके समान होते जा रहे हैं: वे क्लाउड पर जा रहे हैं, एक वेब इंटरफ़ेस के माध्यम से प्रबंधित होते हैं और एपीआई के माध्यम से अन्य प्रणालियों के साथ एकीकृत होते हैं। इस पोस्ट में हम आपको बताएंगे कि रोस्टेलकॉम वर्चुअल पीबीएक्स एपीआई के क्या कार्य हैं और इसके माध्यम से वर्चुअल पीबीएक्स के मुख्य कार्यों के साथ कैसे काम किया जाए।

रोस्टेलकॉम वर्चुअल पीबीएक्स एपीआई का मुख्य कार्य सीआरएम या कंपनी की वेबसाइटों के साथ बातचीत करना है। उदाहरण के लिए, एपीआई मुख्य प्रबंधन प्रणालियों के लिए "कॉल बैक" और "साइट से कॉल" विजेट लागू करता है: वर्डप्रेस, बिट्रिक्स, ओपनकार्ट। एपीआई अनुमति देता है:

• जानकारी प्राप्त करें, स्थिति सूचित करें और बाहरी सिस्टम से अनुरोध पर कॉल करें;
• बातचीत रिकॉर्ड करने के लिए एक अस्थायी लिंक प्राप्त करें;
• उपयोगकर्ताओं से प्रतिबंध पैरामीटर प्रबंधित करें और प्राप्त करें;
• वर्चुअल पीबीएक्स उपयोगकर्ता के बारे में जानकारी प्राप्त करें;
• कॉल डेबिट और शुल्क के इतिहास का अनुरोध करें;
• कॉल लॉग अपलोड करें.

एपीआई कैसे काम करता है

एकीकरण एपीआई और बाहरी सिस्टम HTTP अनुरोधों का उपयोग करके एक दूसरे के साथ बातचीत करते हैं। व्यक्तिगत खाते में, व्यवस्थापक उन पते को सेट करता है जहां एपीआई के लिए अनुरोध आने चाहिए और जहां एपीआई से अनुरोध भेजे जाने चाहिए। बाहरी सिस्टम में एक सार्वजनिक पता स्थापित एसएसएल प्रमाणपत्र के साथ इंटरनेट से पहुंच योग्य होना चाहिए।

व्यक्तिगत खाते में भी, आईपी द्वारा एपीआई तक पहुंचने पर डोमेन प्रशासक अनुरोधों के स्रोतों को सीमित कर सकता है। 

हमें वर्चुअल पीबीएक्स उपयोगकर्ताओं के बारे में जानकारी प्राप्त होती है 

उपयोगकर्ताओं या समूहों की सूची प्राप्त करने के लिए, आपको विधि का उपयोग करके वर्चुअल पीबीएक्स को एक अनुरोध भेजना होगा /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^_^]
                            }
              ]

यह विधि दो सरणियों से गुजरती है। एक डोमेन उपयोगकर्ताओं के साथ, एक डोमेन समूहों के साथ। समूह के पास एक ईमेल निर्दिष्ट करने का अवसर भी है जिसे अनुरोध में भेजा जाएगा।

आने वाली कॉल के बारे में जानकारी संसाधित करना

कॉर्पोरेट टेलीफोनी को विभिन्न सीआरएम प्रणालियों से जोड़ने से ग्राहकों के साथ बातचीत करने वाले कर्मचारियों का समय बचता है और इनकमिंग कॉल की प्रोसेसिंग तेज हो जाती है। उदाहरण के लिए, किसी मौजूदा ग्राहक के कॉल पर, सीआरएम उसका कार्ड खोल सकता है, और सीआरएम से आप ग्राहक को कॉल भेज सकते हैं और उसे एक कर्मचारी से जोड़ सकते हैं।

एपीआई कॉल के बारे में जानकारी प्राप्त करने के लिए, आपको विधि का उपयोग करने की आवश्यकता है /get_number_info, जो उस समूह के बारे में जानकारी के साथ कॉल की एक सूची तैयार करता है जिसमें कॉल वितरित की जाती है। आइए मान लें कि वर्चुअल पीबीएक्स नंबर को 1234567890 नंबर से एक इनकमिंग कॉल प्राप्त होती है। फिर पीबीएक्स निम्नलिखित अनुरोध भेजेगा:

{
        "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. जब इनकमिंग कॉल कॉल रूट होने से पहले इनकमिंग लाइन पर आती है तो अनुरोध निष्पादित किया जाना चाहिए। यदि किसी अनुरोध का जवाब निर्दिष्ट समय के भीतर प्राप्त नहीं होता है, तो कॉल को डोमेन में स्थापित नियमों के अनुसार रूट किया जाता है।

सीआरएम पक्ष पर एक हैंडलर का उदाहरण.

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>"
}

हम स्थिति को ट्रैक करते हैं और कॉल रिकॉर्डिंग डाउनलोड करते हैं

रोस्टेलकॉम के वर्चुअल पीबीएक्स में, कॉल रिकॉर्डिंग आपके व्यक्तिगत खाते में सक्रिय होती है। एपीआई का उपयोग करके, आप इस फ़ंक्शन की स्थिति को ट्रैक कर सकते हैं। कॉल समाप्ति की प्रक्रिया करते समय कॉल_इवेंट आप झंडा देख सकते हैं 'है_रिकॉर्ड', जो उपयोगकर्ता को प्रविष्टि की स्थिति के बारे में सूचित करता है: <strong>उद्देश्य</strong> इसका मतलब है कि उपयोगकर्ता का कॉल रिकॉर्डिंग फ़ंक्शन सक्षम है।

रिकॉर्डिंग डाउनलोड करने के लिए, आपको कॉल सत्र आईडी का उपयोग करना होगा सत्र आईडी को एक अनुरोध भेजें 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":""
        }
}

अन्य उपयोगी वर्चुअल पीबीएक्स सुविधाएँ

एपीआई के अलावा, वर्चुअल पीबीएक्स में कई अन्य उपयोगी सुविधाएं हैं जिनका आप उपयोग कर सकते हैं। उदाहरण के लिए, यह एक इंटरैक्टिव वॉयस मेनू और सेलुलर और फिक्स्ड संचार का एकीकरण है।

इंटरएक्टिव वॉयस रिस्पांस (आईवीआर) वह है जो हम व्यक्ति के उत्तर देने से पहले हैंडसेट पर सुनते हैं। अनिवार्य रूप से, यह एक इलेक्ट्रॉनिक ऑपरेटर है जो कॉल को उपयुक्त विभागों में पुनर्निर्देशित करता है और कुछ प्रश्नों का स्वचालित रूप से उत्तर देता है। जल्द ही एपीआई के माध्यम से आईवीआर के साथ काम करना संभव होगा: हम वर्तमान में सॉफ्टवेयर विकसित कर रहे हैं जो आपको आईवीआर के माध्यम से कॉल की प्रगति को ट्रैक करने और ग्राहक के वॉयस मेनू में होने पर टच-टोन कीस्ट्रोक्स के बारे में जानकारी प्राप्त करने की अनुमति देगा।

कॉर्पोरेट टेलीफोनी को मोबाइल फोन में स्थानांतरित करने के लिए, आप या तो सॉफ्टफोन एप्लिकेशन का उपयोग कर सकते हैं या अलग से फिक्स्ड मोबाइल कन्वर्जेंस (एफएमसी) सेवा को सक्रिय कर सकते हैं। किसी भी तरीके से, नेटवर्क के भीतर कॉल निःशुल्क होती हैं, छोटे नंबरों के साथ काम करना संभव हो जाता है, और कॉल को रिकॉर्ड किया जा सकता है और उन पर सामान्य आँकड़े रखे जा सकते हैं। 

अंतर यह है कि सॉफ्टफोन को संचार करने के लिए इंटरनेट की आवश्यकता होती है, लेकिन वे एक ऑपरेटर से बंधे नहीं होते हैं, जबकि एफएमसी एक विशिष्ट ऑपरेटर से जुड़ा होता है, लेकिन पुराने पुश-बटन फोन पर भी इसका उपयोग किया जा सकता है।

स्रोत: www.habr.com