Moderný biznis vníma pevné telefóny ako zastaranú technológiu: mobilná komunikácia zabezpečuje mobilitu a stálu dostupnosť zamestnancov, sociálne siete a instant messenger sú jednoduchší a rýchlejší komunikačný kanál. Aby držali krok s konkurenciou, kancelárske PBX sa im čoraz viac podobajú: presúvajú sa do cloudu, spravujú sa cez webové rozhranie a integrujú sa s inými systémami cez API. V tomto príspevku vám povieme, aké funkcie má rozhranie Rostelecom virtual PBX API a ako cez neho pracovať s hlavnými funkciami virtuálnej PBX.
Hlavnou úlohou virtuálneho API Rostelecom PBX je interakcia s CRM alebo webovými stránkami spoločnosti. Rozhranie API napríklad implementuje widgety „zavolať späť“ a „zavolať zo stránky“ pre hlavné riadiace systémy: WordPress, Bitrix, OpenCart. API umožňuje:
- Prijímať informácie, oznamovať stav a uskutočňovať hovory na požiadanie z externého systému;
- Získajte dočasný odkaz na zaznamenanie konverzácie;
- Spravujte a prijímajte parametre obmedzení od používateľov;
- Získajte informácie o používateľovi virtuálnej ústredne;
- Vyžiadajte si históriu debetov a poplatkov za hovory;
- Nahrajte denník hovorov.
Ako funguje API
Integračné API a externý systém navzájom spolupracujú pomocou požiadaviek HTTP. V osobnom účte administrátor nastaví adresy, na ktoré majú dochádzať požiadavky na API a kam sa majú posielať požiadavky z API. Externý systém musí mať verejnú adresu prístupnú z internetu s nainštalovaným SSL certifikátom.
Aj v osobnom účte môže správca domény obmedziť zdroje požiadaviek pri prístupe k API pomocou IP.
Dostávame informácie o používateľoch virtuálnych ústrední
Ak chcete získať zoznam používateľov alebo skupín, musíte pomocou metódy odoslať požiadavku na virtuálnu PBX /users_info.
{
"domain":"example.ru"
}
Ako odpoveď dostanete zoznam, ktorý si môžete uložiť.
{
"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^_^]
}
]
Táto metóda prechádza cez dve polia. Jeden s používateľmi domény, jeden so skupinami domén. Skupina má tiež možnosť určiť email, ktorý bude odoslaný v žiadosti.
Spracovanie informácií o prichádzajúcom hovore
Prepojenie firemnej telefónie s rôznymi CRM systémami šetrí čas zamestnancom pri interakcii s klientmi a urýchľuje spracovanie prichádzajúcich hovorov. Napríklad pri hovore od aktuálneho klienta môže CRM otvoriť jeho kartu a z CRM môžete klientovi zavolať a spojiť ho so zamestnancom.
Ak chcete získať informácie o volaniach API, musíte použiť metódu /get_number_info, ktorý vygeneruje zoznam hovorov s informáciami o skupine, do ktorej je hovor distribuovaný. Predpokladajme, že číslo virtuálnej PBX prijme prichádzajúci hovor z čísla 1234567890. Potom PBX odošle nasledujúcu požiadavku:
{
"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":""
}
Ďalej musíte pripojiť handler /get_number_info. Požiadavka musí byť vykonaná, keď prichádza prichádzajúci hovor na prichádzajúcu linku pred smerovaním hovorov. Ak odpoveď na požiadavku nie je prijatá v stanovenom čase, potom je hovor smerovaný podľa pravidiel stanovených v doméne.
Príklad handlera na strane 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;
Odpoveď od obsluhy.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Sledujeme stav a sťahujeme nahrávky hovorov
Vo virtuálnej PBX spoločnosti Rostelecom je nahrávanie hovorov aktivované vo vašom osobnom účte. Pomocou API môžete sledovať stav tejto funkcie. Pri spracovaní ukončenia hovoru v call_events môžete vidieť vlajku 'is_record', ktorý informuje užívateľa o stave záznamu: pravdivý znamená, že je aktivovaná funkcia nahrávania hovorov používateľa.
Ak chcete stiahnuť nahrávku, musíte použiť ID relácie hovoru session_id poslať žiadosť na api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ako odpoveď dostanete dočasný odkaz na stiahnutie súboru so záznamom konverzácie.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Čas uloženia súboru je nastavený v nastaveniach vášho osobného účtu. Potom bude súbor odstránený.
Štatistiky a výkazníctvo
Vo svojom osobnom účte na samostatnej stránke môžete vidieť štatistiky a prehľady všetkých hovorov a použiť filtre podľa stavu a času. Cez API musíte najskôr spracovať volanie s metódou /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"
}
Potom zavolajte metódu call_info na spracovanie poľa a zobrazenie hovoru v CRM systéme.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ako odpoveď dostanete pole údajov, ktoré je možné spracovať na uloženie údajov do denníka 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":""
}
}
Ďalšie užitočné funkcie virtuálnej pobočkovej ústredne
Okrem API má virtuálna PBX niekoľko ďalších užitočných funkcií, ktoré môžete využiť. Ide napríklad o interaktívne hlasové menu a integráciu mobilnej a pevnej komunikácie.
Interaktívna hlasová odozva (IVR) je to, čo počujeme na slúchadle predtým, ako osoba odpovie. V podstate ide o elektronického operátora, ktorý presmeruje hovory na príslušné oddelenia a automaticky odpovedá na niektoré otázky. Čoskoro bude možné pracovať s IVR cez API: v súčasnosti vyvíjame softvér, ktorý vám umožní sledovať priebeh hovoru cez IVR a dostávať informácie o stlačeniach klávesov, keď je účastník v hlasovom menu.
Ak chcete preniesť firemné telefonovanie do mobilných telefónov, môžete použiť softvérové aplikácie alebo samostatne aktivovať službu Fixed Mobile Convergence (FMC). Pri ktorejkoľvek z metód sú hovory v rámci siete bezplatné, je možné pracovať s krátkymi číslami, hovory je možné zaznamenávať a viesť o nich všeobecné štatistiky.
Rozdiel je v tom, že softfóny potrebujú na komunikáciu internet, nie sú však viazané na operátora, zatiaľ čo FMC je viazané na konkrétneho operátora, ale dajú sa použiť aj na starých tlačidlových telefónoch.
Zdroj: hab.com