Nútíma fyrirtæki líta á jarðlínasíma sem úrelta tækni: Farsímasamskipti tryggja hreyfanleika og stöðugt aðgengi starfsmanna, samfélagsnet og spjallboð eru auðveldari og hraðari samskiptarás. Til að halda í við keppinauta sína verða skrifstofusímstöðvar sífellt líkari þeim: þær eru að færast yfir í skýið, stjórnað í gegnum vefviðmót og samþættar öðrum kerfum í gegnum API. Í þessari færslu munum við segja þér hvaða aðgerðir Rostelecom raunverulegur PBX API hefur og hvernig á að vinna með helstu aðgerðir sýndar PBX í gegnum það.
Aðalverkefni Rostelecom sýndar PBX API er samskipti við CRM eða vefsíður fyrirtækja. Til dæmis, API útfærir „símtal til baka“ og „símtal frá síðu“ græjur fyrir helstu stjórnunarkerfin: WordPress, Bitrix, OpenCart. API leyfir:
- Taka á móti upplýsingum, tilkynna stöðu og hringja ef óskað er eftir því frá utanaðkomandi kerfi;
- Fáðu tímabundna hlekk til að taka upp samtalið;
- Stjórna og taka á móti takmörkunarbreytum frá notendum;
- Fáðu upplýsingar um sýndar PBX notandann;
- Biðja um sögu símtalsskuldbindinga og gjalda;
- Hladdu upp símtalaskrá.
Hvernig API virkar
Samþættingarforritaskilin og ytra kerfið hafa samskipti sín á milli með því að nota HTTP beiðnir. Á persónulega reikningnum setur stjórnandinn heimilisföngin þar sem beiðnir um API ættu að berast og hvert beiðnir frá API ættu að vera sendar. Ytra kerfið verður að hafa almennt heimilisfang aðgengilegt af internetinu með uppsettu SSL vottorði.
Einnig á persónulega reikningnum getur lénsstjórinn takmarkað uppsprettur beiðna þegar aðgangur er að API með IP.
Við fáum upplýsingar um sýndar PBX notendur
Til að fá lista yfir notendur eða hópa þarftu að senda beiðni til sýndarsímstöðvarinnar með aðferðinni /users_info.
{
"domain":"example.ru"
}
Sem svar færðu lista sem þú getur vistað.
{
"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^_^]
}
]
Þessi aðferð fer framhjá tveimur fylkjum. Einn með lénsnotendum, annar með lénshópum. Hópurinn hefur einnig tækifæri til að tilgreina tölvupóst sem verður sendur í beiðninni.
Vinnur úr upplýsingum um móttekið símtal
Tenging fyrirtækjasíma við ýmis CRM kerfi sparar tíma fyrir starfsmenn sem hafa samskipti við viðskiptavini og flýtir fyrir afgreiðslu símtala. Til dæmis, þegar þú hringir frá núverandi viðskiptavin, getur CRM opnað kortið hans og frá CRM geturðu sent símtal til viðskiptavinarins og tengt hann við starfsmann.
Til að fá upplýsingar um API símtöl þarftu að nota aðferðina /fá_númer_upplýsingar, sem býr til lista yfir símtöl með upplýsingum um hópinn sem símtalinu er dreift til. Gerum ráð fyrir að sýndarsímstöðin taki á móti símtali frá númerinu 1234567890. Þá sendir símasíminn eftirfarandi beiðni:
{
"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":""
}
Næst þarftu að tengja stjórnandann /fá_númer_upplýsingar. Beiðnina verður að framkvæma þegar símtal berst á móttekna línu áður en símtölin eru flutt. Ef svar við beiðni berst ekki innan tiltekins tíma, þá er símtalið beint samkvæmt reglum sem settar eru á léninu.
Dæmi um umsjónarmann á CRM hlið.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Svar frá stjórnanda.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Við fylgjumst með stöðunni og sækjum símtalaupptökur
Í sýndarsímstöð Rostelecom er upptaka símtala virkjuð á persónulega reikningnum þínum. Með því að nota API geturðu fylgst með stöðu þessarar aðgerðar. Við vinnslu lúkningu símtala í hringja_viðburðir þú getur séð fánann 'er_met', sem lætur notanda vita um stöðu færslunnar: satt þýðir að símtalsupptökuaðgerð notandans er virkjuð.
Til að hlaða niður upptöku þarftu að nota auðkenni símtalslotunnar session_id senda beiðni á api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Til að bregðast við færðu tímabundna hlekk til að hlaða niður skrá með upptöku af samtalinu.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Geymslutími skráa er stilltur í persónulegum reikningsstillingum þínum. Síðan verður skránni eytt.
Tölfræði og skýrslugerð
Á persónulegum reikningi þínum á sérstakri síðu geturðu séð tölfræði og skýrslur um öll símtöl og beitt síum eftir stöðu og tíma. Í gegnum API verður þú fyrst að vinna úr símtalinu með aðferðinni /símtalsviðburðir:
{
"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"
}
Hringdu síðan í aðferðina call_info að vinna úr fylkinu og birta símtalið í CRM kerfinu.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Til að bregðast við færðu fjölda gagna sem hægt er að vinna úr til að geyma gögn í CRM-skránni.
{
"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":""
}
}
Aðrir gagnlegir sýndar PBX eiginleikar
Fyrir utan API, sýndar PBX hefur nokkra aðra gagnlega eiginleika sem þú getur notað. Til dæmis er þetta gagnvirk raddvalmynd og samþætting farsíma- og fastra samskipta.
Gagnvirk raddsvörun (IVR) er það sem við heyrum í símtólinu áður en viðkomandi svarar. Í meginatriðum er þetta rafræn símafyrirtæki sem vísar símtölum til viðeigandi deilda og svarar nokkrum spurningum sjálfkrafa. Bráðum verður hægt að vinna með IVR í gegnum API: Núna erum við að þróa hugbúnað sem gerir þér kleift að fylgjast með framvindu símtals í gegnum IVR og fá upplýsingar um snertihnappaáslátt þegar áskrifandinn er í raddvalmyndinni.
Til að flytja fyrirtækjasímakerfi yfir í farsíma geturðu annað hvort notað mjúksímaforrit eða virkjað FMC-þjónustuna (Fixed Mobile Convergence) sérstaklega. Með hvaða aðferð sem er eru símtöl innan netsins ókeypis, hægt verður að vinna með stutt númer og hægt er að taka upp símtöl og halda almennri tölfræði um þau.
Munurinn er sá að snjallsímar þurfa internetið til að hafa samskipti, en þeir eru ekki bundnir við símafyrirtæki, á meðan FMC er bundið við ákveðinn símafyrirtæki, heldur er hægt að nota það jafnvel á gömlum þrýstisímum.
Heimild: www.habr.com