Ibhizinisi lesimanje libona amafoni asendlini njengobuchwepheshe obuphelelwe yisikhathi: ukuxhumana kwamaselula kuqinisekisa ukuhamba nokutholakala njalo kwabasebenzi, amanethiwekhi omphakathi kanye nezithunywa ezisheshayo kuyisiteshi sokuxhumana esilula nesisheshayo. Ukuze uhambisane nabaqhudelana nabo, amahhovisi e-PBX aya ngokufana kakhulu nawo: athuthela efwini, aphethwe ngesixhumi esibonakalayo sewebhu futhi ahlanganiswe nezinye izinhlelo nge-API. Kulokhu okuthunyelwe sizokutshela ukuthi yimiphi imisebenzi i-Rostelecom virtual PBX API enayo nokuthi isebenza kanjani ngemisebenzi esemqoka ye-PBX ebonakalayo ngayo.
Umsebenzi oyinhloko we-Rostelecom virtual PBX API ukusebenzisana ne-CRM noma amawebhusayithi enkampani. Isibonelo, i-API isebenzisa amawijethi okuthi “call back” kanye “nokushaya usuka kusayithi” kumasistimu okuphatha amakhulu: WordPress, Bitrix, OpenCart. I-API ivumela:
- Thola ulwazi, ukwazisa isimo futhi ushaye izingcingo uma ucelwa ohlelweni lwangaphandle;
- Thola isixhumanisi sesikhashana ukuze urekhode ingxoxo;
- Phatha futhi uthole imingcele yemikhawulo evela kubasebenzisi;
- Thola ulwazi mayelana nomsebenzisi we-PBX obonakalayo;
- Cela umlando wokudonswa kwemali kwezingcingo kanye nezindleko;
- Layisha irekhodi lwamakholi.
Isebenza kanjani i-API
I-API yokuhlanganisa kanye nesistimu yangaphandle kuyasebenzisana kusetshenziswa izicelo ze-HTTP. Ku-akhawunti yomuntu siqu, umlawuli usetha amakheli lapho izicelo eziya ku-API kufanele zifike khona nalapho izicelo ezisuka ku-API kufanele zithunyelwe khona. Uhlelo lwangaphandle kufanele lube nekheli lomphakathi elifinyeleleka ku-inthanethi ngesitifiketi se-SSL esifakiwe.
Futhi ku-akhawunti yomuntu siqu, umlawuli wesizinda angakhawulela imithombo yezicelo lapho efinyelela i-API nge-IP.
Sithola ulwazi mayelana nabasebenzisi be-PBX ababonakalayo
Ukuze uthole uhlu lwabasebenzisi noma amaqembu, udinga ukuthumela isicelo ku-PBX ebonakalayo usebenzisa indlela /users_info.
{
"domain":"example.ru"
}
Ukuphendula, uzothola uhlu ongalugcina.
{
"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^_^]
}
]
Le ndlela idlula ama-array amabili. Eyodwa enabasebenzisi besizinda, enye enamaqembu esizinda. Iqembu liphinde libe nethuba lokucacisa i-imeyili ezothunyelwa esicelweni.
Icubungula ulwazi mayelana nekholi engenayo
Ukuxhuma ucingo lwezinkampani kumasistimu ahlukahlukene e-CRM konga isikhathi kubasebenzi abasebenzisana namakhasimende futhi kusheshise ukucutshungulwa kwezingcingo ezingenayo. Isibonelo, lapho kushaya ucingo oluvela ekhasimendeni lamanje, i-CRM ingavula ikhadi layo, futhi ukusuka ku-CRM ungathumela ucingo ekhasimendeni futhi ulixhumanise nomsebenzi.
Ukuze uthole ulwazi mayelana namakholi we-API, udinga ukusebenzisa indlela /thola_inombolo_imininingwane, ekhiqiza uhlu lwamakholi nolwazi mayelana neqembu ucingo olusatshalaliswa kulo. Ake sicabange ukuthi inombolo ye-PBX ebonakalayo ithola ucingo olungenayo oluvela enombolweni ethi 1234567890. Bese i-PBX izothumela isicelo esilandelayo:
{
"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":""
}
Okulandelayo udinga ukuxhuma isibambi /thola_inombolo_imininingwane. Isicelo kufanele senziwe uma ucingo olungenayo lufika kulayini ongenayo ngaphambi kokuba izingcingo zishayelwe. Uma impendulo yesicelo ingatholwa ngesikhathi esibekiwe, ucingo luhanjiswa ngokwemithetho esungulwe esizindeni.
Isibonelo sesibambi ohlangothini lwe-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;
Impendulo esuka kumphathi.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Silandelela isimo futhi silande okurekhodiwe kwekholi
Ku-PBX ebonakalayo ye-Rostelecom, ukuqoshwa kwekholi kwenziwa ku-akhawunti yakho yomuntu siqu. Usebenzisa i-API, ungakwazi ukulandelela isimo salo msebenzi. Lapho ucubungula ukunqanyulwa kwekholi ku shayela_imicimbi ungabona ifulegi 'irekhodi', eyazisa umsebenzisi mayelana nesimo sokufakwayo: weqiniso kusho ukuthi umsebenzi wokurekhoda ucingo lomsebenzisi uvuliwe.
Ukulanda okurekhodiwe, udinga ukusebenzisa i-ID yesikhathi sokushaya iseshini_id thumela isicelo ku api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Empendulweni, uzothola isixhumanisi sesikhashana sokulanda ifayela elinerekhodi lengxoxo.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Isikhathi sokulondoloza ifayela sisethwe kuzilungiselelo ze-akhawunti yakho yomuntu siqu. Ngemva kwalokho ifayela lizosuswa.
Izibalo nokubika
Ku-akhawunti yakho yomuntu siqu ekhasini elihlukile ungabona izibalo nokubika kuzo zonke izingcingo futhi usebenzise izihlungi ngesimo nesikhathi. Nge-API, kufanele uqale ucubungule ucingo ngendlela /call_imicimbi:
{
"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"
}
Bese ushayela indlela call_info ukucubungula amalungu afanayo futhi ubonise ikholi ohlelweni lwe-CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ngempendulo, uzothola uxhaxha lwedatha engacutshungulwa ukuze kugcinwe idatha kulogu ye-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":""
}
}
Ezinye izici eziwusizo ze-PBX
Ngaphandle kwe-API, i-PBX ebonakalayo inezinye izici ezimbalwa eziwusizo ongazisebenzisa. Isibonelo, lena imenyu yezwi esebenzisanayo kanye nokuhlanganiswa kwamaselula nokuxhumana okungaguquki.
I-Interactive Voice Response (IVR) yilokho esikuzwa kwihendisethi ngaphambi kokuba umuntu aphendule. Empeleni, lona u-opharetha we-elekthronikhi oqondisa kabusha amakholi eminyangweni efanele futhi aphendule imibuzo ethile ngokuzenzakalelayo. Maduze uzokwazi ukusebenzisana ne-IVR nge-API: okwamanje sakha isofthiwe ezokuvumela ukuthi ulandelele ukuqhubeka kocingo nge-IVR futhi uthole ulwazi mayelana namakhiya ethoni yokuthinta lapho obhalisile ekumenyu yezwi.
Ukudlulisa ucingo lwezinkampani kumaselula, ungasebenzisa izinhlelo zefoni ethambile noma uvule isevisi ye-Fixed Mobile Convergence (FMC). Nganoma yiziphi izindlela, izingcingo ezingaphakathi kwenethiwekhi zimahhala, kuyenzeka ukuthi usebenze ngezinombolo ezimfushane, futhi izingcingo zingarekhodwa futhi izibalo ezijwayelekile zingagcinwa kuzo.
Umehluko wukuthi ama-softphone adinga i-inthanethi ukuze axhumane, kodwa awaboshelwe ku-opharetha, kuyilapho i-FMC iboshelwe ku-opharetha othile, kodwa ingasetshenziswa ngisho nakuma-push-button amafoni amadala.
Source: www.habr.com