Müasir biznes stasionar telefonları köhnəlmiş texnologiya kimi qəbul edir: mobil rabitə işçilərin mobilliyini və daimi əlçatanlığını təmin edir, sosial şəbəkələr və ani messencerlər daha asan və sürətli rabitə kanalıdır. Rəqibləri ilə ayaqlaşa bilmək üçün ofis ATS-ləri getdikcə daha çox onlara bənzəyir: onlar bulud sisteminə keçir, veb interfeys vasitəsilə idarə olunur və API vasitəsilə digər sistemlərlə inteqrasiya olunur. Bu yazıda sizə Rostelecom virtual PBX API-nin hansı funksiyaları olduğunu və onun vasitəsilə virtual PBX-in əsas funksiyaları ilə necə işləməyinizi izah edəcəyik.
Rostelecom virtual PBX API-nin əsas vəzifəsi CRM və ya şirkət saytları ilə qarşılıqlı əlaqədir. Məsələn, API əsas idarəetmə sistemləri üçün “geri zəng” və “saytdan zəng” vidjetlərini tətbiq edir: WordPress, Bitrix, OpenCart. API imkan verir:
- Xarici sistemdən sorğu ilə məlumat almaq, statusu bildirmək və zənglər etmək;
- Söhbəti qeyd etmək üçün müvəqqəti keçid əldə edin;
- İstifadəçilərdən məhdudiyyət parametrlərini idarə etmək və qəbul etmək;
- Virtual ATS istifadəçisi haqqında məlumat əldə etmək;
- Zənglərin debet və ödənişlərinin tarixini tələb edin;
- Zəng jurnalını yükləyin.
API necə işləyir
İnteqrasiya API və xarici sistem HTTP sorğularından istifadə edərək bir-biri ilə qarşılıqlı əlaqədə olur. Şəxsi hesabda administrator API-yə sorğuların gəlməsi və API-dən sorğuların göndərilməli olduğu ünvanları təyin edir. Xarici sistem quraşdırılmış SSL sertifikatı ilə İnternetdən əldə edilə bilən ictimai ünvana malik olmalıdır.
Həmçinin şəxsi hesabda domen inzibatçısı IP vasitəsilə API-yə daxil olarkən sorğuların mənbələrini məhdudlaşdıra bilər.
Biz virtual ATS istifadəçiləri haqqında məlumat alırıq
İstifadəçilərin və ya qrupların siyahısını əldə etmək üçün metoddan istifadə edərək virtual ATS-ə sorğu göndərmək lazımdır /users_info.
{
"domain":"example.ru"
}
Cavab olaraq siz saxlaya biləcəyiniz bir siyahı alacaqsınız.
{
"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^_^]
}
]
Bu üsul iki massivdən keçir. Biri domen istifadəçiləri, biri domen qrupları ilə. Qrup həmçinin sorğuda göndəriləcək e-poçtu müəyyən etmək imkanına malikdir.
Daxil olan zəng haqqında məlumatın işlənməsi
Korporativ telefoniyanın müxtəlif CRM sistemlərinə qoşulması müştərilərlə qarşılıqlı əlaqədə olan işçilərin vaxtına qənaət edir və daxil olan zənglərin işlənməsini sürətləndirir. Məsələn, cari müştərinin zəngi ilə CRM onun kartını aça bilər, CRM-dən isə müştəriyə zəng göndərib onu işçi ilə əlaqələndirə bilərsiniz.
API zəngləri haqqında məlumat əldə etmək üçün metoddan istifadə etməlisiniz /sayı_məlumatını əldə edin, zənglərin yayıldığı qrup haqqında məlumat olan zənglərin siyahısını yaradır. Fərz edək ki, virtual ATS nömrəsi 1234567890 nömrəsindən daxil olan zəngi qəbul edir. Sonra ATS aşağıdakı sorğunu göndərəcək:
{
"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":""
}
Sonra işləyicini birləşdirməlisiniz /sayı_məlumatını əldə edin. Zənglər yönləndirilməmişdən əvvəl daxil olan xəttə daxil olan zəng gəldikdə sorğu yerinə yetirilməlidir. Göstərilən vaxt ərzində sorğuya cavab alınmazsa, zəng domendə müəyyən edilmiş qaydalara uyğun olaraq yönləndirilir.
CRM tərəfindəki işləyici nümunəsi.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
İşləyəndən cavab.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Biz statusu izləyirik və zəng yazılarını yükləyirik
Rostelecom-un virtual PBX-də şəxsi hesabınızda zəng qeydləri aktivləşdirilir. API istifadə edərək, bu funksiyanın vəziyyətini izləyə bilərsiniz. Zəngin dayandırılmasını emal edərkən zəng_hadisələri bayrağı görə bilərsiniz 'rekorddur', istifadəçiyə girişin statusu barədə məlumat verən: doğru istifadəçinin zəng qeydi funksiyasının işə salınması deməkdir.
Qeydi endirmək üçün zəng sessiyasının ID-sindən istifadə etməlisiniz session_id sorğu göndərin api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Cavab olaraq, söhbətin qeydi olan faylı yükləmək üçün müvəqqəti keçid alacaqsınız.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Faylın saxlanma vaxtı şəxsi hesab parametrlərində müəyyən edilir. Bundan sonra fayl silinəcək.
Statistika və hesabat
Ayrı bir səhifədə şəxsi hesabınızda bütün zənglər üzrə statistika və hesabatları görə, status və vaxta görə filtrlər tətbiq edə bilərsiniz. API vasitəsilə siz ilk olaraq zəngi metodla emal etməlisiniz /zəng_hadisələri:
{
"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"
}
Sonra metodu çağırın zəng_məlumatı massivi emal etmək və zəngi CRM sistemində göstərmək üçün.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Cavab olaraq, CRM jurnalında məlumatları saxlamaq üçün emal edilə bilən bir sıra məlumat alacaqsınız.
{
"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":""
}
}
Digər faydalı virtual PBX xüsusiyyətləri
API-dən başqa, virtual ATS-də istifadə edə biləcəyiniz bir sıra digər faydalı xüsusiyyətlər də var. Məsələn, bu, interaktiv səs menyusu və mobil və sabit rabitənin inteqrasiyasıdır.
İnteraktiv Səsli Cavab (IVR) şəxs cavab verməzdən əvvəl telefonda eşitdiyimiz şeydir. Əslində bu, zəngləri müvafiq şöbələrə yönləndirən və bəzi suallara avtomatik cavab verən elektron operatordur. Tezliklə API vasitəsilə IVR ilə işləmək mümkün olacaq: biz hazırda IVR vasitəsilə zəngin gedişatını izləməyə və abunəçi səs menyusunda olarkən toxunma tonlu düymələrin basılması haqqında məlumat almağa imkan verəcək proqram təminatı işləyib hazırlayırıq.
Korporativ telefoniyanı mobil telefonlara ötürmək üçün siz proqram təminatı proqramlarından istifadə edə və ya Sabit Mobil Konvergensiya (FMC) xidmətini ayrıca aktivləşdirə bilərsiniz. Metodlardan hər hansı biri ilə şəbəkədaxili zənglər pulsuzdur, qısa nömrələrlə işləmək mümkün olur və zəngləri qeyd etmək və onlar haqqında ümumi statistika aparmaq olar.
Fərq ondadır ki, softfonlar ünsiyyət qurmaq üçün internetə ehtiyac duyurlar, lakin onlar operatora bağlı deyillər, FMC isə konkret operatora bağlıdır, lakin hətta köhnə düyməli telefonlarda da istifadə oluna bilər.
Mənbə: www.habr.com