Tha gnìomhachas an latha an-diugh a’ faicinn fònaichean loidhne-tìre mar theicneòlas seann-fhasanta: tha conaltradh cealla a’ dèanamh cinnteach gu bheil gluasad agus cothrom cunbhalach air luchd-obrach, lìonraidhean sòisealta agus teachdairean sa bhad nan sianal conaltraidh nas fhasa agus nas luaithe. Gus cumail suas ris na farpaisich aca, tha PBXs oifis a’ fàs nas coltaiche riutha: tha iad a’ gluasad chun sgòth, air an riaghladh tro eadar-aghaidh lìn agus air am filleadh a-steach le siostaman eile tro API. Anns an dreuchd seo innsidh sinn dhut dè na gnìomhan a tha aig Rostelecom virtual PBX API agus mar a dh’ obraicheas tu le prìomh dhleastanasan an PBX brìgheil troimhe.
Is e prìomh obair API PBX brìgheil Rostelecom eadar-obrachadh le CRM no làraich-lìn chompanaidhean. Mar eisimpleir, bidh an API a’ buileachadh widgets “gairm air ais” agus “gairm bhon làrach” airson na prìomh shiostaman riaghlaidh: WordPress, Bitrix, OpenCart. Tha an API a’ ceadachadh:
- Faigh fiosrachadh, cuir fios gu inbhe agus cuir fiosan air iarrtas bho shiostam bhon taobh a-muigh;
- Faigh ceangal sealach gus an còmhradh a chlàradh;
- Stiùirich agus faigh crìochan cuibhreachaidh bho luchd-cleachdaidh;
- Faigh fiosrachadh mun neach-cleachdaidh brìgheil PBX;
- Iarr eachdraidh fiachan is cosgaisean fòn;
- Luchdaich a-nuas gairm log.
Mar a tha an API ag obair
Bidh an API amalachaidh agus an siostam taobh a-muigh ag eadar-obrachadh le chèile a’ cleachdadh iarrtasan HTTP. Anns a’ chunntas phearsanta, bidh an rianaire a’ suidheachadh nan seòlaidhean far am bu chòir iarrtasan don API ruighinn agus far am bu chòir iarrtasan bhon API a chuir. Feumaidh seòladh poblach a bhith aig an t-siostam taobh a-muigh a tha ruigsinneach bhon eadar-lìn le teisteanas SSL stàlaichte.
Cuideachd anns a’ chunntas phearsanta, faodaidh rianadair na h-àrainn tùsan iarrtasan a chuingealachadh nuair a gheibh e cothrom air an API le IP.
Bidh sinn a’ faighinn fiosrachadh mu luchd-cleachdaidh brìgheil PBX
Gus liosta de luchd-cleachdaidh no buidhnean fhaighinn, feumaidh tu iarrtas a chuir chun PBX brìgheil a ’cleachdadh an dòigh /luchd-cleachdaidh_fiosrachaidh.
{
"domain":"example.ru"
}
Mar fhreagairt, gheibh thu liosta as urrainn dhut a shàbhaladh.
{
"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^_^]
}
]
Bidh an dòigh seo a 'dol seachad air dà shreath. Aon le luchd-cleachdaidh fearainn, aon le buidhnean fearainn. Tha cothrom aig a’ bhuidheann cuideachd post-d a shònrachadh a thèid a chuir san iarrtas.
A’ làimhseachadh fiosrachadh mu ghairm a tha a’ tighinn a-steach
Le bhith a’ ceangal fònadh corporra ri diofar shiostaman CRM bidh sin a’ sàbhaladh ùine dha luchd-obrach a bhios ag eadar-obrachadh le teachdaichean agus a’ luathachadh làimhseachadh fiosan a thig a-steach. Mar eisimpleir, air gairm bho neach-dèiligidh gnàthach, faodaidh CRM a chairt fhosgladh, agus bho CRM faodaidh tu fios a chuir chun neach-dèiligidh agus a cheangal ri neach-obrach.
Gus fiosrachadh fhaighinn mu ghairmean API, feumaidh tu an dòigh a chleachdadh /faigh_number_info, a chruthaicheas liosta de ghairmean le fiosrachadh mun bhuidheann ris a bheil an gairm air a sgaoileadh. Gabhamaid ris gum faigh an àireamh PBX mas-fhìor fios a thig a-steach bhon àireamh 1234567890. An uairsin cuiridh am PBX an t-iarrtas 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":""
}
An uairsin feumaidh tu an inneal-làimhe a cheangal /faigh_number_info. Feumar an t-iarrtas a chuir an gnìomh nuair a thig fios a-steach don loidhne a tha a’ tighinn a-steach mus tèid na fiosan a chuir a-steach. Mura faighear freagairt do iarrtas taobh a-staigh na h-ùine ainmichte, thèid a’ ghairm a stiùireadh a rèir nan riaghailtean a chaidh a stèidheachadh san raon.
Eisimpleir de neach-làimhseachaidh air taobh 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;
Freagairt bhon neach-làimhseachaidh.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Bidh sinn a’ cumail sùil air an inbhe agus a’ luchdachadh sìos clàraidhean gairm
Ann am PBX brìgheil Rostelecom, tha clàradh gairm air a chuir an gnìomh sa chunntas pearsanta agad. A’ cleachdadh an API, faodaidh tu sùil a chumail air inbhe a’ ghnìomh seo. Nuair a bhios tu a’ làimhseachadh crìoch gairm a-steach call_tachartasan chì thu am bratach 'is_record', a bheir fios don neach-cleachdaidh mu inbhe an inntrig: fìor a’ ciallachadh gu bheil gnìomh clàraidh gairm an neach-cleachdaidh air a chomasachadh.
Gus clàradh a luchdachadh sìos, feumaidh tu ID an t-seisein gairm a chleachdadh seisean_id cuir iarrtas gu api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mar fhreagairt, gheibh thu ceangal sealach gus faidhle a luchdachadh sìos le clàradh den chòmhradh.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Tha an ùine stòraidh faidhle air a shuidheachadh anns na roghainnean cunntas pearsanta agad. Às deidh sin thèid am faidhle a dhubhadh às.
Staitistig agus aithris
Anns a’ chunntas pearsanta agad air duilleag air leth chì thu staitistig agus aithris air a h-uile gairm agus cuir sìoltachain an sàs a rèir inbhe is ùine. Tron API, feumaidh tu an gairm a phròiseasadh leis an dòigh an-toiseach /call_tachartasan:
{
"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"
}
An uairsin cuir fòn chun dòigh-obrach fios_fios gus an raon a phròiseasadh agus a’ ghairm a thaisbeanadh san t-siostam CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mar fhreagairt, gheibh thu sreath de dhàta a dh'fhaodar a phròiseasadh gus dàta a stòradh ann an 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":""
}
}
Feartan feumail PBX brìgheil eile
A bharrachd air an API, tha grunn fheartan feumail eile aig PBX brìgheil as urrainn dhut a chleachdadh. Mar eisimpleir, is e clàr guth eadar-ghnìomhach a tha seo agus amalachadh conaltraidh ceallach is stèidhichte.
Is e Freagairt Guth Eadar-ghnìomhach (IVR) na chluinneas sinn air an inneal-làimhe mus freagair an neach. Gu bunaiteach, is e gnìomhaiche dealanach a tha seo a bhios ag ath-stiùireadh fiosan gu na roinnean iomchaidh agus a ’freagairt cuid de cheistean gu fèin-ghluasadach. A dh’ aithghearr bidh e comasach obrachadh le IVR tron API: tha sinn an-dràsta a’ leasachadh bathar-bog a leigeas leat sùil a chumail air adhartas gairm tron IVR agus fiosrachadh fhaighinn mu phrìomh bhuillean-tòna nuair a tha an neach-clàraidh sa chlàr guth.
Gus fòn corporra a ghluasad gu fònaichean-làimhe, faodaidh tu an dàrna cuid tagraidhean fòn bog a chleachdadh no an t-seirbheis Fixed Mobile Convergence (FMC) a chuir an gnìomh air leth. Le gin de na dòighean, tha fiosan taobh a-staigh an lìonra an-asgaidh, bidh e comasach obrachadh le àireamhan goirid, agus faodar fiosan a chlàradh agus faodar staitistig coitcheann a chumail orra.
Is e an eadar-dhealachadh gu bheil feum aig fònaichean bog air an eadar-lìn airson conaltradh, ach chan eil iad ceangailte ri gnìomhaiche, fhad ‘s a tha FMC ceangailte ri gnìomhaiche sònraichte, ach faodar a chleachdadh eadhon air seann fhònaichean putan putaidh.
Source: www.habr.com