ரோஸ்டெலெகாம் மெய்நிகர் பிபிஎக்ஸ்: ஏபிஐ மூலம் என்ன மற்றும் எப்படி செய்ய முடியும்

நவீன வணிகமானது லேண்ட்லைன் ஃபோன்களை காலாவதியான தொழில்நுட்பமாக கருதுகிறது: செல்லுலார் தகவல்தொடர்புகள் இயக்கம் மற்றும் ஊழியர்களின் நிலையான இருப்பை உறுதி செய்கின்றன, சமூக வலைப்பின்னல்கள் மற்றும் உடனடி தூதர்கள் எளிதான மற்றும் வேகமான தகவல் தொடர்பு சேனலாகும். தங்கள் போட்டியாளர்களுடன் தொடர்வதற்கு, அலுவலக பிபிஎக்ஸ்கள் அவர்களுக்கு மிகவும் ஒத்ததாகி வருகின்றன: அவை மேகக்கணிக்கு நகர்கின்றன, வலை இடைமுகம் மூலம் நிர்வகிக்கப்படுகின்றன மற்றும் API வழியாக மற்ற அமைப்புகளுடன் ஒருங்கிணைக்கப்படுகின்றன. இந்த இடுகையில், ரோஸ்டெலெகாம் மெய்நிகர் பிபிஎக்ஸ் ஏபிஐ என்ன செயல்பாடுகளைக் கொண்டுள்ளது மற்றும் மெய்நிகர் பிபிஎக்ஸின் முக்கிய செயல்பாடுகளுடன் எவ்வாறு செயல்படுவது என்பதை நாங்கள் உங்களுக்குக் கூறுவோம்.

ரோஸ்டெலெகாம் மெய்நிகர் பிபிஎக்ஸ் ஏபிஐயின் முக்கிய பணி சிஆர்எம் அல்லது நிறுவன வலைத்தளங்களுடனான தொடர்பு ஆகும். எடுத்துக்காட்டாக, 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 மூலம், நீங்கள் முதலில் அழைப்பை முறையுடன் செயல்படுத்த வேண்டும் /அழைப்பு_நிகழ்வுகள்:

       {
        "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 நீங்கள் பயன்படுத்தக்கூடிய பல பயனுள்ள அம்சங்களைக் கொண்டுள்ளது. எடுத்துக்காட்டாக, இது ஒரு ஊடாடும் குரல் மெனு மற்றும் செல்லுலார் மற்றும் நிலையான தகவல்தொடர்புகளின் ஒருங்கிணைப்பு.

இன்டராக்டிவ் வாய்ஸ் ரெஸ்பான்ஸ் (IVR) என்பது நபர் பதிலளிக்கும் முன் கைபேசியில் நாம் கேட்பது. முக்கியமாக, இது ஒரு மின்னணு ஆபரேட்டர் ஆகும், அவர் அழைப்புகளை பொருத்தமான துறைகளுக்கு திருப்பி விடுகிறார் மற்றும் சில கேள்விகளுக்கு தானாகவே பதிலளிக்கிறார். விரைவில் API மூலம் IVR உடன் பணிபுரிய முடியும்: IVR மூலம் அழைப்பின் முன்னேற்றத்தைக் கண்காணிக்கவும், சந்தாதாரர் குரல் மெனுவில் இருக்கும்போது டச்-டோன் கீஸ்ட்ரோக்குகளைப் பற்றிய தகவலைப் பெறவும் அனுமதிக்கும் மென்பொருளை நாங்கள் தற்போது உருவாக்கி வருகிறோம்.

கார்ப்பரேட் டெலிபோனியை மொபைல் போன்களுக்கு மாற்ற, நீங்கள் சாஃப்ட்ஃபோன் பயன்பாடுகளைப் பயன்படுத்தலாம் அல்லது நிலையான மொபைல் கன்வெர்ஜென்ஸ் (FMC) சேவையை தனித்தனியாக செயல்படுத்தலாம். எந்தவொரு முறையிலும், நெட்வொர்க்கில் உள்ள அழைப்புகள் இலவசம், குறுகிய எண்களுடன் வேலை செய்வது சாத்தியமாகும், மேலும் அழைப்புகளைப் பதிவு செய்யலாம் மற்றும் பொதுவான புள்ளிவிவரங்களை அவற்றில் வைத்திருக்கலாம். 

வித்தியாசம் என்னவென்றால், சாஃப்ட்ஃபோன்கள் தொடர்பு கொள்ள இணையம் தேவை, ஆனால் அவை ஒரு ஆபரேட்டருடன் இணைக்கப்படவில்லை, அதே நேரத்தில் FMC ஒரு குறிப்பிட்ட ஆபரேட்டருடன் இணைக்கப்பட்டுள்ளது, ஆனால் பழைய புஷ்-பட்டன் தொலைபேசிகளில் கூட பயன்படுத்தலாம்.

ஆதாரம்: www.habr.com