Rostelecom virtual PBX: API හරහා කළ හැක්කේ කුමක්ද සහ කෙසේද

නවීන ව්‍යාපාර ස්ථාවර දුරකථන යල් පැන ගිය තාක්‍ෂණයක් ලෙස සලකයි: සෙලියුලර් සන්නිවේදනය මඟින් සේවකයින්ගේ සංචලතාව සහ නිරන්තර ලබා ගැනීම සහතික කරයි, සමාජ ජාල සහ ක්ෂණික පණිවිඩකරුවන් පහසු සහ වේගවත් සන්නිවේදන නාලිකාවකි. ඔවුන්ගේ තරඟකරුවන් සමඟ ඉදිරියට යාමට, කාර්යාලීය PBX ඔවුන්ට වඩ වඩාත් සමාන වෙමින් පවතී: ඔවුන් වලාකුළු වෙත ගමන් කරයි, වෙබ් අතුරු මුහුණතක් හරහා කළමනාකරණය කර API හරහා අනෙකුත් පද්ධති සමඟ ඒකාබද්ධ වේ. මෙම ලිපියෙන් අපි Rostelecom virtual PBX API සතුව ඇති කාර්යයන් මොනවාද සහ එය හරහා අථත්‍ය PBX හි ප්‍රධාන කාර්යයන් සමඟ වැඩ කරන්නේ කෙසේද යන්න අපි ඔබට කියමු.

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

මෙම ක්‍රමය අරා දෙකක් පසු කරයි. එකක් වසම් පරිශීලකයන් සමඟ, එකක් වසම් කණ්ඩායම් සමඟ. ඉල්ලීමෙහි එවන විද්‍යුත් තැපෑලක් සඳහන් කිරීමට ද සමූහයට අවස්ථාව තිබේ.

එන ඇමතුමක් පිළිබඳ තොරතුරු සැකසීම

විවිධ CRM පද්ධති වෙත ආයතනික දුරකථන සම්බන්ධ කිරීම සේවාදායකයින් සමඟ අන්තර් ක්‍රියා කරන සේවකයින් සඳහා කාලය ඉතිරි කරන අතර ලැබෙන ඇමතුම් සැකසීම වේගවත් කරයි. උදාහරණයක් ලෙස, වත්මන් සේවාදායකයෙකුගෙන් ඇමතුමක් මත, CRM හට ඔහුගේ කාඩ්පත විවෘත කළ හැකි අතර, CRM වෙතින් ඔබට සේවාදායකයාට ඇමතුමක් යැවීමට සහ ඔහු සේවකයෙකු සමඟ සම්බන්ධ කළ හැකිය.

API ඇමතුම් පිළිබඳ තොරතුරු ලබා ගැනීමට, ඔබ ක්‍රමය භාවිතා කළ යුතුය /ලබන්න_අංක_තොරතුරු, එය ඇමතුම බෙදා හරින කණ්ඩායම පිළිබඳ තොරතුරු සහිත ඇමතුම් ලැයිස්තුවක් ජනනය කරයි. අපි හිතමු අතථ්‍ය 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":""
}

ඊළඟට ඔබ හසුරුවන්නා සම්බන්ධ කළ යුතුය /ලබන්න_අංක_තොරතුරු. ඇමතුම් හරවා යැවීමට පෙර ලැබෙන ඇමතුමක් පැමිණෙන රේඛාවට පැමිණෙන විට ඉල්ලීම ක්රියාත්මක කළ යුතුය. නියමිත කාලය තුළ ඉල්ලීමකට ප්‍රතිචාරයක් නොලැබුනේ නම්, වසම තුළ ස්ථාපිත නීතිවලට අනුව ඇමතුම යොමු කෙරේ.

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 භාවිතයෙන්, ඔබට මෙම කාර්යයේ තත්ත්වය නිරීක්ෂණය කළ හැකිය. ඇමතුම අවසන් කිරීම සැකසීමේදී ඇමතුම්_සිදුවීම් ඔබට ධජය දැකිය හැකිය 'වාර්තාව_ය', ප්‍රවේශයේ තත්ත්වය ගැන පරිශීලකයාට දැනුම් දෙන: සැබෑ පරිශීලකයාගේ ඇමතුම් පටිගත කිරීමේ කාර්යය සක්රිය කර ඇති බවයි.

පටිගත කිරීමක් බාගැනීමට, ඔබ ඇමතුම් සැසි හැඳුනුම්පත භාවිතා කළ යුතුය සැසි_අද වෙත ඉල්ලීමක් යවන්න 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"
        }

ඉන්පසු ක්රමය අමතන්න ඇමතුම්_තොරතුරු අරාව සැකසීමට සහ 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 ඔබට භාවිතා කළ හැකි තවත් ප්‍රයෝජනවත් විශේෂාංග කිහිපයක් ඇත. උදාහරණයක් ලෙස, මෙය අන්තර් ක්රියාකාරී හඬ මෙනුවක් සහ සෛලීය සහ ස්ථාවර සන්නිවේදනයන් ඒකාබද්ධ කිරීමකි.

Interactive Voice Response (IVR) යනු පුද්ගලයා පිළිතුරු දීමට පෙර ජංගම දුරකථනයෙන් අපට ඇසෙන දෙයයි. අත්‍යවශ්‍යයෙන්ම, මෙය විද්‍යුත් ක්‍රියාකරුවෙකු වන අතර ඔහු ඇමතුම් සුදුසු දෙපාර්තමේන්තු වෙත හරවා යවන අතර සමහර ප්‍රශ්නවලට ස්වයංක්‍රීයව පිළිතුරු සපයයි. නුදුරේදීම API හරහා IVR සමඟ වැඩ කිරීමට හැකි වනු ඇත: අපි දැනට ඔබට IVR හරහා ඇමතුමක ප්‍රගතිය නිරීක්ෂණය කිරීමට සහ ග්‍රාහකයා හඬ මෙනුවේ සිටින විට ටච්-ටෝන් යතුරු පහර පිළිබඳ තොරතුරු ලබා ගැනීමට ඉඩ සලසන මෘදුකාංගයක් සංවර්ධනය කරමින් සිටිමු.

ආයතනික දුරකථන ජංගම දුරකථන වෙත මාරු කිරීම සඳහා, ඔබට මෘදු දුරකථන යෙදුම් භාවිතා කළ හැකිය, නැතහොත් ස්ථාවර ජංගම අභිසාරී (FMC) සේවාව වෙන වෙනම සක්‍රිය කළ හැකිය. ඕනෑම ක්‍රමයක් සමඟ, ජාලය තුළ ඇමතුම් නොමිලේ, කෙටි අංක සමඟ වැඩ කිරීමට හැකි වන අතර ඇමතුම් පටිගත කළ හැකි අතර සාමාන්‍ය සංඛ්‍යාලේඛන ඒවා මත තබා ගත හැකිය. 

වෙනස වන්නේ මෘදු දුරකථනවලට සන්නිවේදනය කිරීමට අන්තර්ජාලය අවශ්‍ය වන නමුත් ඒවා ක්‍රියාකරුවෙකු සමඟ බැඳී නොමැති අතර FMC නිශ්චිත ක්‍රියාකරුවෙකු සමඟ බැඳී ඇති නමුත් පැරණි තල්ලු බොත්තම් දුරකථනවල පවා භාවිතා කළ හැකිය.

මූලාශ්රය: www.habr.com