In-negozju modern jipperċepixxi t-telefowns fissi bħala teknoloġija skaduta: il-komunikazzjonijiet ċellulari jiżguraw il-mobilità u d-disponibbiltà kostanti tal-impjegati, in-netwerks soċjali u l-messaġġiera instantanja huma kanal ta 'komunikazzjoni eħfef u veloċi. Biex ilaħħqu mal-kompetituri tagħhom, il-PBXs tal-uffiċċju qed isiru dejjem aktar simili għalihom: qed jimxu lejn il-cloud, ġestiti permezz ta 'interface tal-web u integrati ma' sistemi oħra permezz tal-API. F'din il-kariga aħna ngħidulek x'funzjonijiet għandha l-API virtwali tal-PBX Rostelecom u kif taħdem mal-funzjonijiet ewlenin tal-PBX virtwali permezz tagħha.
Il-kompitu ewlieni tar-Rostelecom virtwali PBX API huwa l-interazzjoni ma 'CRM jew websajts tal-kumpanija. Pereżempju, l-API timplimenta widgets ta '"sejħa lura" u "sejħa mis-sit" għas-sistemi ta' ġestjoni ewlenin: WordPress, Bitrix, OpenCart. L-API tippermetti:
- Jirċievi informazzjoni, jinnotifika l-istatus u jagħmel sejħiet fuq talba minn sistema esterna;
- Ikseb link temporanju biex tirreġistra l-konversazzjoni;
- Immaniġġja u tirċievi parametri ta' restrizzjoni mill-utenti;
- Ikseb informazzjoni dwar l-utent virtwali tal-PBX;
- Itlob l-istorja tad-debiti u t-tariffi tas-sejħiet;
- Ittella log tas-sejħiet.
Kif taħdem l-API
L-API ta 'integrazzjoni u s-sistema esterna jinteraġixxu ma' xulxin billi jużaw talbiet HTTP. Fil-kont personali, l-amministratur jistabbilixxi l-indirizzi fejn għandhom jaslu t-talbiet lill-API u fejn għandhom jintbagħtu t-talbiet mill-API. Is-sistema esterna għandu jkollha indirizz pubbliku aċċessibbli mill-Internet b'ċertifikat SSL installat.
Ukoll fil-kont personali, l-amministratur tad-dominju jista’ jillimita s-sorsi tat-talbiet meta jaċċessa l-API bl-IP.
Nirċievu informazzjoni dwar utenti virtwali tal-PBX
Biex tikseb lista ta 'utenti jew gruppi, għandek bżonn tibgħat talba lill-PBX virtwali billi tuża l-metodu /users_info.
{
"domain":"example.ru"
}
Bi tweġiba, inti tirċievi lista li tista 'tiffranka.
{
"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^_^]
}
]
Dan il-metodu jgħaddi żewġ matriċi. Wieħed mal-utenti tad-dominju, wieħed mal-gruppi tad-dominju. Il-grupp għandu wkoll l-opportunità li jispeċifika email li tintbagħat fit-talba.
Ipproċessar informazzjoni dwar telefonata li tkun deħlin
Il-konnessjoni tat-telefonija korporattiva ma 'diversi sistemi CRM tiffranka l-ħin għall-impjegati li jinteraġixxu mal-klijenti u tħaffef l-ipproċessar ta' sejħiet deħlin. Pereżempju, fuq sejħa minn klijent attwali, CRM jista 'jiftaħ il-karta tiegħu, u minn CRM tista' tibgħat sejħa lill-klijent u tikkonnettjah ma 'impjegat.
Biex tikseb informazzjoni dwar sejħiet API, trid tuża l-metodu /get_number_info, li tiġġenera lista ta' sejħiet b'informazzjoni dwar il-grupp li għalih titqassam is-sejħa. Ejja nassumu li n-numru virtwali tal-PBX jirċievi telefonata li tidħol min-numru 1234567890. Imbagħad il-PBX jibgħat it-talba li ġejja:
{
"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":""
}
Sussegwentement għandek bżonn tgħaqqad il-handler /get_number_info. It-talba trid tiġi eżegwita meta tasal sejħa deħlin fuq il-linja li tkun deħlin qabel ma s-sejħiet jiġu mgħoddija. Jekk tweġiba għal talba ma tasalx fiż-żmien speċifikat, allura s-sejħa tintbagħat skont ir-regoli stabbiliti fid-dominju.
Eżempju ta' handler fuq in-naħa tas-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;
Risposta mill-handler.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Aħna nsegwu l-istatus u niżżlu r-reġistrazzjonijiet tas-sejħiet
Fil-PBX virtwali ta' Rostelecom, ir-reġistrazzjoni tas-sejħa hija attivata fil-kont personali tiegħek. Billi tuża l-API, tista 'ssegwi l-istatus ta' din il-funzjoni. Meta tipproċessa terminazzjoni ta’ sejħa fi call_events tista tara l-bandiera 'huwa_rekord', li jinnotifika lill-utent dwar l-istatus tad-dħul: veru ifisser li l-funzjoni ta 'reġistrazzjoni tas-sejħa tal-utent hija attivata.
Biex tniżżel reġistrazzjoni, trid tuża l-ID tas-sessjoni tas-sejħa sessjoni_id ibgħat talba lil api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Bi tweġiba, inti tirċievi link temporanju biex tniżżel fajl b'reġistrazzjoni tal-konversazzjoni.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Il-ħin tal-ħażna tal-fajl huwa stabbilit fis-settings tal-kont personali tiegħek. Wara l-fajl jitħassar.
Statistika u rappurtar
Fil-kont personali tiegħek fuq paġna separata tista’ tara statistika u rappurtar dwar is-sejħiet kollha u tapplika filtri skont l-istatus u l-ħin. Permezz tal-API, l-ewwel trid tipproċessa s-sejħa bil-metodu /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"
}
Imbagħad sejjaħ il-metodu call_info biex tipproċessa l-firxa u turi s-sejħa fis-sistema CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Bi tweġiba, inti tirċievi firxa ta 'dejta li tista' tiġi pproċessata biex taħżen id-dejta fil-log 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":""
}
}
Karatteristiċi oħra utli tal-PBX virtwali
Minbarra l-API, PBX virtwali għandu bosta karatteristiċi utli oħra li tista 'tuża. Pereżempju, dan huwa menu interattiv tal-vuċi u l-integrazzjoni ta 'komunikazzjonijiet ċellulari u fissi.
Interactive Voice Response (IVR) huwa dak li nisimgħu fuq l-idejn qabel il-persuna twieġeb. Essenzjalment, dan huwa operatur elettroniku li jidderieġi mill-ġdid is-sejħiet lid-dipartimenti xierqa u jwieġeb xi mistoqsijiet awtomatikament. Dalwaqt se jkun possibbli li taħdem mal-IVR permezz tal-API: bħalissa qed niżviluppaw softwer li jippermettilek issegwi l-progress ta 'sejħa permezz tal-IVR u tirċievi informazzjoni dwar touch-tone keystrokes meta l-abbonat ikun fil-menu tal-vuċi.
Biex tittrasferixxi telefonija korporattiva għal telefowns ċellulari, tista' jew tuża applikazzjonijiet tas-softphone jew tattiva separatament is-servizz ta' Konverġenza Mobile Fissi (FMC). Bi kwalunkwe wieħed mill-metodi, sejħiet fi ħdan in-netwerk huma b'xejn, isir possibbli li taħdem b'numri qosra, u sejħiet jistgħu jiġu rreġistrati u statistika ġenerali tista 'tinżamm fuqhom.
Id-differenza hija li l-softphones jeħtieġu l-Internet biex jikkomunikaw, iżda mhumiex marbuta ma 'operatur, filwaqt li FMC huwa marbut ma' operatur speċifiku, iżda jista 'jintuża anke fuq telefowns qodma bi buttuna.
Sors: www.habr.com