Biashara ya kisasa hutambua simu za mezani kama teknolojia iliyopitwa na wakati: mawasiliano ya simu huhakikisha uhamaji na upatikanaji wa mara kwa mara wa wafanyakazi, mitandao ya kijamii na wajumbe wa papo hapo ni njia rahisi na ya haraka ya mawasiliano. Ili kuendelea na washindani wao, PBX za ofisi zinazidi kufanana nao: zinahamia kwenye wingu, zinasimamiwa kupitia kiolesura cha wavuti na kuunganishwa na mifumo mingine kupitia API. Katika chapisho hili tutakuambia ni kazi gani Rostelecom virtual PBX API ina na jinsi ya kufanya kazi na kazi kuu za PBX ya kawaida kupitia hiyo.
Kazi kuu ya Rostelecom virtual PBX API ni mwingiliano na CRM au tovuti za kampuni. Kwa mfano, API hutekeleza wijeti za "call back" na "call from site" kwa mifumo kuu ya usimamizi: WordPress, Bitrix, OpenCart. API inaruhusu:
- Pokea habari, arifu hali na upige simu kwa ombi kutoka kwa mfumo wa nje;
- Pata kiungo cha muda cha kurekodi mazungumzo;
- Kusimamia na kupokea vigezo vya kizuizi kutoka kwa watumiaji;
- Pata taarifa kuhusu mtumiaji wa kawaida wa PBX;
- Omba historia ya malipo ya simu na malipo;
- Pakia rekodi ya simu.
Jinsi API inavyofanya kazi
API ya ujumuishaji na mfumo wa nje huingiliana kwa kutumia maombi ya HTTP. Katika akaunti ya kibinafsi, msimamizi huweka anwani ambapo maombi kwa API yanapaswa kufika na ambapo maombi kutoka kwa API yanapaswa kutumwa. Mfumo wa nje lazima uwe na anwani ya umma inayopatikana kutoka kwa Mtandao na cheti cha SSL kilichosakinishwa.
Pia katika akaunti ya kibinafsi, msimamizi wa kikoa anaweza kupunguza vyanzo vya maombi wakati wa kufikia API na IP.
Tunapokea taarifa kuhusu watumiaji pepe wa PBX
Ili kupata orodha ya watumiaji au vikundi, unahitaji kutuma ombi kwa PBX pepe kwa kutumia mbinu /maelezo_ya_watumiaji.
{
"domain":"example.ru"
}
Kwa kujibu, utapokea orodha ambayo unaweza kuokoa.
{
"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^_^]
}
]
Njia hii hupita safu mbili. Moja iliyo na watumiaji wa kikoa, moja na vikundi vya kikoa. Kikundi pia kina fursa ya kutaja barua pepe ambayo itatumwa katika ombi.
Inachakata maelezo kuhusu simu inayoingia
Kuunganisha simu za shirika kwenye mifumo mbalimbali ya mfumo wa kuratibu mawasiliano na wateja (CRM) huokoa muda kwa wafanyakazi wanaowasiliana na wateja na kuongeza kasi ya uchakataji wa simu zinazoingia. Kwa mfano, unapopigiwa simu na mteja wa sasa, CRM inaweza kufungua kadi yake, na kutoka kwa CRM unaweza kutuma simu kwa mteja na kumuunganisha na mfanyakazi.
Ili kupata taarifa kuhusu simu za API, unahitaji kutumia mbinu /pata_nambari_maelezo, ambayo hutengeneza orodha ya simu zenye taarifa kuhusu kikundi ambacho simu hiyo inasambazwa. Hebu tuchukulie kwamba nambari pepe ya PBX inapokea simu inayoingia kutoka kwa nambari 1234567890. Kisha PBX itatuma ombi lifuatalo:
{
"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":""
}
Ifuatayo, unahitaji kuunganisha kidhibiti /pata_nambari_maelezo. Ombi lazima litekelezwe wakati simu inayoingia inapofika kwenye laini inayoingia kabla ya simu kuelekezwa. Ikiwa jibu la ombi halijapokelewa ndani ya muda uliowekwa, basi simu hupitishwa kulingana na sheria zilizowekwa kwenye kikoa.
Mfano wa kidhibiti upande wa 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;
Jibu kutoka kwa mhudumu.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Tunafuatilia hali na kupakua rekodi za simu
Katika PBX pepe ya Rostelecom, kurekodi simu kunawashwa katika akaunti yako ya kibinafsi. Kutumia API, unaweza kufuatilia hali ya kazi hii. Wakati wa kushughulikia kusitisha simu ndani simu_matukio unaweza kuona bendera 'ni_rekodi', ambayo humjulisha mtumiaji kuhusu hali ya ingizo: kweli inamaanisha kuwa kipengele cha kurekodi simu cha mtumiaji kimewashwa.
Ili kupakua rekodi, unahitaji kutumia kitambulisho cha kipindi cha simu kikao_id kutuma ombi kwa api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Kwa kujibu, utapokea kiungo cha muda cha kupakua faili na rekodi ya mazungumzo.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Muda wa kuhifadhi faili umewekwa katika mipangilio ya akaunti yako ya kibinafsi. Baadaye faili itafutwa.
Takwimu na taarifa
Katika akaunti yako ya kibinafsi kwenye ukurasa tofauti unaweza kuona takwimu na kuripoti kwa simu zote na kutumia vichungi kwa hali na wakati. Kupitia API, lazima kwanza uchakata simu na njia /piga_matukio:
{
"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"
}
Kisha piga simu njia piga_maelezo kuchakata safu na kuonyesha simu katika mfumo wa CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Kwa kujibu, utapokea safu ya data ambayo inaweza kuchakatwa ili kuhifadhi data katika kumbukumbu ya 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":""
}
}
Vipengele vingine muhimu vya PBX
Kando na API, PBX pepe ina vipengele vingine kadhaa muhimu ambavyo unaweza kutumia. Kwa mfano, hii ni menyu ya sauti inayoingiliana na ujumuishaji wa mawasiliano ya rununu na ya kudumu.
Mwingiliano wa Majibu ya Sauti (IVR) ndio tunayosikia kwenye simu kabla ya mtu kujibu. Kimsingi, huyu ni mwendeshaji wa kielektroniki anayeelekeza upya simu kwa idara zinazofaa na kujibu baadhi ya maswali kiotomatiki. Hivi karibuni itawezekana kufanya kazi na IVR kupitia API: kwa sasa tunatengeneza programu ambayo itakuruhusu kufuatilia maendeleo ya simu kupitia IVR na kupokea maelezo kuhusu vibonye vya sauti ya mguso wakati mteja yuko kwenye menyu ya sauti.
Ili kuhamisha simu ya shirika hadi simu za rununu, unaweza kutumia programu za simu laini au kuwasha huduma ya Fixed Mobile Convergence (FMC). Kwa njia yoyote, simu ndani ya mtandao ni bure, inawezekana kufanya kazi na nambari fupi, na simu zinaweza kurekodiwa na takwimu za jumla zinaweza kuwekwa kwao.
Tofauti ni kwamba simu za laini zinahitaji mtandao ili kuwasiliana, lakini hazijaunganishwa na operator, wakati FMC imefungwa kwa operator maalum, lakini inaweza kutumika hata kwenye simu za zamani za kifungo.
Chanzo: mapenzi.com