🥇Rostelecom Virtual PBX: maxaa iyo sidee lagu samayn karaa API

Ganacsiga casriga ahi wuxuu u arkaa telefoonada dhulka inay yihiin tignoolajiyad duugowday: isgaadhsiinta gacanta ayaa hubisa dhaqdhaqaaqa iyo helitaanka joogtada ah ee shaqaalaha, shabakadaha bulshada iyo fariimaha degdega ah waa kanaalka isgaarsiineed ee fudud oo dhakhso badan. Si loola socdo tartamayaashooda, xafiiska PBXs waxay noqonayaan kuwo aad u badan oo la mid ah iyaga: waxay u guurayaan daruuraha, oo lagu maareeyo shabakada internetka oo lagu dhex daro nidaamyada kale ee API. Maqaalkan waxaan kuu sheegi doonaa waxa ay tahay Rostelecom Virtual PBX API iyo sida loola shaqeeyo hawlaha ugu muhiimsan ee PBX-ga casriga ah iyada oo loo marayo.

Hawsha ugu weyn ee Rostelecom Virtual PBX API waa is dhexgalka CRM ama mareegaha shirkadda. Tusaale ahaan, API waxa ay fulisaa "dib u wac" iyo "ka wac goobta" widgets ee nidaamyada maamulka ugu muhiimsan: WordPress, Bitrix, OpenCart. API-gu wuxuu ogol yahay:

Hesho macluumaadka, ogeysii heerka iyo samee wicitaano ka yimaada nidaamka dibadda;
Hel xiriiriye ku meel gaar ah si aad u duubto wada hadalka;
Maamul oo hel cabbirada xaddidaadda isticmaalayaasha;
Hel macluumaadka ku saabsan isticmaalaha PBX ee casriga ah;
Codso taariikhda lacag-bixinnada wicitaanka;
Soo rar log call.

Sida API u shaqeeyo

API-ga is dhexgalka iyo nidaamka dibadda ayaa is dhex gala iyaga oo isticmaalaya codsiyada HTTP. Koontada gaarka ah, maamuluhu wuxuu dejiyaa ciwaanada halka codsiyada API ay tahay inay yimaadaan iyo meelaha codsiyada API laga soo diro. Nidaamka dibadda waa inuu lahaadaa ciwaan dadweyne oo laga heli karo internetka oo wata shahaado SSL oo rakiban.

Sidoo kale koontada gaarka ah, maamulaha bogga wuxuu xaddidi karaa ilaha codsiyada marka la gelayo API-ga IP-ga.

Waxaan helnaa macluumaadka ku saabsan isticmaalayaasha PBX ee casriga ah

Si aad u hesho liiska isticmaalayaasha ama kooxaha, waxaad u baahan tahay inaad codsi u dirto PBX-ga casriga ah adoo isticmaalaya habka /users_info.

{
        "domain":"example.ru"
}

Jawaabta, waxaad heli doontaa liis aad kaydin karto.

{
"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^_^]
                            }
              ]

Habkani waxa uu maraa laba habab. Mid leh domain isticmaalayaasha, mid leh kooxaha domain. Kooxdu waxay sidoo kale haysataa fursad ay ku sheegaan iimaylka lagu soo diri doono codsiga.

Hagaajinta macluumaadka ku saabsan wicitaanka soo socda

Ku xidhida taleefoonka shirkada ee nidaamyada kala duwan ee CRM waxay u badbaadisaa wakhti shaqaalaha la falgasha macaamiisha waxayna dedejisaa habaynta wicitaanada soo socda. Tusaale ahaan, marka uu soo waco macmiilka hadda jooga, CRM waxa uu furi karaa kaarkiisa, CRM-na waxa aad wici kartaa macmiilka oo aad ku xidhi kartaa shaqaale.

Si aad u hesho macluumaadka ku saabsan wicitaanada API, waxaad u baahan tahay inaad isticmaasho habka /hel_lambar_macluumaad, kaas oo soo saara liis wicitaano ah oo wata macluumaadka ku saabsan kooxda wicitaanka loo qaybiyay. Aynu ka soo qaadno in nambarka casriga ah ee PBX uu ka helayo soo wacitaan lambarka 1234567890. Markaa PBX waxay soo diri doontaa codsigan soo socda:

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

Marka xigta waxaad u baahan tahay inaad ku xidho maamulaha /hel_lambar_macluumaad. Codsiga waa in la fuliyaa marka wicitaanka soo gala uu ku yimaado khadka soo socda ka hor inta aan wicitaanada la jabin. Haddii jawaabta codsiga aan lagu helin wakhtiga la cayimay, markaas wacitaanka waxaa loo weeciyey si waafaqsan xeerarka lagu aasaasay domainka.

Tusaale maamule dhinaca CRM ah.

if ($account) {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент найден',
            	'displayName' => $account->name,
            	//'PIN' => $crm_users,
        	];
    	} 
        else 
                {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент не найден',
            	'displayName' => 'Неизвестный абонент '.$contact,
            	//'PIN' => crm_users,
        	];
    	}
    	return $data;

Jawaabta maamulaha.

{
        "result":0,
        "resultMessage":"Абонент найден",
        "displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}

Waanu la soconaa heerka iyo soo dejinta duubista wicitaanka

Gudaha Rostelecom's Virtual PBX, duubista wicitaanku waxa ay ka hawl galisaa akoonkaaga gaarka ah. Adigoo isticmaalaya API-ga, waxaad la socon kartaa heerka shaqadan. Marka la habeeyo joojinta wicitaanka gudaha wac_dhacdooyin waxaad arki kartaa calanka 'waa_rikoob', Kaaso ogaysiiya isticmaalaha heerka gelitaanka: run macneheedu waxa weeye in adeegsaha shaqadiisa duubista wicitaanka uu shaqaynayo.

Si aad u soo dejiso duubis, waxaad u baahan tahay inaad isticmaasho aqoonsiga fadhiga wacitaanka session_id codsi u dir api.cloudpbx.rt.ru/get_record.

{
        "session_id":"SDsnZugDFmTW7Sec"
}

Jawaab ahaan, waxaad heli doontaa xiriiriye ku meel gaar ah si aad u soo dejiso fayl wata duubista wada hadalka.

{
        "result": ^_^quot�quot^_^,
        "resultMessage": "Операция выполнена успешно",
    	"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}

Wakhtiga kaydinta faylka waxa lagu dejiyay goobaha akoonkaaga gaarka ah. Kadib faylka waa la tirtiri doonaa.

Tirakoobka iyo warbixinta

Koontadaada khaaska ah ee bog gaar ah waxaad ku arki kartaa tirakoobka iyo ka warbixinta dhammaan wicitaanada waxaadna dabaqi kartaa filtarrada heerka iyo waqtiga. Adigoo adeegsanaya API-ga, waa inaad marka hore wacitaanka ku socodsiisaa habka /dhacdooyin wac:

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

Markaas wac habka wac_info si loo habeeyo nidaamka oo loo muujiyo wacitaanka nidaamka CRM.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

Jawaabta, waxaad heli doontaa xog kala duwan oo laga baaraandegi karo in lagu kaydiyo xogta gudaha 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":""
        }
}

Tilmaamo kale oo faa'iido leh oo PBX ah

API-ga ka sokow, PBX-ga casriga ah wuxuu leeyahay sifooyin kale oo faa'iido leh oo aad isticmaali karto. Tusaale ahaan, kani waa liiska codka is-dhexgalka iyo is dhexgalka gacanta iyo isgaarsiinta go'an.

Jawaabta Codka Interactive Voice (IVR) waa waxa aan ka maqalno taleefanka gacanta ka hor inta uusan qofku jawaabin. Asal ahaan, kani waa hawl wadeen elektaroonig ah oo u jiheeya taleefoonnada waaxyaha ku habboon oo si toos ah uga jawaaba su'aalaha qaarkood. Dhawaan waxaa suurtogal ah in lala shaqeeyo IVR iyada oo loo sii marayo API: waxaan hadda soo saareynaa software kaas oo kuu ogolaanaya inaad la socoto horumarka wicitaanka ee IVR oo aad hesho macluumaadka ku saabsan furayaasha taabasho-tone marka macaamiishu ku jiro liiska codka.

Si aad telefanka shirkadda ugu wareejiso telefoonnada gacanta, waxaad isticmaali kartaa codsiyada talefoonka fudud ama waxaad si gooni gooni ah u hawlgelin kartaa adeegga Fixed Mobile Convergence (FMC). Mid kasta oo ka mid ah hababka, wicitaanada shabakada gudaheeda waa bilaash, waxay suurtogal u tahay in lagu shaqeeyo lambaro gaaban, wicitaanadana waa la duubi karaa oo tirakoobka guud ayaa lagu hayn karaa iyaga.

Farqiga u dhexeeya ayaa ah in talefannada softiweerku ay u baahan yihiin internetka si ay u wada xiriiraan, laakiin kuma xirna xiriiriyaha, halka FMC ay ku xiran tahay hawlwadeen gaar ah, laakiin waxaa loo isticmaali karaa xitaa taleefannadii hore ee riix-badhanka.

Source: www.habr.com

Rostelecom Virtual PBX: waxa iyo sida lagu samayn karo API