Biznis modèn pèsevwa telefòn fiks yo kòm yon teknoloji demode: kominikasyon selilè asire mobilite ak disponiblite konstan nan anplwaye yo, rezo sosyal ak mesaje enstantane yo se yon kanal kominikasyon pi fasil ak pi vit. Pou kenbe ak konpetitè yo, PBX biwo yo ap vin pi plis ak plis sanble ak yo: yo ap deplase nan nwaj la, jere atravè yon koòdone entènèt ak entegre ak lòt sistèm atravè API. Nan pòs sa a nou pral di w ki fonksyon API PBX vityèl Rostelecom genyen ak kijan pou travay ak fonksyon prensipal PBX vityèl atravè li.
Travay prensipal Rostelecom Virtual PBX API se entèraksyon ak CRM oswa sit entènèt konpayi yo. Pou egzanp, API a aplike widgets "rele tounen" ak "rele soti nan sit" pou sistèm jesyon prensipal yo: WordPress, Bitrix, OpenCart. API a pèmèt:
- Resevwa enfòmasyon, notifye estati ak fè apèl sou demann nan yon sistèm ekstèn;
- Jwenn yon lyen tanporè pou anrejistre konvèsasyon an;
- Jere ak resevwa paramèt restriksyon nan men itilizatè yo;
- Jwenn enfòmasyon sou itilizatè PBX vityèl la;
- Mande istwa debi apèl ak chaj yo;
- Voye dosye apèl la.
Ki jan API a ap travay
API entegrasyon an ak sistèm ekstèn la kominike youn ak lòt lè l sèvi avèk demann HTTP. Nan kont pèsonèl la, administratè a fikse adrès kote demann API a ta dwe rive ak kote demann API a ta dwe voye. Sistèm ekstèn lan dwe gen yon adrès piblik aksesib sou Entènèt ak yon sètifika SSL enstale.
Epitou nan kont pèsonèl la, administratè domèn nan ka limite sous demann yo lè w ap jwenn aksè nan API a pa IP.
Nou resevwa enfòmasyon sou itilizatè PBX vityèl yo
Pou jwenn yon lis itilizatè oswa gwoup, ou bezwen voye yon demann nan PBX vityèl la lè l sèvi avèk metòd la /enfo_utilisateur.
{
"domain":"example.ru"
}
Kòm repons, ou pral resevwa yon lis ke ou ka sove.
{
"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^_^]
}
]
Metòd sa a pase de etalaj. Youn ak itilizatè domèn, youn ak gwoup domèn. Gwoup la tou gen opòtinite pou presize yon imèl ke yo pral voye nan demann lan.
Pwosesis enfòmasyon sou yon apèl fèk ap rantre
Konekte telefòn antrepriz ak divès sistèm CRM ekonomize tan pou anplwaye ki kominike avèk kliyan epi akselere pwosesis apèl k ap fèk ap rantre yo. Pou egzanp, lè yon apèl soti nan yon kliyan aktyèl, CRM ka louvri kat li a, ak nan CRM ou ka voye yon apèl nan kliyan an epi konekte li ak yon anplwaye.
Pou jwenn enfòmasyon sou apèl API, ou bezwen sèvi ak metòd la /get_number_info, ki jenere yon lis apèl ak enfòmasyon sou gwoup kote apèl la distribye. Ann sipoze nimewo PBX vityèl la resevwa yon apèl k ap rantre nan nimewo 1234567890. Lè sa a, PBX a ap voye demann sa a:
{
"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":""
}
Apre sa ou bezwen konekte moun kap okipe a /get_number_info. Rekèt la dwe egzekite lè yon apèl fèk ap rantre rive sou liy kap vini an anvan yo voye apèl yo. Si yo pa resevwa yon repons a yon demann nan tan espesifye a, Lè sa a, apèl la ap dirije dapre règleman yo etabli nan domèn nan.
Egzanp yon moun kap okipe bò 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;
Repons nan men moun kap okipe a.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Nou swiv estati a epi telechaje anrejistreman apèl yo
Nan PBX vityèl Rostelecom a, anrejistreman apèl aktive nan kont pèsonèl ou. Sèvi ak API a, ou ka swiv estati fonksyon sa a. Lè w ap trete yon revokasyon apèl nan call_events ou ka wè drapo a 'se_rekò', ki notifye itilizatè a sou sitiyasyon an nan antre a: vrè vle di ke fonksyon anrejistreman apèl itilizatè a pèmèt.
Pou telechaje yon anrejistreman, ou bezwen sèvi ak ID sesyon apèl la sesyon_id voye yon demann bay api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Kòm repons, w ap resevwa yon lyen tanporè pou telechaje yon dosye ki gen yon anrejistreman konvèsasyon an.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Tan nan depo dosye a mete nan paramèt kont pèsonèl ou. Apre sa, yo pral efase dosye a.
Estatistik ak rapò
Nan kont pèsonèl ou sou yon paj apa ou ka wè estatistik ak rapò sou tout apèl yo epi aplike filtè pa estati ak lè. Atravè API a, ou dwe premye trete apèl la ak metòd la /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"
}
Lè sa a, rele metòd la call_info pou trete etalaj la epi montre apèl la nan sistèm CRM la.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Kòm repons, w ap resevwa yon seri done ki ka trete pou estoke done nan jounal CRM a.
{
"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":""
}
}
Lòt itil karakteristik PBX vityèl
Anplis API a, yon PBX vityèl gen plizyè lòt karakteristik itil ke ou ka itilize. Pou egzanp, sa a se yon meni vwa entèaktif ak entegrasyon an nan kominikasyon selilè ak fiks.
Interactive Voice Response (IVR) se sa nou tande sou appareil la anvan moun nan reponn. Esansyèlman, sa a se yon operatè elektwonik ki redireksyon apèl nan depatman ki apwopriye yo epi reponn kèk kesyon otomatikman. Byento li pral posib pou travay ak IVR atravè API a: kounye a nou ap devlope lojisyèl ki pral pèmèt ou swiv pwogrè nan yon apèl nan IVR a epi resevwa enfòmasyon sou touche-ton touche lè abònen a nan meni vwa a.
Pou transfere telefòn antrepriz nan telefòn mobil, ou ka swa itilize aplikasyon softphone oswa separeman aktive sèvis Fixed Mobile Convergence (FMC). Avèk nenpòt nan metòd yo, apèl nan rezo a gratis, li vin posib pou travay ak nimewo kout, epi yo ka anrejistre apèl yo epi yo ka kenbe estatistik jeneral sou yo.
Diferans lan se ke softphones bezwen entènèt la pou kominike, men yo pa mare nan yon operatè, pandan y ap FMC mare nan yon operatè espesifik, men yo ka itilize menm sou ansyen telefòn pouse bouton.
Sous: www.habr.com