Rostelecom virtual PBX- API မှတဆင့် မည်သို့လုပ်ဆောင်နိုင်သည်

ခေတ်သစ်လုပ်ငန်းသည် ကြိုးဖုန်းများကို ခေတ်မမီတော့သော နည်းပညာတစ်ခုအဖြစ် ခံယူထားသည်- ဆယ်လူလာဆက်သွယ်ရေးသည် ဝန်ထမ်းများ၏ ရွေ့လျားမှုနှင့် အဆက်မပြတ်ရရှိနိုင်မှုကို သေချာစေရန်၊ လူမှုကွန်ရက်များနှင့် လက်ငင်းသတင်းပို့သူများသည် ပိုမိုလွယ်ကူမြန်ဆန်သော ဆက်သွယ်ရေးလမ်းကြောင်းတစ်ခုဖြစ်သည်။ ၎င်းတို့၏ပြိုင်ဘက်များနှင့် လိုက်လျောညီထွေဖြစ်စေရန်၊ ရုံး PBX များသည် ၎င်းတို့နှင့် ပို၍ဆင်တူလာသည်- ၎င်းတို့သည် cloud သို့ပြောင်းရွှေ့ကာ ဝဘ်အင်တာဖေ့စ်မှတစ်ဆင့် စီမံခန့်ခွဲကာ API မှတစ်ဆင့် အခြားစနစ်များနှင့် ပေါင်းစပ်ထားသည်။ ဤပို့စ်တွင် Rostelecom virtual PBX API တွင် မည်သည့်လုပ်ဆောင်ချက်များနှင့် ၎င်းကိုဖြတ်၍ virtual PBX ၏အဓိကလုပ်ဆောင်ချက်များနှင့် မည်သို့လုပ်ဆောင်ရမည်ကို ကျွန်ုပ်တို့ပြောပြပါမည်။

Rostelecom virtual PBX API ၏အဓိကတာဝန်မှာ CRM သို့မဟုတ် ကုမ္ပဏီဝဘ်ဆိုဒ်များနှင့် အပြန်အလှန်တုံ့ပြန်ခြင်းဖြစ်သည်။ ဥပမာအားဖြင့်၊ API သည် ပင်မစီမံခန့်ခွဲမှုစနစ်များ- WordPress၊ Bitrix၊ OpenCart အတွက် "ပြန်ခေါ်ရန်" နှင့် "ဆိုက်မှခေါ်ဆိုမှု" ဝစ်ဂျက်များကို လုပ်ဆောင်သည်။ API သည် ခွင့်ပြုသည်-

• သတင်းအချက်အလက်ရယူပါ၊ အခြေအနေကိုအကြောင်းကြားပြီး ပြင်ပစနစ်တစ်ခုမှ တောင်းဆိုမှုအပေါ် ဖုန်းခေါ်ဆိုပါ။
• စကားဝိုင်းကို မှတ်တမ်းတင်ရန် ယာယီလင့်ခ်ကို ရယူပါ။
• အသုံးပြုသူများထံမှ ကန့်သတ်ဘောင်များကို စီမံခန့်ခွဲခြင်းနှင့် လက်ခံခြင်း၊
• virtual PBX အသုံးပြုသူအကြောင်း အချက်အလက်ရယူပါ။
• ဖုန်းခေါ်ဆိုခ နှင့် အခကြေးငွေများ၏ မှတ်တမ်းကို တောင်းဆိုပါ။
• ခေါ်ဆိုမှုမှတ်တမ်းကို အပ်လုဒ်လုပ်ပါ။

API ဘယ်လိုအလုပ်လုပ်လဲ။

ပေါင်းစည်းခြင်း API နှင့် ပြင်ပစနစ်သည် HTTP တောင်းဆိုမှုများကို အသုံးပြု၍ အပြန်အလှန် တုံ့ပြန်သည်။ ကိုယ်ရေးကိုယ်တာအကောင့်တွင်၊ အက်ဒမင်သည် API သို့တောင်းဆိုမှုများရောက်ရှိမည့်လိပ်စာများနှင့် API မှတောင်းဆိုချက်များကိုပေးပို့သင့်သည့်နေရာများကိုသတ်မှတ်ပေးသည်။ ပြင်ပစနစ်တွင် ထည့်သွင်းထားသော SSL လက်မှတ်ဖြင့် အင်တာနက်မှ ဝင်ရောက်နိုင်သော အများသူငှာလိပ်စာတစ်ခု ရှိရပါမည်။

ကိုယ်ရေးကိုယ်တာအကောင့်တွင်လည်း၊ ဒိုမိန်းစီမံခန့်ခွဲသူက IP ဖြင့် API ကိုဝင်ရောက်သည့်အခါ တောင်းဆိုချက်များ၏ရင်းမြစ်များကို ကန့်သတ်နိုင်သည်။ 

ကျွန်ုပ်တို့သည် virtual PBX အသုံးပြုသူများအကြောင်း အချက်အလက်များကို လက်ခံရရှိပါသည်။ 

အသုံးပြုသူများ သို့မဟုတ် အုပ်စုများစာရင်းကို ရယူရန် နည်းလမ်းကို အသုံးပြု၍ virtual 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^_^]
                            }
              ]

ဤနည်းလမ်းသည် array နှစ်ခုကိုဖြတ်သန်းသည်။ တစ်ခုမှာ ဒိုမိန်းအသုံးပြုသူများ၊ တစ်ခုမှာ ဒိုမိန်းအုပ်စုများဖြစ်သည်။ အဖွဲ့သည် တောင်းဆိုချက်တွင် ပေးပို့မည့် အီးမေးလ်ကို သတ်မှတ်ရန် အခွင့်အရေးလည်း ရှိသည်။

အဝင်ခေါ်ဆိုမှုဆိုင်ရာ အချက်အလက်ကို လုပ်ဆောင်နေပါသည်။

ကော်ပိုရိတ်တယ်လီဖုန်းများကို 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":""
}

နောက်တစ်ခုကတော့ handler ကို ချိတ်ဆက်ရပါမယ်။ /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 ၏ virtual 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"
        }

ပြီးရင် method ကိုခေါ်ပါ။ call_info array ကိုလုပ်ဆောင်ရန်နှင့် 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":""
        }
}

အခြားအသုံးဝင်သော virtual PBX အင်္ဂါရပ်များ

API အပြင်၊ virtual PBX တွင် သင်အသုံးပြုနိုင်သည့် အခြားအသုံးဝင်သော အင်္ဂါရပ်များစွာရှိသည်။ ဥပမာအားဖြင့်၊ ၎င်းသည် အပြန်အလှန်တုံ့ပြန်သောအသံမီနူးတစ်ခုဖြစ်ပြီး ဆယ်လူလာနှင့် ပုံသေဆက်သွယ်မှုများ၏ပေါင်းစပ်မှုဖြစ်သည်။

အပြန်အလှန်တုံ့ပြန်သောအသံတုံ့ပြန်မှု (IVR) သည် လူမဖြေမီ ဟန်းဆက်ပေါ်တွင် ကျွန်ုပ်တို့ကြားရသည့်အရာဖြစ်သည်။ အခြေခံအားဖြင့်၊ ၎င်းသည် သက်ဆိုင်ရာဌာနများသို့ ဖုန်းခေါ်ဆိုမှုများကို ပြန်ညွှန်းကာ မေးခွန်းအချို့ကို အလိုအလျောက်ဖြေကြားပေးသည့် အီလက်ထရွန်နစ်အော်ပရေတာတစ်ခုဖြစ်သည်။ မကြာမီ API မှတစ်ဆင့် IVR နှင့် အလုပ်လုပ်နိုင်လိမ့်မည်- ကျွန်ုပ်တို့သည် IVR မှတစ်ဆင့် ဖုန်းခေါ်ဆိုမှုတိုးတက်မှုကို ခြေရာခံနိုင်ပြီး စာရင်းသွင်းသူသည် အသံမီနူးတွင် ရှိနေချိန်တွင် ထိတွေ့မှုခလုတ်များအကြောင်း အချက်အလက်များကို လက်ခံရရှိစေမည့် ဆော့ဖ်ဝဲလ်ကို လောလောဆယ် တီထွင်လျက်ရှိသည်။

ကော်ပိုရိတ်တယ်လီဖုန်းများကို မိုဘိုင်းလ်ဖုန်းများသို့ လွှဲပြောင်းရန်၊ သင်သည် softphone အပလီကေးရှင်းများကို သုံးနိုင်သည် သို့မဟုတ် Fixed Mobile Convergence (FMC) ဝန်ဆောင်မှုကို သီးခြားဖွင့်နိုင်သည်။ မည်သည့်နည်းလမ်းဖြင့်မဆို၊ ကွန်ရက်အတွင်းခေါ်ဆိုမှုများသည် အခမဲ့ဖြစ်ပြီး၊ ၎င်းသည် နံပါတ်တိုများဖြင့် လုပ်ဆောင်နိုင်ကာ ခေါ်ဆိုမှုများကို မှတ်တမ်းတင်နိုင်ပြီး အထွေထွေစာရင်းအင်းများကို ၎င်းတို့တွင် ထိန်းသိမ်းထားနိုင်သည်။ 

ကွာခြားချက်မှာ ဆော့ဖ်ဝဲလ်များသည် ဆက်သွယ်ရန်အတွက် အင်တာနက် လိုအပ်သော်လည်း ၎င်းတို့ကို အော်ပရေတာတစ်ခုနှင့် ချိတ်ဆက်ထားခြင်း မဟုတ်ဘဲ FMC ကို သီးခြားအော်ပရေတာတစ်ခုနှင့် ချိတ်ဆက်ထားသော်လည်း ခလုတ်နှိပ်ထားသော ဖုန်းအဟောင်းများတွင်ပင် အသုံးပြုနိုင်သည်။

source: www.habr.com