Rostelecom virtual PBX: he aha me pehea te mahi ma te API

Rostelecom virtual PBX: he aha me pehea te mahi ma te API

Ko nga pakihi o naianei e kii ana ko nga waea waea whenua he hangarau tawhito: ko nga whakawhitiwhitinga waea e whakarite ana i te nekeneke me te waatea tonu o nga kaimahi, nga hononga hapori me nga karere tere he huarahi korero ngawari me te tere. Kia mau tonu ki o raatau whakataetae, kei te kaha ake te ahua o nga PBX tari ki a raatau: kei te neke ki te kapua, ka whakahaerehia ma te atanga tukutuku me te whakauru ki etahi atu punaha ma te API. I tenei pou ka korero atu matou ki a koe he aha nga mahi a te Rostelecom virtual PBX API me pehea te mahi me nga mahi matua o te PBX mariko ma roto.

Ko te mahi matua o te Rostelecom virtual PBX API ko te taunekeneke ki te CRM, ki nga paetukutuku kamupene ranei. Hei tauira, ka whakatinanahia e te API nga widget "karanga hoki" me te "karanga mai i te pae" mo nga punaha whakahaere matua: WordPress, Bitrix, OpenCart. Ka whakaaetia e te API:

  • Whiwhi korero, whakamohio i te mana me te waea i runga i te tono mai i tetahi punaha o waho;
  • Tikina he hononga rangitahi hei tuhi i te korerorero;
  • Whakahaere me te whiwhi i nga tawhā here mai i nga kaiwhakamahi;
  • Tikina nga korero mo te kaiwhakamahi PBX mariko;
  • Tonoa te hitori o nga nama waea me nga utu;
  • Tukuake rangitaki karanga.

Me pehea te mahi a te API

Ko te API whakauru me te punaha o waho e taunekeneke ana tetahi ki tetahi ma te whakamahi i nga tono HTTP. I roto i te kaute whaiaro, ka tautuhia e te kaiwhakahaere nga wahitau ka tae mai nga tono ki te API me te tuku tono mai i te API. Me whai wāhitau tūmatanui te punaha o waho mai i te Ipurangi me te tiwhikete SSL kua whakauruhia.

Rostelecom virtual PBX: he aha me pehea te mahi ma te API

I roto ano i te kaute whaiaro, ka taea e te kaiwhakahaere rohe te whakaiti i nga puna o nga tono ka uru atu ki te API ma te IP. 

Ka whiwhi korero matou mo nga kaiwhakamahi PBX mariko 

Ki te tiki i te rarangi o nga kaiwhakamahi, roopu ranei, me tuku he tono ki te PBX mariko ma te whakamahi i te tikanga /users_info.

{
        "domain":"example.ru"
}

Hei whakautu, ka whiwhi koe i tetahi rarangi ka taea e koe te tiaki.

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

Ka tukuna e tenei tikanga nga rarangi e rua. Ko tetahi me nga kaiwhakamahi rohe, tetahi me nga roopu rohe. Ka whai waahi ano te roopu ki te tohu i tetahi imeera ka tukuna i roto i te tono.

Tukatuka korero mo te waea taumai

Ko te hono atu i nga waea rangatōpū ki nga momo punaha CRM ka penapena wa mo nga kaimahi e taunekeneke ana me nga kaihoko me te tere ake i te tukatuka o nga waea taumai. Hei tauira, i runga i te waea mai i tetahi kaihoko o naianei, ka taea e CRM te whakatuwhera i tana kaari, a mai i te CRM ka taea e koe te tuku waea ki te kaihoko me te hono atu ki tetahi kaimahi.

Hei tiki korero mo nga waea API, me whakamahi koe i te tikanga / whiwhi_number_info, ka whakaputa i te rarangi o nga waea me nga korero mo te roopu ka tohatohahia te waea. Me whakaaro ka whiwhi te nama PBX mariko i te waea taumai mai i te nama 1234567890. Na ka tukuna e te PBX te tono e whai ake nei:

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

I muri mai me hono koe i te kaihautu / whiwhi_number_info. Me mahi te tono ina tae mai he waea taumai ki te raina taumai i mua i te tuku waea. Mena kaore he whakautu ki te tono i roto i te waa kua tohua, ka tukuna te waea ki runga i nga ture kua whakaritea ki te rohe.

He tauira o te kaihautu i te taha 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;

Te whakautu a te kaihautu.

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

Ka whai matou i te mana me te tango i nga rekoata waea

I roto i te PBX mariko a Rostelecom, ka whakahohehia te tuhi waea i roto i to putea whaiaro. Ma te whakamahi i te API, ka taea e koe te whai i te mana o tenei mahi. I te wa e tukatuka ana i te whakamutu waea ki roto karanga_takahanga ka kite koe i te haki 'ko_rekoata', e whakamohio ana ki te kaiwhakamahi mo te mana o te urunga: pono te tikanga ka taea te mahi tuhi waea a te kaiwhakamahi.

Hei tango i te rekoata, me whakamahi koe i te ID hui waea session_id tuku tono ki api.cloudpbx.rt.ru/get_record.

{
        "session_id":"SDsnZugDFmTW7Sec"
}

Hei whakautu, ka whiwhi koe i tetahi hononga rangitahi ki te tango i tetahi konae me te rekoata o te korerorero.

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

Kua whakaritea te wa rokiroki kōnae ki o tautuhinga pūkete whaiaro. Muri iho ka mukua te konae.

Te tatauranga me te ripoata

I roto i to putea whaiaro i runga i tetahi wharangi motuhake ka taea e koe te kite i nga tatauranga me te ripoata mo nga waea katoa me te whakamahi i nga whiriwhiringa ma te mana me te wa. Na roto i te API, me mahi tuatahi koe i te waea me te tikanga /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"
        }

Na ka karangahia te tikanga karanga_info ki te tukatuka i te huinga me te whakaatu i te piiraa ki te punaha CRM.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

Hei whakautu, ka whiwhi koe i te huinga o nga raraunga ka taea te tukatuka hei penapena raraunga ki te raarangi 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":""
        }
}

Ētahi atu āhuatanga PBX mariko whai hua

I tua atu i te API, he maha atu nga waahanga whaihua o te PBX mariko ka taea e koe te whakamahi. Hei tauira, he tahua reo pahekoheko tenei me te whakaurunga o nga whakawhitinga waea pūkoro me te pumau.

Ko te Whakautu Reo Pahekoheko (IVR) ko ta tatou e rongo ai i runga i te ringaringa i mua i te whakautu a te tangata. Ko te tikanga, he kaiwhakahaere hiko tenei ka huri i nga waea ki nga tari e tika ana, ka whakautu aunoa i etahi patai. Kare e roa ka taea te mahi tahi me te IVR ma te API: kei te whakawhanake matou i nga rorohiko e taea ai e koe te whai i te ahunga whakamua o te waea ma te IVR me te whiwhi korero mo nga peera pa-tone i te wa e noho ana te kaiohauru ki te tahua reo.

Hei whakawhiti waea rangatōpū ki nga waea pukoro, ka taea e koe te whakamahi i nga tono waea ngohengohe, te whakahohe wehe ranei i te ratonga Fixed Mobile Convergence (FMC). Ma tetahi o nga tikanga, he kore utu nga waea i roto i te whatunga, ka taea te mahi me nga nama poto, ka taea te tuhi waea me te pupuri i nga tatauranga whanui ki runga. 

Ko te rereketanga ko nga waea ngohengohe e hiahia ana ki te Ipurangi ki te whakawhitiwhiti korero, engari kaore i te herea ki tetahi kaiwhakahaere, ko te FMC e herea ana ki tetahi kaiwhakahaere motuhake, engari ka taea te whakamahi ahakoa i runga i nga waea patene tawhito.

Source: will.com

Tāpiri i te kōrero