Biznesi modern i percepton telefonat fiks si një teknologji të vjetëruar: komunikimet celulare sigurojnë lëvizshmëri dhe disponueshmëri të vazhdueshme të punonjësve, rrjetet sociale dhe lajmëtarët e çastit janë një kanal komunikimi më i lehtë dhe më i shpejtë. Për të vazhduar me konkurrentët e tyre, PBX-të e zyrës po bëhen gjithnjë e më shumë të ngjashëm me ta: ata po lëvizin në cloud, menaxhohen nëpërmjet një ndërfaqeje në internet dhe integrohen me sisteme të tjera nëpërmjet API. Në këtë postim do t'ju tregojmë se cilat funksione ka API virtuale PBX Rostelecom dhe si të punoni me funksionet kryesore të PBX virtuale përmes tij.
Detyra kryesore e API virtuale PBX Rostelecom është ndërveprimi me CRM ose faqet e internetit të kompanisë. Për shembull, API zbaton miniaplikacionet “call back” dhe “call from site” për sistemet kryesore të menaxhimit: WordPress, Bitrix, OpenCart. API lejon:
- Merrni informacion, njoftoni statusin dhe bëni thirrje sipas kërkesës nga një sistem i jashtëm;
- Merrni një lidhje të përkohshme për të regjistruar bisedën;
- Menaxhoni dhe merrni parametrat e kufizimit nga përdoruesit;
- Merrni informacione për përdoruesin virtual të PBX;
- Kërkoni historinë e debitimeve dhe tarifave të thirrjeve;
- Ngarko regjistrin e thirrjeve.
Si funksionon API
API-ja e integrimit dhe sistemi i jashtëm ndërveprojnë me njëri-tjetrin duke përdorur kërkesat HTTP. Në llogarinë personale, administratori vendos adresat ku duhet të mbërrijnë kërkesat për API dhe ku duhet të dërgohen kërkesat nga API. Sistemi i jashtëm duhet të ketë një adresë publike të aksesueshme nga interneti me një certifikatë SSL të instaluar.
Gjithashtu në llogarinë personale, administratori i domenit mund të kufizojë burimet e kërkesave kur hyn në API me IP.
Ne marrim informacione rreth përdoruesve virtualë të PBX
Për të marrë një listë të përdoruesve ose grupeve, duhet të dërgoni një kërkesë në PBX virtual duke përdorur metodën /users_info.
{
"domain":"example.ru"
}
Si përgjigje, do të merrni një listë që mund të ruani.
{
"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^_^]
}
]
Kjo metodë kalon dy vargje. Një me përdoruesit e domenit, një me grupe domenesh. Grupi gjithashtu ka mundësinë të specifikojë një email që do të dërgohet në kërkesë.
Përpunimi i informacionit në lidhje me një telefonatë në hyrje
Lidhja e telefonisë së korporatës me sisteme të ndryshme CRM kursen kohë për punonjësit që ndërveprojnë me klientët dhe përshpejton përpunimin e thirrjeve në hyrje. Për shembull, me një telefonatë nga një klient aktual, CRM mund të hapë kartën e tij dhe nga CRM mund t'i dërgoni një telefonatë klientit dhe ta lidhni atë me një punonjës.
Për të marrë informacion rreth thirrjeve API, duhet të përdorni metodën /merr_numrin_info, i cili gjeneron një listë telefonatash me informacione për grupin në të cilin shpërndahet thirrja. Le të supozojmë se numri virtual i PBX merr një thirrje hyrëse nga numri 1234567890. Më pas PBX do të dërgojë kërkesën e mëposhtme:
{
"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":""
}
Më pas ju duhet të lidhni mbajtësin /merr_numrin_info. Kërkesa duhet të ekzekutohet kur një thirrje hyrëse arrin në linjën hyrëse përpara se thirrjet të drejtohen. Nëse një përgjigje për një kërkesë nuk merret brenda kohës së caktuar, atëherë thirrja drejtohet sipas rregullave të vendosura në domen.
Shembull i një mbajtësi në anën 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;
Përgjigje nga mbajtësi.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Ne gjurmojmë statusin dhe shkarkojmë regjistrimet e thirrjeve
Në PBX virtual të Rostelecom, regjistrimi i thirrjeve aktivizohet në llogarinë tuaj personale. Duke përdorur API-në, mund të gjurmoni statusin e këtij funksioni. Kur përpunoni një përfundim telefonate në call_events ju mund të shihni flamurin 'është_rekord', e cila njofton përdoruesin për statusin e hyrjes: i vërtetë do të thotë që funksioni i regjistrimit të thirrjeve të përdoruesit është i aktivizuar.
Për të shkarkuar një regjistrim, duhet të përdorni ID-në e seancës së telefonatës seanca_id dërgoni një kërkesë tek api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Si përgjigje, do të merrni një lidhje të përkohshme për të shkarkuar një skedar me një regjistrim të bisedës.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Koha e ruajtjes së skedarit caktohet në cilësimet e llogarisë tuaj personale. Më pas skedari do të fshihet.
Statistikat dhe raportimet
Në llogarinë tuaj personale në një faqe të veçantë mund të shihni statistikat dhe raportimet për të gjitha thirrjet dhe të aplikoni filtra sipas statusit dhe kohës. Nëpërmjet API-së, fillimisht duhet të përpunoni thirrjen me metodën /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"
}
Pastaj thirrni metodën telefononi_info për të përpunuar grupin dhe për të shfaqur thirrjen në sistemin CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Si përgjigje, ju do të merrni një grup të dhënash që mund të përpunohen për të ruajtur të dhënat në regjistrin e 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":""
}
}
Karakteristika të tjera të dobishme virtuale PBX
Përveç API-së, një PBX virtual ka disa veçori të tjera të dobishme që mund t'i përdorni. Për shembull, kjo është një menu interaktive zanore dhe integrimi i komunikimeve celulare dhe fikse.
Përgjigja zanore interaktive (IVR) është ajo që dëgjojmë në celularin përpara se personi të përgjigjet. Në thelb, ky është një operator elektronik që ridrejton thirrjet në departamentet përkatëse dhe u përgjigjet disa pyetjeve automatikisht. Së shpejti do të jetë e mundur të punohet me IVR nëpërmjet API-së: aktualisht jemi duke zhvilluar softuer që do t'ju lejojë të gjurmoni përparimin e një telefonate përmes IVR dhe të merrni informacione rreth goditjeve të tasteve me tone prekje kur pajtimtari është në menynë zanore.
Për të transferuar telefoninë e korporatës në telefonat celularë, mund të përdorni ose aplikacionet e telefonave të butë ose të aktivizoni veçmas shërbimin Fiks Mobile Convergence (FMC). Me ndonjë nga metodat, thirrjet brenda rrjetit janë falas, bëhet e mundur të punohet me numra të shkurtër dhe mund të regjistrohen telefonatat dhe të mbahen statistika të përgjithshme për to.
Dallimi është se telefonat e butë kanë nevojë për internet për të komunikuar, por nuk janë të lidhur me një operator, ndërsa FMC është i lidhur me një operator specifik, por mund të përdoret edhe në telefonat e vjetër me butona.
Burimi: www.habr.com