Заманбап бизнес стационардык телефондорду эскирген технология катары кабыл алат: уюлдук байланыш кызматкерлердин мобилдүүлүгүн жана туруктуу болушун камсыздайт, социалдык тармактар жана мессенджерлер байланыштын оңой жана тез каналы болуп саналат. Атаандаштарынан артта калбоо үчүн кеңсе АТСтери аларга барган сайын окшош болуп баратат: алар булутка өтүп, веб-интерфейс аркылуу башкарылат жана API аркылуу башка системалар менен интеграцияланууда. Бул постто биз сизге Ростелекомдун виртуалдык АТС API кандай функциялары бар экенин жана ал аркылуу виртуалдык АТСтин негизги функциялары менен кантип иштөө керектигин айтып беребиз.
Rostelecom виртуалдык АТС API негизги милдети CRM же компаниянын веб-сайттары менен өз ара аракеттенүү болуп саналат. Мисалы, API негизги башкаруу системалары үчүн “кайра чалуу” жана “сайттан чалуу” виджеттерин ишке ашырат: WordPress, Bitrix, OpenCart. API мүмкүндүк берет:
- тышкы системанын суроо-талабы боюнча маалымат алуу, абалды билдирүү жана чалууларды жасоо;
- Сүйлөшүүнү жаздыруу үчүн убактылуу шилтемени алыңыз;
- Колдонуучулардан чектөө параметрлерин башкаруу жана алуу;
- виртуалдык АТС колдонуучусу жөнүндө маалымат алуу;
- Чалуулардын дебеттеринин жана төлөмдөрүнүн тарыхын сураңыз;
- Чалуу журналын жүктөө.
API кантип иштейт
Интеграция API жана тышкы система HTTP сурамдарын колдонуу менен бири-бири менен иштешет. Жеке кабинетте администратор API'ге суроо-талаптар келип түшүүчү даректерди жана API'ден сурамдар жөнөтүлө турган даректерди белгилейт. Тышкы системада орнотулган SSL сертификаты менен Интернеттен жеткиликтүү коомдук дарек болушу керек.
Ошондой эле жеке аккаунтта домендин администратору IP аркылуу APIге кирүүдө сурамдардын булактарын чектей алат.
Виртуалдык АТС колдонуучулары тууралуу маалымат алабыз
Колдонуучулардын же топтордун тизмесин алуу үчүн сиз ыкманы колдонуу менен виртуалдык АТСке суроо-талап жөнөтүшүңүз керек /users_info.
{
"domain":"example.ru"
}
Жооп катары сиз сактай турган тизмени аласыз.
{
"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^_^]
}
]
Бул ыкма эки массивден өтөт. Бири домен колдонуучулары менен, бири домен топтору менен. Топ ошондой эле суроо-талапта жөнөтүлө турган электрондук почтаны көрсөтүү мүмкүнчүлүгүнө ээ.
Кирүүчү чалуу жөнүндө маалыматты иштетүү
Корпоративдик телефонияны ар кандай CRM системаларына туташтыруу кардарлар менен иштешкен кызматкерлердин убактысын үнөмдөйт жана кирген чалууларды иштетүүнү тездетет. Мисалы, учурдагы кардар чалуу боюнча CRM анын картасын ача алат, ал эми CRMден сиз кардарга чалуу жөнөтүп, аны кызматкер менен байланыштыра аласыз.
API чалуулары жөнүндө маалымат алуу үчүн, сиз ыкманы колдонушуңуз керек /get_number_info, ал чалуу таратылган топ жөнүндө маалымат менен чалуулардын тизмесин түзөт. Виртуалдык АТС номери 1234567890 номеринен кирүүчү чалууларды алат деп ойлойлу. Андан кийин АТС төмөнкү суроо-талапты жөнөтөт:
{
"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":""
}
Андан кийин сиз иштеткичти туташтыруу керек /get_number_info. Суроо-талап чалуулар багытталганга чейин кирүүчү линияга кирүүчү чалуу келгенде аткарылышы керек. Эгерде суроо-талапка жооп көрсөтүлгөн убакыттын ичинде алынбаса, анда чалуу доменде белгиленген эрежелерге ылайык багытталат.
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;
Иштөөчүдөн жооп.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Биз статуска көз салып, чалуулардын жазууларын түшүрөбүз
Ростелекомдун виртуалдык АТСинде сиздин жеке кабинетиңизде чалууларды жаздыруу иштетилген. API колдонуп, сиз бул функциянын абалын көзөмөлдөй аласыз. Чалууну токтотууну иштетүүдө чалуу_окуялары желегин көрө аласыз 'жазуу_жазуу', колдонуучуга жазуунун абалы жөнүндө кабарлайт: чыныгы колдонуучунун чалууларды жаздыруу функциясы иштетилгенин билдирет.
Жазууну жүктөп алуу үчүн чалуу сеансынын идентификаторун колдонушуңуз керек session_id суроо жөнөтүү api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Жооп катары сиз сүйлөшүүнүн жазуусу бар файлды жүктөө үчүн убактылуу шилтеме аласыз.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Файлды сактоо убактысы жеке аккаунтуңуздун жөндөөлөрүндө белгиленген. Андан кийин файл жок кылынат.
Статистика жана отчеттуулук
Өзүңүздүн жеке баракчаңызда сиз бардык чалуулар боюнча статистиканы жана отчетту көрө аласыз жана статус жана убакыт боюнча чыпкаларды колдоно аласыз. API аркылуу сиз адегенде чалууну метод менен иштетишиңиз керек /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"
}
Андан кийин ыкманы чакырыңыз call_info массивди иштеп чыгуу жана CRM тутумунда чалууну көрсөтүү.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Жооп катары сиз 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":""
}
}
Башка пайдалуу виртуалдык АТС функциялары
API'ден тышкары, виртуалдык АТСте сиз колдоно ала турган бир нече пайдалуу функциялар бар. Мисалы, бул интерактивдүү үн менюсу жана уюлдук жана стационардык байланыштардын интеграциясы.
Interactive Voice Response (IVR) - бул адам жооп бергенге чейин телефондон уккан нерсе. Негизи бул электрондук оператор, ал чалууларды тиешелүү бөлүмдөргө багыттап, айрым суроолорго автоматтык түрдө жооп берет. Жакында IVR менен API аркылуу иштөө мүмкүн болот: биз учурда IVR аркылуу чалуунун жүрүшүнө көз салууга жана абонент үн менюсунда турганда сенсордук басуу баскычтары жөнүндө маалымат алууга мүмкүндүк берүүчү программалык камсыздоону иштеп чыгуудабыз.
Корпоративдик телефонияны уюлдук телефондорго өткөрүү үчүн сиз софтфондук тиркемелерди колдонсоңуз болот же Fixed Mobile Convergence (FMC) кызматын өзүнчө иштетсеңиз болот. Методдордун кайсынысы менен болбосун, түйүн ичиндеги чалуулар акысыз, кыска номерлер менен иштөө мүмкүн болуп калат, чалуулар жазылып, алар боюнча жалпы статистика сакталышы мүмкүн.
Айырмачылыгы, софтфондор баарлашуу үчүн Интернетке муктаж, бирок алар оператор менен байланышпайт, ал эми ҮМБ белгилүү бир операторго байланган, бирок эски баскычтуу телефондордо да колдонсо болот.
Source: www.habr.com