Rostelecom fíorúil PBX: cad agus conas is féidir a dhéanamh trí API

Rostelecom fíorúil PBX: cad agus conas is féidir a dhéanamh trí API

Feictear do ghnólachtaí nua-aimseartha fóin líne talún mar theicneolaíocht atá as dáta: cinntíonn cumarsáid cheallacha soghluaisteacht agus infhaighteacht leanúnach fostaithe, is bealach cumarsáide níos éasca agus níos tapúla iad líonraí sóisialta agus teachtairí meandracha. Chun coimeád suas lena n-iomaitheoirí, tá PBXanna oifige ag éirí níos cosúla leo: tá siad ag bogadh go dtí an scamall, á mbainistiú trí chomhéadan gréasáin agus comhtháite le córais eile trí API. Sa phost seo inseoimid duit cad iad na feidhmeanna atá ag API PBX fíorúil Rostelecom agus conas oibriú le príomhfheidhmeanna an PBX fíorúil tríd.

Is é príomhthasc API PBX fíorúil Rostelecom ná idirghníomhú le láithreáin ghréasáin CRM nó cuideachtaí. Mar shampla, cuireann an API giuirléidí “glao ar ais” agus “glao ón suíomh” i bhfeidhm do na príomhchórais bhainistíochta: WordPress, Bitrix, OpenCart. Ceadaíonn an API:

  • Faisnéis a fháil, stádas a chur ar an eolas agus glaonna a dhéanamh arna iarraidh sin ó chóras seachtrach;
  • Faigh nasc sealadach chun an comhrá a thaifeadadh;
  • Bainistigh agus faigh paraiméadair srianta ó úsáideoirí;
  • Faigh faisnéis faoin úsáideoir fíorúil PBX;
  • Iarr stair dochair agus muirear glaonna;
  • Íosluchtaigh logáil isteach glaonna.

Conas a oibríonn an API

Idirghníomhaíonn an API comhtháthú agus an córas seachtrach lena chéile ag baint úsáide as iarratais HTTP. Sa chuntas pearsanta, socraíonn an riarthóir na seoltaí inar cheart iarratais chuig an API a theacht agus áit ar cheart iarratais ón API a sheoladh. Ní mór seoladh poiblí a bheith ag an gcóras seachtrach atá inrochtana ón Idirlíon le teastas SSL suiteáilte.

Rostelecom fíorúil PBX: cad agus conas is féidir a dhéanamh trí API

Chomh maith leis sin sa chuntas pearsanta, is féidir leis an riarthóir fearainn teorainn a chur le foinsí na n-iarratas nuair a bhíonn rochtain aige ar an API trí IP. 

Faighimid faisnéis faoi úsáideoirí fíorúla PBX 

Chun liosta úsáideoirí nó grúpaí a fháil, ní mór duit iarratas a sheoladh chuig an PBX fíorúil ag baint úsáide as an modh /úsáideoirí_eolas.

{
        "domain":"example.ru"
}

Mar fhreagra, gheobhaidh tú liosta gur féidir leat a shábháil.

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

Gabhann an modh seo dhá eagair. Ceann le húsáideoirí fearainn, ceann le grúpaí fearainn. Tá deis ag an ngrúpa freisin ríomhphost a shonrú a sheolfar san iarratas.

Faisnéis a phróiseáil faoi ghlao ag teacht isteach

Trí theileafónaíocht chorparáideach a nascadh le córais éagsúla CRM sábhálann sé am d’fhostaithe a idirghníomhaíonn le cliaint agus cuireann sé dlús le próiseáil glaonna isteach. Mar shampla, ar ghlao ó chliant reatha, is féidir le CRM a chárta a oscailt, agus ó CRM is féidir leat glaoch a sheoladh chuig an gcliant agus é a nascadh le fostaí.

Chun faisnéis a fháil faoi ghlaonna API, ní mór duit an modh a úsáid /faigh_uimhir_eolas, a ghineann liosta glaonna le faisnéis faoin ngrúpa a ndéantar an glao a dháileadh air. Glacaimid leis go bhfaigheann an uimhir fhíorúil PBX glaoch isteach ón uimhir 1234567890. Ansin seolfaidh an PBX an t-iarratas seo a leanas:

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

Ansin ní mór duit an láimhseálaí a nascadh /faigh_uimhir_eolas. Ní mór an t-iarratas a fhorghníomhú nuair a thagann glao isteach ar an líne isteach sula gcuirtear na glaonna ar aghaidh. Mura bhfaightear freagra ar iarratas laistigh den am sonraithe, déantar an glao a stiúradh de réir na rialacha atá bunaithe san fhearann.

Sampla de láimhseálaí ar thaobh an 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;

Freagra ón láimhseálaí.

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

Déanaimid an stádas a rianú agus taifeadtaí glaonna a íoslódáil

I PBX fíorúil Rostelecom, cuirtear taifeadadh glaonna i ngníomh i do chuntas pearsanta. Trí úsáid a bhaint as an API, is féidir leat stádas na feidhme seo a rianú. Nuair a phróiseáiltear foirceannadh glaonna isteach glaonna_imeachtaí is féidir leat an bhratach a fheiceáil 'is_record', a chuireann stádas na hiontrála in iúl don úsáideoir: fíor ciallaíonn sé go bhfuil feidhm taifeadta glaonna an úsáideora cumasaithe.

Chun taifeadadh a íoslódáil, ní mór duit ID an tseisiúin ghlao a úsáid seisiún_id iarratas a sheoladh chuig api.cloudpbx.rt.ru/get_record.

{
        "session_id":"SDsnZugDFmTW7Sec"
}

Mar fhreagra, gheobhaidh tú nasc sealadach chun comhad a íoslódáil le taifeadadh den chomhrá.

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

Socraítear an t-am stórála comhad i do shocruithe cuntais phearsanta. Ina dhiaidh sin scriosfar an comhad.

Staitisticí agus tuairisciú

I do chuntas pearsanta ar leathanach ar leith is féidir leat staitisticí agus tuairisciú ar gach glao a fheiceáil agus scagairí a chur i bhfeidhm de réir stádais agus ama. Tríd an API, ní mór duit an glao a phróiseáil ar dtús leis an modh /glaoch_imeachtaí:

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

Ansin glaoch ar an modh glaoch_eolas chun an t-eagar a phróiseáil agus an glao a thaispeáint sa chóras CRM.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

Mar fhreagra air sin, gheobhaidh tú raon sonraí is féidir a phróiseáil chun sonraí a stóráil sa loga 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":""
        }
}

Gnéithe úsáideacha eile PBX fíorúil

Seachas an API, tá roinnt gnéithe úsáideacha eile ag PBX fíorúil ar féidir leat a úsáid. Mar shampla, is roghchlár gutha idirghníomhach é seo agus cumarsáid cheallacha agus seasta a chomhtháthú.

Is é Freagra Gutha Idirghníomhach (IVR) an méid a chloisimid ar an teileafón sula bhfreagraíonn an duine. Go bunúsach, is oibreoir leictreonach é seo a atreoraíonn glaonna chuig na ranna cuí agus a fhreagraíonn roinnt ceisteanna go huathoibríoch. Go gairid beifear in ann oibriú le IVR tríd an API: tá bogearraí á bhforbairt againn faoi láthair a ligfidh duit dul chun cinn glao tríd an IVR a rianú agus faisnéis a fháil faoi eochairbhuillí ton tadhaill nuair a bhíonn an suibscríobhaí sa roghchlár gutha.

Chun teileafónaíocht chorparáideach a aistriú go fóin phóca, is féidir leat feidhmchláir bhogfhóin a úsáid nó an tseirbhís um Chóineasú Soghluaiste Seasta (FMC) a ghníomhachtú ar leithligh. Le haon cheann de na modhanna, tá glaonna laistigh den líonra saor in aisce, is féidir oibriú le huimhreacha gearr, agus is féidir glaonna a thaifeadadh agus staitisticí ginearálta a choinneáil orthu. 

Is é an difríocht ná go dteastaíonn an tIdirlíon ar fhóin bhog chun cumarsáid a dhéanamh, ach níl siad ceangailte le hoibreoir, cé go bhfuil FMC ceangailte le hoibreoir ar leith, ach is féidir é a úsáid fiú ar sheanfhóin bhrú-chnaipe.

Foinse: will.com

Add a comment