Mūsdienu bizness uztver fiksētos tālruņus kā novecojušu tehnoloģiju: mobilie sakari nodrošina darbinieku mobilitāti un pastāvīgu pieejamību, sociālie tīkli un tūlītējie kurjeri ir vieglāks un ātrāks saziņas kanāls. Lai neatpaliktu no konkurentiem, biroja PBX kļūst arvien līdzīgāki tiem: tie pāriet uz mākoni, tiek pārvaldīti, izmantojot tīmekļa saskarni un integrēti ar citām sistēmām, izmantojot API. Šajā ierakstā mēs jums pateiksim, kādas funkcijas ir Rostelecom virtuālā pbx API un kā caur to strādāt ar virtuālā pbx galvenajām funkcijām.
Rostelecom virtuālās PBX API galvenais uzdevums ir mijiedarbība ar CRM vai uzņēmuma vietnēm. Piemēram, API ievieš logrīkus “atzvanīt” un “zvanīt no vietnes” galvenajām pārvaldības sistēmām: WordPress, Bitrix, OpenCart. API ļauj:
- Saņemt informāciju, paziņot statusu un veikt zvanus pēc pieprasījuma no ārējās sistēmas;
- Iegūstiet pagaidu saiti, lai ierakstītu sarunu;
- Pārvaldīt un saņemt no lietotājiem ierobežojumu parametrus;
- Iegūt informāciju par virtuālo PBX lietotāju;
- Pieprasīt zvanu debetu un maksu vēsturi;
- Augšupielādējiet zvanu žurnālu.
Kā darbojas API
Integrācijas API un ārējā sistēma mijiedarbojas savā starpā, izmantojot HTTP pieprasījumus. Personīgajā kontā administrators iestata adreses, uz kurām jāsaņem API pieprasījumi un kur jānosūta pieprasījumi no API. Ārējai sistēmai jābūt publiskai adresei, kas pieejama no interneta ar instalētu SSL sertifikātu.
Arī personīgajā kontā domēna administrators var ierobežot pieprasījumu avotus, piekļūstot API, izmantojot IP.
Mēs saņemam informāciju par virtuālo PBX lietotājiem
Lai iegūtu lietotāju vai grupu sarakstu, jums ir jānosūta pieprasījums uz virtuālo PBX, izmantojot metodi /lietotāju_informācija.
{
"domain":"example.ru"
}
Atbildot uz to, jūs saņemsit sarakstu, kuru varat saglabāt.
{
"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^_^]
}
]
Šī metode iztur divus masīvus. Viens ar domēna lietotājiem, viens ar domēnu grupām. Tāpat grupai ir iespēja norādīt e-pastu, kas tiks nosūtīts pieprasījumā.
Tiek apstrādāta informācija par ienākošo zvanu
Korporatīvās telefonijas savienošana ar dažādām CRM sistēmām ietaupa laiku darbiniekiem, kuri mijiedarbojas ar klientiem, un paātrina ienākošo zvanu apstrādi. Piemēram, pēc zvana no pašreizējā klienta, CRM var atvērt viņa karti, un no CRM varat nosūtīt zvanu klientam un savienot viņu ar darbinieku.
Lai iegūtu informāciju par API izsaukumiem, jums ir jāizmanto metode /get_number_info, kas ģenerē zvanu sarakstu ar informāciju par grupu, kurai zvans tiek izplatīts. Pieņemsim, ka virtuālais PBX numurs saņem ienākošo zvanu no numura 1234567890. Pēc tam PBX nosūtīs šādu pieprasījumu:
{
"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":""
}
Tālāk jums jāpievieno apstrādātājs /get_number_info. Pieprasījums ir jāizpilda, kad ienākošais zvans pienāk pa ienākošo līniju pirms zvanu maršrutēšanas. Ja atbilde uz pieprasījumu netiek saņemta noteiktajā laikā, zvans tiek maršrutēts saskaņā ar domēnā noteiktajiem noteikumiem.
Apdarinātāja piemērs CRM pusē.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Apdarinātāja atbilde.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Mēs izsekojam statusu un lejupielādējam zvanu ierakstus
Rostelecom virtuālajā PBX zvanu ierakstīšana tiek aktivizēta jūsu personīgajā kontā. Izmantojot API, varat izsekot šīs funkcijas statusam. Apstrādājot zvana pabeigšanu iekšā call_events jūs varat redzēt karogu 'is_record', kas informē lietotāju par ieraksta statusu: patiess nozīmē, ka ir iespējota lietotāja zvanu ierakstīšanas funkcija.
Lai lejupielādētu ierakstu, ir jāizmanto zvana sesijas ID sesijas ID nosūtīt pieprasījumu uz api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Atbildot uz to, jūs saņemsit pagaidu saiti, lai lejupielādētu failu ar sarunas ierakstu.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Failu glabāšanas laiks ir iestatīts jūsu personīgā konta iestatījumos. Pēc tam fails tiks izdzēsts.
Statistika un atskaites
Savā personīgajā kontā atsevišķā lapā varat skatīt statistiku un pārskatus par visiem zvaniem un lietot filtrus pēc statusa un laika. Izmantojot API, vispirms ir jāapstrādā izsaukums ar metodi /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"
}
Pēc tam izsauciet metodi zvana_informācija lai apstrādātu masīvu un parādītu zvanu CRM sistēmā.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Atbildot uz to, jūs saņemsit datu masīvu, ko var apstrādāt, lai saglabātu datus CRM žurnālā.
{
"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":""
}
}
Citas noderīgas virtuālās pbx funkcijas
Papildus API virtuālajam PBX ir vairākas citas noderīgas funkcijas, kuras varat izmantot. Piemēram, šī ir interaktīva balss izvēlne un mobilo un fiksēto sakaru integrācija.
Interaktīvā balss atbilde (IVR) ir tas, ko mēs dzirdam klausulē, pirms persona atbild. Būtībā tas ir elektroniskais operators, kas pāradresē zvanus uz attiecīgajām nodaļām un automātiski atbild uz dažiem jautājumiem. Drīzumā būs iespējams strādāt ar IVR, izmantojot API: pašlaik izstrādājam programmatūru, kas ļaus izsekot zvana gaitai caur IVR un saņemt informāciju par skārienjutīgu taustiņu nospiešanu, kad abonents atrodas balss izvēlnē.
Lai pārsūtītu korporatīvo telefoniju uz mobilajiem tālruņiem, varat izmantot programmatūras tālruņu lietojumprogrammas vai atsevišķi aktivizēt Fixed Mobile Convergence (FMC) pakalpojumu. Izmantojot jebkuru no metodēm, zvani tīklā ir bez maksas, kļūst iespējams strādāt ar īsajiem numuriem, un zvanus var ierakstīt un glabāt vispārīgu statistiku par tiem.
Atšķirība ir tāda, ka softphones ir nepieciešams internets, lai sazinātos, taču tie nav piesaistīti operatoram, savukārt FMC ir piesaistīts konkrētam operatoram, bet tos var izmantot pat vecos spiedpogu tālruņos.
Avots: www.habr.com