Enpresa modernoek telefono finkoak teknologia zaharkitu gisa hautematen dituzte: komunikazio zelularrek langileen mugikortasuna eta etengabeko erabilgarritasuna bermatzen dute, sare sozialak eta berehalako mezulariak komunikazio kanal errazagoa eta azkarragoa dira. Lehiakideekin jarraitzeko, bulegoko PBXak gero eta antzekoagoak dira: hodeira mugitzen dira, web interfaze baten bidez kudeatzen dira eta API bidez beste sistemekin integratuta daude. Argitalpen honetan Rostelecom birtualeko PBX APIak zein funtzio dituen eta haren bidez nola lan egin PBX birtualaren funtzio nagusiekin esango dizugu.
Rostelecom birtual PBX APIaren zeregin nagusia CRM edo konpainiaren webguneekin elkarreragina da. Adibidez, APIak "deitu atzera" eta "deitu gunetik" widgetak ezartzen ditu kudeaketa sistema nagusietarako: WordPress, Bitrix, OpenCart. APIak aukera ematen du:
- Informazioa jaso, egoera jakinaraztea eta deiak egitea kanpoko sistema batetik eskatuta;
- Lortu aldi baterako esteka elkarrizketa grabatzeko;
- Kudeatu eta jaso erabiltzaileen murrizketa-parametroak;
- Lortu PBX birtualeko erabiltzaileari buruzko informazioa;
- Eskatu deien zordunketa eta karguen historia;
- Kargatu deien erregistroa.
APIak nola funtzionatzen duen
Integrazio APIa eta kanpoko sistema elkarreragiten dute HTTP eskaerak erabiliz. Kontu pertsonalean, administratzaileak APIrako eskaerak iritsi behar diren eta APIaren eskaerak non bidali behar diren helbideak ezartzen ditu. Kanpoko sistemak helbide publiko bat izan behar du Internetetik eskuragarri dagoen SSL ziurtagiria instalatuta duena.
Kontu pertsonalean ere, domeinu-administratzaileak eskaeren iturriak muga ditzake APIra IP bidez sartzean.
PBX birtualeko erabiltzaileei buruzko informazioa jasotzen dugu
Erabiltzaileen edo taldeen zerrenda lortzeko, eskaera bat bidali behar duzu PBX birtualera metodoa erabiliz /erabiltzaile_informazioa.
{
"domain":"example.ru"
}
Erantzun gisa, gorde dezakezun zerrenda jasoko duzu.
{
"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^_^]
}
]
Metodo honek bi array pasatzen ditu. Bat domeinu erabiltzaileekin, beste bat domeinu taldeekin. Taldeak eskaeran bidaliko den mezu elektroniko bat zehazteko aukera ere badu.
Sarrerako dei bati buruzko informazioa prozesatzea
Telefono korporatiboa CRM sistema ezberdinetara konektatzeak denbora aurrezten die bezeroekin elkarreragiten duten langileei eta sarrerako deien prozesamendua bizkortzen du. Adibidez, egungo bezero baten dei batean, CRM-k bere txartela ireki dezake, eta CRM-tik bezeroari dei bat bidali eta langile batekin konektatu dezakezu.
API deiei buruzko informazioa lortzeko, metodoa erabili behar duzu /lortu_zenbakia_informazioa, deia banatzen den taldeari buruzko informazioa duen deien zerrenda sortzen duena. Demagun PBX zenbaki birtualak 1234567890 zenbakitik sarrerako deia jasotzen duela. Ondoren, PBXak eskaera hau bidaliko du:
{
"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":""
}
Ondoren kudeatzailea konektatu behar duzu /lortu_zenbakia_informazioa. Eskaera exekutatu behar da sarrerako dei bat sarrerako lineara iristen denean deiak bideratu aurretik. Eskaera baten erantzuna zehaztutako epean jasotzen ez bada, deia domeinuan ezarritako arauen arabera bideratzen da.
CRM aldean kudeatzaile baten adibidea.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Kudeatzailearen erantzuna.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Egoeraren jarraipena egiten dugu eta deien grabazioak deskargatzen ditugu
Rostelecom-en PBX birtualean, deien grabazioa zure kontu pertsonalean aktibatzen da. APIa erabiliz, funtzio honen egoeraren jarraipena egin dezakezu. Deiaren amaiera prozesatzen denean dei_gertaerak bandera ikus dezakezu 'erregistroa da', erabiltzaileari sarreraren egoeraren berri ematen diona: Egia erabiltzailearen deiak grabatzeko funtzioa gaituta dagoela esan nahi du.
Grabaketa bat deskargatzeko, dei-saioaren IDa erabili behar duzu SESSION_ID bidali eskaera honi api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Horren harira, elkarrizketaren grabazioarekin fitxategi bat deskargatzeko aldi baterako esteka jasoko duzu.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Fitxategiak biltegiratzeko denbora zure kontu pertsonalaren ezarpenetan ezartzen da. Ondoren fitxategia ezabatu egingo da.
Estatistikak eta txostenak
Zure kontu pertsonalean aparteko orrialde batean dei guztien estatistikak eta txostenak ikus ditzakezu eta iragazkiak aplikatu egoeraren eta orduaren arabera. APIaren bidez, deia metodoarekin prozesatu behar duzu lehenik /deia_gertaerak:
{
"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"
}
Ondoren, deitu metodoa dei_informazioa array prozesatu eta deia CRM sisteman bistaratzeko.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Horren aurrean, CRM erregistroan datuak gordetzeko prozesatu daitezkeen datu sorta bat jasoko duzu.
{
"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 birtualaren beste ezaugarri erabilgarriak
APIaz gain, PBX birtual batek erabil ditzakezun beste hainbat funtzio erabilgarri ditu. Esate baterako, hau ahots-menu interaktiboa da eta komunikazio zelularren eta finkoen integrazioa da.
Ahots-erantzun interaktiboa (IVR) telefonoan entzuten duguna da, pertsonak erantzun aurretik. Funtsean, deiak dagokion sailetara birbideratzen dituen eta galdera batzuk automatikoki erantzuten dituen operadore elektronikoa da. Laster IVRrekin lan egin ahal izango da API bidez: une honetan, IVR bidez dei baten aurrerapena jarraitzeko eta harpideduna ahots-menuan dagoenean ukipen-tonuen sakeei buruzko informazioa jasotzeko softwarea garatzen ari gara.
Telefonia korporatiboa telefono mugikorrera transferitzeko, softphone aplikazioak erabil ditzakezu edo bereizita aktibatu Fixed Mobile Convergence (FMC) zerbitzua. Edozein metodorekin, sareko deiak doakoak dira, zenbaki laburrekin lan egin daiteke eta deiak grabatu eta estatistikak orokorrak gorde daitezke.
Ezberdintasuna da softphoneek Internet behar dutela komunikatzeko, baina ez daude operadore bati lotuta, FMC, berriz, operadore zehatz bati lotuta dago, baina sakagailu zaharreko telefonoetan ere erabil daiteke.
Iturria: www.habr.com