🥇Rostelecom kama-da-wane PBX: menene kuma ta yaya za a iya yi ta API

Kasuwancin zamani yana la'akari da wayoyi na ƙasa a matsayin tsohuwar fasaha: sadarwar salula yana tabbatar da motsi da kuma kasancewa na ma'aikata akai-akai, cibiyoyin sadarwar jama'a da manzannin nan take tashar sadarwa ce mai sauƙi da sauri. Don ci gaba da fafatawa a gasa, ofishin PBXs suna ƙara kama da su: suna motsawa zuwa gajimare, ana gudanar da su ta hanyar yanar gizo kuma an haɗa su tare da wasu tsarin ta hanyar API. A cikin wannan sakon za mu gaya muku abin da ayyuka na Rostelecom Virtual PBX API yake da su da kuma yadda ake aiki tare da manyan ayyuka na PBX mai kama da ita ta hanyarsa.

Babban aikin Rostelecom kama-da-wane PBX API shine hulɗa tare da CRM ko gidajen yanar gizo na kamfani. Misali, API yana aiwatar da widget din "kira da baya" da "kira daga rukunin yanar gizo" don manyan tsarin gudanarwa: WordPress, Bitrix, OpenCart. API ɗin yana ba da damar:

Karɓi bayanai, sanar da matsayi da yin kira bisa buƙata daga tsarin waje;
Samu hanyar haɗi na ɗan lokaci don yin rikodin tattaunawar;
Sarrafa da karɓar sigogin ƙuntatawa daga masu amfani;
Sami bayanai game da kama-da-wane mai amfani da PBX;
Nemi tarihin biyan kuɗin kira da caji;
Loda rajistar kira.

Yadda API ke aiki

API ɗin haɗin kai da tsarin waje suna hulɗa da juna ta amfani da buƙatun HTTP. A cikin asusun sirri, mai gudanarwa yana saita adiresoshin inda buƙatun API ya kamata su isa kuma inda ya kamata a aika buƙatun API. Dole ne tsarin waje ya sami adireshin jama'a da ake samun dama daga Intanet tare da shigar da takardar shaidar SSL.

Hakanan a cikin asusun sirri, mai gudanar da yanki na iya iyakance tushen buƙatun lokacin samun damar API ta IP.

Muna karɓar bayani game da masu amfani da PBX na yau da kullun

Don samun jerin masu amfani ko ƙungiyoyi, kuna buƙatar aika buƙatu zuwa ga kama-da-wane PBX ta amfani da hanyar /users_info.

{
        "domain":"example.ru"
}

A cikin martani, zaku karɓi lissafin da zaku iya ajiyewa.

{
"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^_^]
                            }
              ]

Wannan hanya ta wuce tsararraki biyu. Ɗaya tare da masu amfani da yanki, ɗaya tare da ƙungiyoyin yanki. Kungiyar kuma tana da damar tantance saƙon imel da za a aika a cikin buƙatar.

Ana sarrafa bayanai game da kira mai shigowa

Haɗa wayar tarho na kamfani zuwa tsarin CRM daban-daban yana adana lokaci ga ma'aikatan da ke mu'amala da abokan ciniki da haɓaka sarrafa kira mai shigowa. Misali, akan kira daga abokin ciniki na yanzu, CRM na iya buɗe katinsa, kuma daga CRM zaku iya aika kira zuwa abokin ciniki kuma ku haɗa shi da ma'aikaci.

Don samun bayani game da kiran API, kuna buƙatar amfani da hanyar /samu_lambar_bayani, wanda ke haifar da jerin kira tare da bayani game da rukunin da aka rarraba kiran zuwa gare shi. Bari mu ɗauka cewa lambar PBX mai kama-da-wane tana karɓar kira mai shigowa daga lamba 1234567890. Sannan PBX zai aika da buƙatun mai zuwa:

{
        "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":""
}

Na gaba kuna buƙatar haɗa mai sarrafa /samu_lambar_bayani. Dole ne a aiwatar da buƙatar lokacin da kira mai shigowa ya zo kan layi mai shigowa kafin a kashe kiran. Idan ba a karɓi amsa ga buƙatun ba a cikin ƙayyadadden lokacin, sa'an nan kuma ana yin kiran kiran bisa ga ƙa'idodin da aka kafa a yankin.

Misalin mai kulawa a gefen 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;

Martani daga mai kula.

{
        "result":0,
        "resultMessage":"Абонент найден",
        "displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}

Muna bin halin da ake ciki kuma muna zazzage rikodin kira

A cikin PBX na Rostelecom, ana kunna rikodin kira a cikin keɓaɓɓen asusun ku. Amfani da API, zaku iya bin diddigin matsayin wannan aikin. Lokacin sarrafa ƙarewar kira a ciki kira_events kana iya ganin tuta 'shi_recod', wanda ke sanar da mai amfani game da matsayin shigarwa: gaskiya yana nufin cewa an kunna aikin rikodin kiran mai amfani.

Don zazzage rikodin, kuna buƙatar amfani da ID na zaman kira zaman_id aika bukata zuwa ga api.cloudpbx.rt.ru/get_record.

{
        "session_id":"SDsnZugDFmTW7Sec"
}

Don amsawa, zaku sami hanyar haɗin ɗan lokaci don zazzage fayil tare da rikodin tattaunawar.

{
        "result": ^_^quot�quot^_^,
        "resultMessage": "Операция выполнена успешно",
    	"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}

An saita lokacin ajiyar fayil a cikin saitunan asusun ku na sirri. Bayan haka za a share fayil ɗin.

Kididdiga da rahoto

A cikin keɓaɓɓen asusun ku akan wani shafi na daban zaku iya ganin ƙididdiga da bayar da rahoto akan duk kira da amfani da masu tacewa ta matsayi da lokaci. Ta hanyar API, dole ne ka fara aiwatar da kiran tare da hanyar /kira_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"
        }

Sannan kira hanyar call_info don aiwatar da tsararru da nuna kira a cikin tsarin CRM.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

Don amsawa, zaku sami jerin bayanai waɗanda za'a iya sarrafa su don adana bayanai a cikin log ɗin 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":""
        }
}

Wasu fasalulluka na PBX masu amfani

Bayan API ɗin, PBX na kama-da-wane yana da wasu fasaloli masu amfani da yawa waɗanda zaku iya amfani da su. Misali, wannan menu na murya ne mai mu'amala da haɗin kai na salon salula da kafaffen sadarwa.

Response Voice Interactive (IVR) shine abin da muke ji akan wayar hannu kafin mutum ya amsa. Mahimmanci, wannan ma'aikacin lantarki ne wanda ke tura kira zuwa sassan da suka dace kuma yana amsa wasu tambayoyi ta atomatik. Ba da daɗewa ba zai yiwu a yi aiki tare da IVR ta hanyar API: a halin yanzu muna haɓaka software wanda zai ba ku damar bin diddigin ci gaban kira ta hanyar IVR kuma ku karɓi bayanai game da maɓallan sautin taɓawa lokacin da mai biyan kuɗi yana cikin menu na murya.

Don canja wurin wayar tarho na kamfani zuwa wayoyin hannu, zaku iya amfani da aikace-aikacen wayar taushi ko kunna sabis ɗin Fixed Mobile Convergence (FMC). Tare da kowane ɗayan hanyoyin, kira a cikin hanyar sadarwar kyauta ne, zai yiwu a yi aiki tare da gajerun lambobi, kuma ana iya yin rikodin kira kuma ana iya adana ƙididdiga na gaba ɗaya akan su.

Bambance-bambancen shi ne, wayoyin hannu suna buƙatar Intanet don sadarwa, amma ba a haɗa su da mai aiki ba, yayin da FMC ke daura da wani takamaiman mai aiki, amma ana iya amfani da su ko da a kan tsofaffin wayoyi.

source: www.habr.com

Rostelecom kama-da-wane PBX: menene kuma ta yaya za a iya yi ta API