Mabizinesi amakono amawona mafoni apamtunda ngati ukadaulo wachikale: kulumikizana ndi ma cell kumatsimikizira kuyenda ndi kupezeka kosalekeza kwa ogwira ntchito, malo ochezera a pa Intaneti ndi ma messenger apompopompo ndi njira yosavuta komanso yachangu yolumikizirana. Kuti agwirizane ndi mpikisano wawo, maofesi a PBX akukhala ofanana kwambiri ndi iwo: akusunthira kumtambo, akuyendetsedwa kudzera pa intaneti ndikuphatikizidwa ndi machitidwe ena kudzera pa API. Mu positi iyi tikuuzani ntchito zomwe Rostelecom pafupifupi PBX API ili nazo komanso momwe mungagwirire ntchito ndi ntchito zazikulu za PBX kudzera pamenepo.
Ntchito yayikulu ya Rostelecom virtual PBX API ndikulumikizana ndi CRM kapena masamba amakampani. Mwachitsanzo, API imagwiritsa ntchito "call back" ndi "call from site" widgets for main management systems: WordPress, Bitrix, OpenCart. API imalola kuti:
- Landirani zambiri, dziwitsani udindo ndikuyimba foni mukafunsidwa kuchokera kudongosolo lakunja;
- Pezani ulalo kwakanthawi kuti mulembe zokambirana;
- Kuwongolera ndi kulandira zoletsa kuchokera kwa ogwiritsa ntchito;
- Pezani zambiri za wosuta wa PBX;
- Pemphani mbiri ya ma debit oyitanitsa ndi zolipiritsa;
- Kwezani chipika choyimbira.
Momwe API imagwirira ntchito
API yophatikizira ndi machitidwe akunja amalumikizana wina ndi mnzake pogwiritsa ntchito zopempha za HTTP. Mu akaunti yaumwini, woyang'anira amaika maadiresi kumene zopempha ku API ziyenera kufika ndi kumene zopempha kuchokera ku API ziyenera kutumizidwa. Dongosolo lakunja liyenera kukhala ndi adilesi yapagulu yopezeka pa intaneti yokhala ndi satifiketi ya SSL yoyikidwa.
Komanso mu akaunti yanu, woyang'anira dera akhoza kuchepetsa magwero a zopempha pamene akupeza API ndi IP.
Timalandila zambiri za ogwiritsa ntchito a PBX
Kuti mupeze mndandanda wa ogwiritsa ntchito kapena magulu, muyenera kutumiza pempho ku PBX yeniyeni pogwiritsa ntchito njirayi /users_info.
{
"domain":"example.ru"
}
Poyankha, mudzalandira mndandanda womwe mungasunge.
{
"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^_^]
}
]
Njira iyi imadutsa mitundu iwiri. Imodzi yokhala ndi ogwiritsa ntchito madambwe, ina yokhala ndi magulu amtundu. Gululi limakhalanso ndi mwayi wofotokozera imelo yomwe idzatumizidwa mu pempho.
Kukonza zambiri za foni yomwe ikubwera
Kulumikiza telefoni yamakampani kumachitidwe osiyanasiyana a CRM kumapulumutsa nthawi kwa ogwira ntchito omwe amalumikizana ndi makasitomala ndikufulumizitsa kuyitanitsa mafoni omwe akubwera. Mwachitsanzo, pa foni kuchokera kwa kasitomala wamakono, CRM ikhoza kutsegula khadi lake, ndipo kuchokera ku CRM mukhoza kutumiza foni kwa kasitomala ndikumugwirizanitsa ndi wogwira ntchito.
Kuti mudziwe zambiri za mafoni a API, muyenera kugwiritsa ntchito njirayo /peza_nambala_zonse, yomwe imapanga mndandanda wa mafoni omwe ali ndi chidziwitso cha gulu lomwe kuyimbirako kumagawidwa. Tiyerekeze kuti nambala ya PBX yeniyeni ilandila foni yobwera kuchokera ku nambala 1234567890. Kenako PBX itumiza zopempha zotsatirazi:
{
"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":""
}
Kenako muyenera kulumikiza chogwirizira /peza_nambala_zonse. Pempho liyenera kuchitidwa pamene foni yomwe ikubwera ikufika pamzere wolowera mafoni asanayambe kuyendetsedwa. Ngati yankho la pempho silinalandiridwe mkati mwa nthawi yotchulidwa, ndiye kuti kuyitana kumayendetsedwa molingana ndi malamulo omwe akhazikitsidwa mu domain.
Chitsanzo cha wothandizira kumbali ya 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;
Yankho lochokera kwa wothandizira.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Timatsata zomwe zikuchitika ndikutsitsa zojambulidwa
Mu Rostelecom's virtual PBX, kujambula kuyimba kumatsegulidwa mu akaunti yanu. Pogwiritsa ntchito API, mutha kutsata momwe ntchitoyi ikuyendera. Mukakonza kuyimitsa foni mu kuyitana_zochitika mukhoza kuwona mbendera 'ndi_mbiri', zomwe zimadziwitsa wogwiritsa ntchito za momwe malowo alili: koona zikutanthauza kuti wosuta kuyitana kujambula ntchito ndikoyambitsidwa.
Kuti mutsitse kujambula, muyenera kugwiritsa ntchito ID yagawo loyimba foni gawo_dongosolo tumizani pempho kwa api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Poyankha, mudzalandira ulalo wosakhalitsa kuti mutsitse fayilo yokhala ndi chojambulira cha zokambiranazo.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Nthawi yosungira mafayilo imayikidwa muzikhazikiko za akaunti yanu. Pambuyo pake, fayilo idzachotsedwa.
Ziwerengero ndi malipoti
Muakaunti yanu patsamba lina mutha kuwona ziwerengero ndi malipoti pama foni onse ndikuyika zosefera malinga ndi nthawi ndi nthawi. Kupyolera mu API, choyamba muyenera kukonza kuyitana ndi njira /kuitana_zochitika:
{
"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"
}
Kenako imbani njira kuitana_zidziwitso kukonza mndandanda ndikuwonetsa kuyimba mu CRM system.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Poyankha, mudzalandira zambiri zomwe zingasinthidwe kuti zisungidwe mu chipika cha 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":""
}
}
Zina zothandiza zenizeni za PBX
Kupatula API, PBX yeniyeni ili ndi zinthu zina zingapo zothandiza zomwe mungagwiritse ntchito. Mwachitsanzo, iyi ndi menyu yolumikizirana mawu komanso kuphatikiza kwa ma cellular ndi okhazikika.
Interactive Voice Response (IVR) ndi zomwe timamva pamanja munthu asanayankhe. Kwenikweni, uyu ndi wogwiritsa ntchito pakompyuta yemwe amatumiza mafoni kumadipatimenti oyenera ndikuyankha mafunso ena okha. Posachedwapa zidzakhala zotheka kugwira ntchito ndi IVR kudzera pa API: panopa tikupanga mapulogalamu omwe angakuthandizeni kuti muzitha kuyang'anira momwe foni ikuyendera kudzera mu IVR ndikulandira zambiri zokhudza makiyi okhudza-toni pamene wolembetsa ali mu menyu ya mawu.
Kusamutsa telefoni yamakampani kupita ku mafoni am'manja, mutha kugwiritsa ntchito mafoni a m'manja kapena kuyatsa ntchito ya Fixed Mobile Convergence (FMC). Ndi njira iliyonse, mafoni mkati mwa intaneti ndi aulere, zimakhala zotheka kugwira ntchito ndi manambala afupiafupi, ndipo mafoni amatha kulembedwa ndipo ziwerengero zonse zikhoza kusungidwa pa iwo.
Kusiyanitsa ndiko kuti mafoni a m'manja amafunikira intaneti kuti alankhule, koma samamangirizidwa kwa wogwiritsa ntchito, pamene FMC imamangirizidwa ndi wogwiritsa ntchito, koma ingagwiritsidwe ntchito ngakhale pa mafoni akale okankhira.
Source: www.habr.com