Ростелеком АТС виртуалӣ: чӣ ва чӣ гуна метавон тавассути API анҷом дод

Ростелеком АТС виртуалӣ: чӣ ва чӣ гуна метавон тавассути API анҷом дод

Тиҷорати муосир телефонҳои статсионариро ҳамчун технологияи кӯҳна қабул мекунад: алоқаи мобилӣ ҳаракат ва дастрасии доимии кормандонро таъмин мекунад, шабакаҳои иҷтимоӣ ва мессенҷерҳои фаврӣ канали осонтар ва зудтари иртибот мебошанд. Барои бо рақибони худ нигоҳ доштан, АТС-ҳои офисӣ ба онҳо бештар шабоҳат доранд: онҳо ба абр ҳаракат мекунанд, тавассути интерфейси веб идора мешаванд ва бо дигар системаҳо тавассути API ҳамгиро мешаванд. Дар ин мақола мо ба шумо мегӯям, ки API-и виртуалии Ростелеком кадом вазифаҳоро дорад ва чӣ гуна бо вазифаҳои асосии АТС-и виртуалӣ тавассути он кор кардан мумкин аст.

Вазифаи асосии API виртуалии PBX Rostelecom ҳамкорӣ бо CRM ё вебсайтҳои ширкат мебошад. Масалан, API барои системаҳои асосии идоракунӣ виджетҳои "бозгашт" ва "занг аз сайт" -ро амалӣ мекунад: WordPress, Bitrix, OpenCart. API имкон медиҳад:

  • Гирифтани маълумот, огоҳ кардани вазъ ва занг задан бо дархост аз системаи беруна;
  • Барои сабти сӯҳбат истиноди муваққатӣ гиред;
  • Параметрҳои маҳдудиятҳоро аз корбарон идора ва қабул кунед;
  • Дар бораи корбари виртуалии АТС маълумот гиред;
  • Таърихи дебетҳо ва пардохтҳои зангро дархост кунед;
  • Сабти зангро бор кунед.

Чӣ тавр API кор мекунад

API-и ҳамгироӣ ва системаи беруна бо истифода аз дархостҳои HTTP бо ҳамдигар ҳамкорӣ мекунанд. Дар ҳисоби шахсӣ, администратор суроғаҳоеро муқаррар мекунад, ки дархостҳо ба API бояд ворид шаванд ва ба куҷо дархостҳо аз API фиристода шаванд. Системаи беруна бояд суроғаи умумие дошта бошад, ки аз Интернет бо сертификати насбшудаи SSL дастрас аст.

Ростелеком АТС виртуалӣ: чӣ ва чӣ гуна метавон тавассути API анҷом дод

Инчунин дар ҳисоби шахсӣ, маъмури домен метавонад манбаъҳои дархостҳоро ҳангоми дастрасӣ ба API тавассути IP маҳдуд кунад. 

Мо дар бораи корбарони виртуалии PBX маълумот мегирем 

Барои гирифтани рӯйхати корбарон ё гурӯҳҳо, шумо бояд бо истифода аз усул ба АТС-и виртуалӣ дархост фиристед /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>"
}

Мо вазъиятро пайгирӣ мекунем ва сабтҳои зангро зеркашӣ мекунем

Дар PBX виртуалии Ростелеком сабти зангҳо дар ҳисоби шахсии шумо фаъол карда мешавад. Бо истифода аз API, шумо метавонед ҳолати ин функсияро пайгирӣ кунед. Ҳангоми коркарди қатъи занг дар занг_ҳодисаҳо байракчаро дидан мумкин аст 'record аст', ки корбарро дар бораи ҳолати вуруд огоҳ мекунад: ҳақиқӣ маънои онро дорад, ки функсияи сабти занги корбар фаъол аст.

Барои зеркашии сабт, шумо бояд ID сеанси зангро истифода баред 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"
        }

Сипас усулро даъват кунед занг_маълумот барои коркарди массив ва намоиш додани занг дар системаи 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":""
        }
}

Дигар хусусиятҳои муфиди виртуалии PBX

Ба ғайр аз API, PBX виртуалӣ дорои якчанд хусусиятҳои муфиди дигаре мебошад, ки шумо метавонед онҳоро истифода баред. Масалан, ин менюи интерактивии овозӣ ва ҳамгироии алоқаи мобилӣ ва собит мебошад.

Ҷавоби интерактивии овозӣ (IVR) он чизест, ки мо пеш аз посух додан ба телефон дар телефон мешунавем. Аслан, ин як оператори электронӣ мебошад, ки зангҳоро ба шӯъбаҳои дахлдор равона мекунад ва ба баъзе саволҳо ба таври худкор ҷавоб медиҳад. Ба наздикӣ бо IVR тавассути API кор кардан мумкин аст: мо ҳоло нармафзореро таҳия карда истодаем, ки ба шумо имкон медиҳад, ки ҷараёни занг тавассути IVR пайгирӣ кунед ва ҳангоми дар менюи овозӣ будани муштарӣ дар бораи пахши тугмаҳои ламсӣ маълумот гиред.

Барои интиқоли телефонияи корпоративӣ ба телефонҳои мобилӣ, шумо метавонед барномаҳои нармафзорро истифода баред ё хидмати конвергенсияи собит мобилӣ (FMC) -ро алоҳида фаъол созед. Бо ҳама гуна усулҳо, зангҳо дар дохили шабака ройгон буда, кор бо рақамҳои кӯтоҳ имконпазир мегардад ва зангҳоро сабт кардан ва омори умумиро аз рӯи онҳо нигоҳ доштан мумкин аст. 

Тафовут дар он аст, ки нармафзорҳо барои муошират ба Интернет ниёз доранд, аммо онҳо ба оператор вобаста нестанд, дар ҳоле ки FMC ба оператори мушаххас вобаста аст, аммо онҳоро ҳатто дар телефонҳои кӯҳнаи тугма истифода бурдан мумкин аст.

Манбаъ: will.com

Илова Эзоҳ