Moderna komerco perceptas fikstelefonajn telefonojn kiel malmodernan teknologion: ĉelaj komunikadoj certigas moviĝeblon kaj konstantan haveblecon de dungitoj, sociaj retoj kaj tujmesaĝiloj estas pli facila kaj pli rapida komunika kanalo. Por daŭrigi kun siaj konkurantoj, oficejaj PBX-oj pli kaj pli similas al ili: ili moviĝas al la nubo, administritaj per interreta interfaco kaj integritaj kun aliaj sistemoj per API. En ĉi tiu afiŝo ni diros al vi, kiajn funkciojn havas la virtuala PBX API de Rostelecom kaj kiel labori kun la ĉefaj funkcioj de la virtuala PBX per ĝi.
La ĉefa tasko de la virtuala PBX API de Rostelecom estas interago kun CRM aŭ kompanioj retejoj. Ekzemple, la API efektivigas fenestraĵojn "revoko" kaj "voko de retejo" por la ĉefaj mastrumaj sistemoj: WordPress, Bitrix, OpenCart. La API permesas:
- Ricevu informojn, sciigu staton kaj faru vokojn laŭ peto de ekstera sistemo;
- Akiru provizoran ligilon por registri la konversacion;
- Administri kaj ricevi limigajn parametrojn de uzantoj;
- Akiru informojn pri la virtuala PBX-uzanto;
- Petu la historion de vokaj debetoj kaj kotizoj;
- Alŝutu vokadon.
Kiel funkcias la API
La integriga API kaj la ekstera sistemo interagas unu kun la alia uzante HTTP-petojn. En la persona konto, la administranto fiksas la adresojn kie petoj al la API devus alveni kaj kie petoj de la API devus esti senditaj. La ekstera sistemo devas havi publikan adreson alirebla de la Interreto kun instalita SSL-atestilo.
Ankaŭ en la persona konto, la domajna administranto povas limigi la fontojn de petoj alirante la API per IP.
Ni ricevas informojn pri virtualaj PBX-uzantoj
Por ricevi liston de uzantoj aŭ grupoj, vi devas sendi peton al la virtuala PBX uzante la metodon /uzantoj_info.
{
"domain":"example.ru"
}
Responde, vi ricevos liston, kiun vi povas konservi.
{
"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^_^]
}
]
Ĉi tiu metodo pasas du tabelojn. Unu kun domajnaj uzantoj, unu kun domajnaj grupoj. La grupo ankaŭ havas la ŝancon specifi retpoŝton, kiu estos sendita en la peto.
Prilaborado de informoj pri alvenanta voko
Konekti kompanian telefonion al diversaj CRM-sistemoj ŝparas tempon por dungitoj, kiuj interagas kun klientoj kaj plirapidigas la prilaboradon de envenantaj vokoj. Ekzemple, post voko de nuna kliento, CRM povas malfermi sian karton, kaj de CRM vi povas sendi vokon al la kliento kaj konekti lin kun dungito.
Por ricevi informojn pri API-vokoj, vi devas uzi la metodon /get_number_info, kiu generas liston de vokoj kun informoj pri la grupo al kiu la voko estas distribuita. Ni supozu, ke la virtuala PBX-numero ricevas envenantan vokon de la numero 1234567890. Tiam la PBX sendos la sekvan peton:
{
"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":""
}
Poste vi devas konekti la prizorganton /get_number_info. La peto devas esti efektivigita kiam alvenanta voko alvenas sur la envenantan linion antaŭ ol la vokoj estas senditaj. Se respondo al peto ne estas ricevita en la specifita tempo, tiam la voko estas direktita laŭ la reguloj establitaj en la domajno.
Ekzemplo de prizorganto ĉe la CRM-flanko.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Respondo de la prizorganto.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Ni spuras la staton kaj elŝutas alvokoregistraĵojn
En la virtuala PBX de Rostelecom, voka registrado estas aktivigita en via persona konto. Uzante la API, vi povas spuri la staton de ĉi tiu funkcio. Dum prilaborado de vokofino en alvoko_eventoj vi povas vidi la flagon 'estas_rekordo', kiu sciigas la uzanton pri la stato de la eniro: veraj signifas, ke la funkcio de registrado de vokoj de la uzanto estas ebligita.
Por elŝuti registradon, vi devas uzi la ID de voka sesio session_id sendu peton al api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Responde, vi ricevos provizoran ligilon por elŝuti dosieron kun registrado de la konversacio.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
La dosiera stokado tempo estas fiksita en via persona konto agordoj. Poste la dosiero estos forigita.
Statistiko kaj raportado
En via persona konto sur aparta paĝo vi povas vidi statistikojn kaj raportojn pri ĉiuj alvokoj kaj apliki filtrilojn laŭ stato kaj tempo. Per la API, vi unue devas prilabori la vokon per la metodo /voko_eventoj:
{
"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"
}
Tiam voku la metodon call_info por prilabori la tabelon kaj montri la vokon en la CRM-sistemo.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Responde, vi ricevos aron da datumoj, kiuj povas esti prilaboritaj por konservi datumojn en la CRM-protokolo.
{
"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":""
}
}
Aliaj utilaj virtualaj PBX-ecoj
Krom la API, virtuala PBX havas plurajn aliajn utilajn funkciojn, kiujn vi povas uzi. Ekzemple, ĉi tio estas interaga voĉa menuo kaj la integriĝo de ĉelaj kaj fiksaj komunikadoj.
Interaga Voĉa Respondo (IVR) estas tio, kion ni aŭdas sur la telefontelefono antaŭ ol la persono respondas. Esence, ĉi tio estas elektronika funkciigisto, kiu alidirektas vokojn al la taŭgaj fakoj kaj respondas kelkajn demandojn aŭtomate. Baldaŭ eblos labori kun IVR per la API: ni nuntempe disvolvas programaron, kiu permesos al vi spuri la progreson de voko per la IVR kaj ricevi informojn pri tuŝotonaj klavoj kiam la abonanto estas en la voĉa menuo.
Por transdoni kompanian telefonion al poŝtelefonoj, vi povas aŭ uzi softphone-aplikaĵojn aŭ aparte aktivigi la servon Fixed Mobile Convergence (FMC). Per iu ajn el la metodoj, vokoj ene de la reto estas senpagaj, fariĝas eble labori kun mallongaj nombroj, kaj vokoj povas esti registritaj kaj ĝeneralaj statistikoj povas esti konservitaj pri ili.
La diferenco estas, ke softtelefonoj bezonas Interreton por komuniki, sed ili ne estas ligitaj al funkciigisto, dum FMC estas ligita al specifa funkciigisto, sed povas esti uzata eĉ ĉe malnovaj butonaj telefonoj.
fonto: www.habr.com