Sodobno poslovanje dojema stacionarne telefone kot zastarelo tehnologijo: mobilne komunikacije zagotavljajo mobilnost in stalno dosegljivost zaposlenih, družabna omrežja in instant messengerji so lažji in hitrejši komunikacijski kanal. Pisarniške telefonske centrale so jim v korak s tekmeci vse bolj podobne: selijo se v oblak, upravljajo jih prek spletnega vmesnika in povezujejo z drugimi sistemi prek API-ja. V tej objavi vam bomo povedali, katere funkcije ima API za navidezno PBX Rostelecom in kako prek njega delati z glavnimi funkcijami navidezne PBX.
Glavna naloga API-ja virtualne PBX Rostelecom je interakcija s CRM ali spletnimi mesti podjetja. Na primer, API implementira pripomočke »povratni klic« in »klic s spletnega mesta« za glavne sisteme upravljanja: WordPress, Bitrix, OpenCart. API omogoča:
- Prejemanje informacij, obveščanje o stanju in klicanje na zahtevo zunanjega sistema;
- Pridobite začasno povezavo za snemanje pogovora;
- Upravljanje in prejemanje parametrov omejitev od uporabnikov;
- Pridobite informacije o uporabniku virtualne PBX;
- Zahtevajte zgodovino bremenitev in stroškov klicev;
- Naloži dnevnik klicev.
Kako deluje API
Integracijski API in zunanji sistem komunicirata drug z drugim z uporabo zahtev HTTP. Skrbnik v osebnem računu nastavi naslove, na katere naj prihajajo zahteve za API in na katere se pošiljajo zahteve iz API-ja. Zunanji sistem mora imeti javni naslov, dostopen iz interneta z nameščenim SSL certifikatom.
Tudi v osebnem računu lahko administrator domene omeji vire zahtev pri dostopu do API-ja po IP-ju.
Prejemamo podatke o uporabnikih virtualne PBX
Če želite pridobiti seznam uporabnikov ali skupin, morate poslati zahtevo virtualni PBX z uporabo metode /info_uporabniki.
{
"domain":"example.ru"
}
V odgovor boste prejeli seznam, ki ga lahko shranite.
{
"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^_^]
}
]
Ta metoda posreduje dve matriki. Ena z uporabniki domene, ena z domenskimi skupinami. Skupina ima tudi možnost določiti e-pošto, ki bo poslana v zahtevi.
Obdelava informacij o dohodnem klicu
Povezava korporativne telefonije z različnimi CRM sistemi prihrani čas zaposlenim, ki komunicirajo s strankami, in pospeši obdelavo dohodnih klicev. Na primer, ob klicu trenutne stranke lahko CRM odpre njegovo kartico, iz CRM pa lahko pošljete klic stranki in jo povežete z zaposlenim.
Če želite pridobiti informacije o klicih API-ja, morate uporabiti metodo /get_number_info, ki ustvari seznam klicev s podatki o skupini, kateri je klic razdeljen. Predpostavimo, da virtualna PBX številka prejme dohodni klic s številke 1234567890. Nato bo PBX poslala naslednjo zahtevo:
{
"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":""
}
Nato morate povezati upravljalnik /get_number_info. Zahtevo je treba izvršiti, ko dohodni klic prispe na dohodno linijo, preden so klici preusmerjeni. Če odgovor na zahtevo ni prejet v določenem času, se klic preusmeri v skladu s pravili, določenimi v domeni.
Primer obdelovalca na strani 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;
Odgovor skrbnika.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Sledimo statusu in prenašamo posnetke klicev
V virtualni PBX Rostelecom je snemanje klicev aktivirano v vašem osebnem računu. Z uporabo API-ja lahko spremljate stanje te funkcije. Pri obdelavi zaključevanja klica v klicni_dogodki lahko vidite zastavo 'is_record', ki uporabnika obvesti o statusu vnosa: Res pomeni, da je omogočena funkcija snemanja klicev uporabnika.
Za prenos posnetka morate uporabiti ID klicne seje ID seje pošlji zahtevo na api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
V odgovor boste prejeli začasno povezavo za prenos datoteke s posnetkom pogovora.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Čas shranjevanja datotek je nastavljen v nastavitvah osebnega računa. Nato bo datoteka izbrisana.
Statistika in poročanje
V osebnem računu na ločeni strani si lahko ogledate statistiko in poročanje o vseh klicih ter uporabite filtre po statusu in času. Prek API-ja morate najprej obdelati klic z metodo /call_events:
{
"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"
}
Nato pokličite metodo call_info za obdelavo polja in prikaz klica v sistemu CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Kot odgovor boste prejeli niz podatkov, ki jih je mogoče obdelati za shranjevanje podatkov v dnevnik 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":""
}
}
Druge uporabne funkcije virtualne PBX
Poleg API-ja ima navidezna PBX več drugih uporabnih funkcij, ki jih lahko uporabite. Na primer, to je interaktivni glasovni meni in integracija celične in fiksne komunikacije.
Interaktivni glasovni odziv (IVR) je tisto, kar slišimo na slušalki, preden se oseba oglasi. V bistvu je to elektronski operater, ki preusmeri klice na ustrezne oddelke in avtomatsko odgovarja na nekatera vprašanja. Kmalu bo mogoče delati z IVR prek API-ja: trenutno razvijamo programsko opremo, ki vam bo omogočila spremljanje napredka klica prek IVR in prejemanje informacij o tonskih pritiskih tipk, ko je naročnik v glasovnem meniju.
Za prenos poslovne telefonije na mobilne telefone lahko uporabite aplikacije softphone ali ločeno aktivirate storitev Fixed Mobile Convergence (FMC). S katerim koli načinom so klici v omrežju brezplačni, omogočeno je delo s kratkimi številkami, klici pa se lahko snemajo in o njih vodijo splošno statistiko.
Razlika je v tem, da programski telefoni za komunikacijo potrebujejo internet, vendar niso vezani na operaterja, medtem ko je FMC vezan na določenega operaterja, vendar ga je mogoče uporabljati tudi na starih tipkah.
Vir: www.habr.com