Zamonaviy biznes statsionar telefonlarni eskirgan texnologiya sifatida qabul qiladi: uyali aloqa xodimlarning harakatchanligi va doimiy mavjudligini ta'minlaydi, ijtimoiy tarmoqlar va messenjerlar osonroq va tezkor aloqa kanalidir. Raqobatchilardan ortda qolish uchun ofis ATSlari ularga tobora o'xshash bo'lib bormoqda: ular bulutga o'tmoqda, veb-interfeys orqali boshqariladi va API orqali boshqa tizimlar bilan integratsiyalashgan. Ushbu postda biz sizga Rostelecom virtual PBX API-ning qanday funktsiyalari borligini va u orqali virtual PBX-ning asosiy funktsiyalari bilan qanday ishlashni aytib beramiz.
Rostelecom virtual PBX API-ning asosiy vazifasi CRM yoki kompaniya veb-saytlari bilan o'zaro aloqa qilishdir. Masalan, API asosiy boshqaruv tizimlari uchun "qayta qo'ng'iroq" va "saytdan qo'ng'iroq" vidjetlarini amalga oshiradi: WordPress, Bitrix, OpenCart. API quyidagilarga imkon beradi:
- Tashqi tizimdan so'rov bo'yicha ma'lumot olish, holat haqida xabar berish va qo'ng'iroqlarni amalga oshirish;
- Suhbatni yozib olish uchun vaqtinchalik havolani oling;
- Foydalanuvchilardan cheklash parametrlarini boshqarish va qabul qilish;
- Virtual PBX foydalanuvchisi haqida ma'lumot olish;
- Qo'ng'iroqlar debeti va to'lovlari tarixini so'rash;
- Qo'ng'iroqlar jurnalini yuklash.
API qanday ishlaydi
Integratsiya API va tashqi tizim HTTP so'rovlari yordamida bir-biri bilan o'zaro ta'sir qiladi. Shaxsiy kabinetda ma'mur API ga so'rovlar kelishi va API so'rovlari yuborilishi kerak bo'lgan manzillarni o'rnatadi. Tashqi tizim o'rnatilgan SSL sertifikati bilan Internetdan kirish mumkin bo'lgan umumiy manzilga ega bo'lishi kerak.
Shuningdek, shaxsiy hisobda domen ma'muri IP orqali API-ga kirishda so'rovlar manbalarini cheklashi mumkin.
Biz virtual PBX foydalanuvchilari haqida ma'lumot olamiz
Foydalanuvchilar yoki guruhlar ro'yxatini olish uchun siz usul yordamida virtual PBXga so'rov yuborishingiz kerak /users_info.
{
"domain":"example.ru"
}
Bunga javoban siz saqlashingiz mumkin bo'lgan ro'yxatni olasiz.
{
"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^_^]
}
]
Ushbu usul ikkita massivdan o'tadi. Biri domen foydalanuvchilari bilan, biri domen guruhlari bilan. Guruh shuningdek, so'rovda yuboriladigan elektron pochta manzilini ko'rsatish imkoniyatiga ega.
Kiruvchi qo'ng'iroq haqidagi ma'lumotlarni qayta ishlash
Korporativ telefoniyani turli CRM tizimlariga ulash mijozlar bilan muloqot qiladigan xodimlarning vaqtini tejaydi va kiruvchi qo‘ng‘iroqlarni qayta ishlashni tezlashtiradi. Masalan, joriy mijozning qo'ng'irog'i bilan CRM uning kartasini ochishi mumkin va CRM-dan siz mijozga qo'ng'iroq qilishingiz va uni xodim bilan bog'lashingiz mumkin.
API qo'ng'iroqlari haqida ma'lumot olish uchun siz usuldan foydalanishingiz kerak /get_number_info, bu qo'ng'iroqlar tarqatiladigan guruh haqidagi ma'lumotlar bilan qo'ng'iroqlar ro'yxatini yaratadi. Aytaylik, virtual ATS raqami 1234567890 raqamidan kiruvchi qo'ng'iroqni qabul qiladi. Keyin ATS quyidagi so'rovni yuboradi:
{
"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":""
}
Keyinchalik, ishlov beruvchini ulashingiz kerak /get_number_info. Qo'ng'iroqlar yo'naltirilgunga qadar kiruvchi liniyaga kiruvchi qo'ng'iroq kelganda so'rov bajarilishi kerak. Agar so'rovga javob belgilangan vaqt ichida olinmasa, qo'ng'iroq domenda o'rnatilgan qoidalarga muvofiq yo'naltiriladi.
CRM tomonidagi ishlov beruvchiga misol.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Ish beruvchidan javob.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Biz holatni kuzatamiz va qo'ng'iroq yozuvlarini yuklab olamiz
Rostelekomning virtual PBX-da qo'ng'iroqlarni yozib olish shaxsiy hisobingizda faollashtirilgan. API yordamida siz ushbu funksiyaning holatini kuzatishingiz mumkin. Qo'ng'iroqni tugatishni qayta ishlashda call_events bayroqni ko'rishingiz mumkin 'is_record', foydalanuvchini kirish holati haqida xabardor qiladi: haqiqiy foydalanuvchi qo‘ng‘iroqlarini yozib olish funksiyasi yoqilganligini bildiradi.
Yozuvni yuklab olish uchun siz qo'ng'iroq seansi identifikatoridan foydalanishingiz kerak session_id ga so'rov yuboring api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Bunga javoban siz suhbatning yozuvi bilan faylni yuklab olish uchun vaqtinchalik havola olasiz.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Faylni saqlash vaqti shaxsiy hisobingiz sozlamalarida o'rnatiladi. Shundan so'ng fayl o'chiriladi.
Statistik ma'lumotlar va hisobot
Shaxsiy hisob qaydnomangizda alohida sahifada siz barcha qo'ng'iroqlar bo'yicha statistika va hisobotlarni ko'rishingiz, holat va vaqt bo'yicha filtrlarni qo'llashingiz mumkin. API orqali siz avval qo'ng'iroqni usul bilan qayta ishlashingiz kerak /chaqiruv_voqealari:
{
"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"
}
Keyin usulni chaqiring call_info massivni qayta ishlash va qo'ng'iroqni CRM tizimida ko'rsatish uchun.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Bunga javoban siz CRM jurnalida ma'lumotlarni saqlash uchun qayta ishlanishi mumkin bo'lgan bir qator ma'lumotlarni olasiz.
{
"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":""
}
}
Boshqa foydali virtual PBX xususiyatlari
APIdan tashqari, virtual PBX siz foydalanishingiz mumkin bo'lgan yana bir qancha foydali xususiyatlarga ega. Masalan, bu interaktiv ovozli menyu va uyali va statsionar aloqalarning integratsiyasi.
Interaktiv ovozli javob (IVR) - bu odam javob berishdan oldin biz telefonda eshitadigan narsadir. Aslida, bu qo'ng'iroqlarni tegishli bo'limlarga yo'naltiradigan va ba'zi savollarga avtomatik ravishda javob beradigan elektron operator. Tez orada API orqali IVR bilan ishlash mumkin bo‘ladi: biz hozirda IVR orqali qo‘ng‘iroqning borishini kuzatish va abonent ovozli menyuda bo‘lganida sensorli tugmalar bosish haqida ma’lumot olish imkonini beruvchi dasturiy ta’minotni ishlab chiqmoqdamiz.
Korporativ telefoniyani mobil telefonlarga o'tkazish uchun siz dasturiy ta'minot ilovalaridan foydalanishingiz yoki Fixed Mobile Convergence (FMC) xizmatini alohida faollashtirishingiz mumkin. Har qanday usul yordamida tarmoq ichidagi qo'ng'iroqlar bepul, qisqa raqamlar bilan ishlash mumkin bo'ladi va qo'ng'iroqlarni yozib olish va ular bo'yicha umumiy statistikani saqlash mumkin.
Farqi shundaki, dasturiy telefonlar muloqot qilish uchun Internetga muhtoj, biroq ular operatorga bog‘lanmagan, FMC esa ma’lum bir operatorga bog‘langan, lekin hatto eski tugmachali telefonlarda ham foydalanish mumkin.
Manba: www.habr.com