Rostelecom വെർച്വൽ PBX: API വഴി എന്ത്, എങ്ങനെ ചെയ്യാം

ആധുനിക ബിസിനസ്സ് ലാൻഡ്‌ലൈൻ ഫോണുകളെ കാലഹരണപ്പെട്ട സാങ്കേതികവിദ്യയായി കാണുന്നു: സെല്ലുലാർ ആശയവിനിമയങ്ങൾ ജീവനക്കാരുടെ ചലനാത്മകതയും സ്ഥിരമായ ലഭ്യതയും ഉറപ്പാക്കുന്നു, സോഷ്യൽ നെറ്റ്‌വർക്കുകളും തൽക്ഷണ സന്ദേശവാഹകരും എളുപ്പവും വേഗത്തിലുള്ളതുമായ ആശയവിനിമയ ചാനലാണ്. അവരുടെ എതിരാളികളുമായി മുന്നോട്ടുപോകാൻ, ഓഫീസ് PBX-കൾ അവരോട് കൂടുതൽ സാമ്യമുള്ളതായി മാറുന്നു: അവ ക്ലൗഡിലേക്ക് നീങ്ങുന്നു, ഒരു വെബ് ഇന്റർഫേസ് വഴി നിയന്ത്രിക്കുകയും API വഴി മറ്റ് സിസ്റ്റങ്ങളുമായി സംയോജിപ്പിക്കുകയും ചെയ്യുന്നു. റോസ്റ്റെലെകോം വെർച്വൽ പിബിഎക്സ് എപിഐയുടെ പ്രവർത്തനങ്ങളെക്കുറിച്ചും അതിലൂടെ വെർച്വൽ പിബിഎക്സിന്റെ പ്രധാന പ്രവർത്തനങ്ങളുമായി എങ്ങനെ പ്രവർത്തിക്കാമെന്നും ഈ പോസ്റ്റിൽ ഞങ്ങൾ നിങ്ങളോട് പറയും.

Rostelecom വെർച്വൽ PBX API യുടെ പ്രധാന ദൌത്യം CRM അല്ലെങ്കിൽ കമ്പനി വെബ്സൈറ്റുകളുമായുള്ള ആശയവിനിമയമാണ്. ഉദാഹരണത്തിന്, API പ്രധാന മാനേജ്മെന്റ് സിസ്റ്റങ്ങൾക്കായി "കോൾ ബാക്ക്", "സൈറ്റിൽ നിന്നുള്ള കോൾ" വിജറ്റുകൾ നടപ്പിലാക്കുന്നു: WordPress, Bitrix, OpenCart. API അനുവദിക്കുന്നു:

• ഒരു ബാഹ്യ സിസ്റ്റത്തിൽ നിന്നുള്ള അഭ്യർത്ഥന പ്രകാരം വിവരങ്ങൾ സ്വീകരിക്കുക, സ്റ്റാറ്റസ് അറിയിക്കുക, കോളുകൾ ചെയ്യുക;
• സംഭാഷണം റെക്കോർഡ് ചെയ്യാൻ ഒരു താൽക്കാലിക ലിങ്ക് നേടുക;
• ഉപയോക്താക്കളിൽ നിന്ന് നിയന്ത്രണ പാരാമീറ്ററുകൾ നിയന്ത്രിക്കുകയും സ്വീകരിക്കുകയും ചെയ്യുക;
• വെർച്വൽ PBX ഉപയോക്താവിനെക്കുറിച്ചുള്ള വിവരങ്ങൾ നേടുക;
• കോൾ ഡെബിറ്റുകളുടെയും ചാർജുകളുടെയും ചരിത്രം അഭ്യർത്ഥിക്കുക;
• കോൾ ലോഗ് അപ്‌ലോഡ് ചെയ്യുക.

API എങ്ങനെ പ്രവർത്തിക്കുന്നു

HTTP അഭ്യർത്ഥനകൾ ഉപയോഗിച്ച് ഇന്റഗ്രേഷൻ API ഉം ബാഹ്യ സിസ്റ്റവും പരസ്പരം സംവദിക്കുന്നു. വ്യക്തിഗത അക്കൗണ്ടിൽ, എപിഐയിലേക്കുള്ള അഭ്യർത്ഥനകൾ എവിടെ എത്തണം, എപിഐയിൽ നിന്നുള്ള അഭ്യർത്ഥനകൾ എവിടേക്കാണ് അയയ്‌ക്കേണ്ടത് എന്നീ വിലാസങ്ങൾ അഡ്മിനിസ്ട്രേറ്റർ സജ്ജീകരിക്കുന്നു. ഇൻസ്‌റ്റാൾ ചെയ്‌ത SSL സർട്ടിഫിക്കറ്റിനൊപ്പം ഇൻറർനെറ്റിൽ നിന്ന് ആക്‌സസ് ചെയ്യാവുന്ന ഒരു പൊതു വിലാസം ബാഹ്യ സിസ്റ്റത്തിന് ഉണ്ടായിരിക്കണം.

കൂടാതെ വ്യക്തിഗത അക്കൗണ്ടിൽ, ഐപി വഴി 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 കോളുകളെക്കുറിച്ചുള്ള വിവരങ്ങൾ ലഭിക്കാൻ, നിങ്ങൾ രീതി ഉപയോഗിക്കേണ്ടതുണ്ട് /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-ൽ, നിങ്ങളുടെ സ്വകാര്യ അക്കൗണ്ടിൽ കോൾ റെക്കോർഡിംഗ് സജീവമാണ്. API ഉപയോഗിച്ച്, നിങ്ങൾക്ക് ഈ ഫംഗ്ഷന്റെ നില ട്രാക്ക് ചെയ്യാൻ കഴിയും. ഒരു കോൾ ടെർമിനേഷൻ പ്രോസസ് ചെയ്യുമ്പോൾ call_events നിങ്ങൾക്ക് പതാക കാണാം 'ഇസ്_റെക്കോർഡ്', എൻട്രിയുടെ നിലയെക്കുറിച്ച് ഉപയോക്താവിനെ അറിയിക്കുന്നത്: യഥാർഥ ഉപയോക്താവിന്റെ കോൾ റെക്കോർഡിംഗ് പ്രവർത്തനം പ്രവർത്തനക്ഷമമാക്കിയിരിക്കുന്നു എന്നാണ് അർത്ഥമാക്കുന്നത്.

ഒരു റെക്കോർഡിംഗ് ഡൗൺലോഡ് ചെയ്യാൻ, നിങ്ങൾ കോൾ സെഷൻ ഐഡി ഉപയോഗിക്കേണ്ടതുണ്ട് സെഷൻ ഐഡി എന്നതിലേക്ക് ഒരു അഭ്യർത്ഥന അയയ്ക്കുക 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). അടിസ്ഥാനപരമായി, ഇത് ഉചിതമായ വകുപ്പുകളിലേക്ക് കോളുകൾ റീഡയറക്‌ട് ചെയ്യുകയും ചില ചോദ്യങ്ങൾക്ക് സ്വയമേവ ഉത്തരം നൽകുകയും ചെയ്യുന്ന ഒരു ഇലക്ട്രോണിക് ഓപ്പറേറ്ററാണ്. ഉടൻ തന്നെ API വഴി IVR-നൊപ്പം പ്രവർത്തിക്കാൻ സാധിക്കും: IVR-ലൂടെ കോളിന്റെ പുരോഗതി ട്രാക്ക് ചെയ്യാനും സബ്‌സ്‌ക്രൈബർ വോയ്‌സ് മെനുവിൽ ആയിരിക്കുമ്പോൾ ടച്ച്-ടോൺ കീസ്‌ട്രോക്കുകളെക്കുറിച്ചുള്ള വിവരങ്ങൾ സ്വീകരിക്കാനും നിങ്ങളെ അനുവദിക്കുന്ന സോഫ്‌റ്റ്‌വെയർ ഞങ്ങൾ നിലവിൽ വികസിപ്പിക്കുകയാണ്.

കോർപ്പറേറ്റ് ടെലിഫോണി മൊബൈൽ ഫോണുകളിലേക്ക് മാറ്റുന്നതിന്, നിങ്ങൾക്ക് ഒന്നുകിൽ സോഫ്റ്റ്‌ഫോൺ ആപ്ലിക്കേഷനുകൾ ഉപയോഗിക്കാം അല്ലെങ്കിൽ ഫിക്സഡ് മൊബൈൽ കൺവെർജൻസ് (എഫ്എംസി) സേവനം പ്രത്യേകം സജീവമാക്കാം. ഏതെങ്കിലും രീതികൾ ഉപയോഗിച്ച്, നെറ്റ്‌വർക്കിനുള്ളിലെ കോളുകൾ സൌജന്യമാണ്, ചെറിയ നമ്പറുകളിൽ പ്രവർത്തിക്കാൻ സാധിക്കും, കൂടാതെ കോളുകൾ റെക്കോർഡ് ചെയ്യാനും പൊതുവായ സ്ഥിതിവിവരക്കണക്കുകൾ അവയിൽ സൂക്ഷിക്കാനും കഴിയും. 

സോഫ്റ്റ്‌ഫോണുകൾക്ക് ആശയവിനിമയം നടത്താൻ ഇന്റർനെറ്റ് ആവശ്യമാണ് എന്നതാണ് വ്യത്യാസം, എന്നാൽ അവ ഒരു ഓപ്പറേറ്ററുമായി ബന്ധിപ്പിച്ചിട്ടില്ല, അതേസമയം FMC ഒരു നിർദ്ദിഷ്ട ഓപ്പറേറ്ററുമായി ബന്ധിപ്പിച്ചിരിക്കുന്നു, എന്നാൽ പഴയ പുഷ്-ബട്ടൺ ഫോണുകളിൽ പോലും ഇത് ഉപയോഗിക്കാൻ കഴിയും.

അവലംബം: www.habr.com