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

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

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

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

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

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



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

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

उपयोगकर्ताओं या समूहों की एक सूची प्राप्त करने के लिए, आपको / user_info पद्धति का उपयोग करके वर्चुअल 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":"test_user_1@mail.gov","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":"Ivanov@mail.gov",                            "distribution":1,                           "users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^]                            }              ] 

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

हम एक इनकमिंग कॉल के बारे में जानकारी संसाधित करते हैं

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

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

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

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

रोस्टेलकॉम के आभासी टेलीफोन एक्सचेंज में, वार्तालापों की रिकॉर्डिंग आपके व्यक्तिगत खाते में सक्रिय है। एपीआई का उपयोग करके, आप इस फ़ंक्शन की स्थिति को ट्रैक कर सकते हैं। 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" } 

फ़ाइल संग्रहण समय आपके व्यक्तिगत खाते की सेटिंग में सेट किया गया है। फाइल डिलीट होने के बाद।

सांख्यिकी और रिपोर्टिंग

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

    {        "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":"admin@example.ru",                "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&#0;quot^_^,                "status_string":""        } } 

अन्य उपयोगी आभासी पीबीएक्स सुविधाएँ

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

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

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

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