Bisnis modern nganggep telpon darat minangka teknologi sing wis ketinggalan jaman: komunikasi seluler njamin mobilitas lan kasedhiyan karyawan, jaringan sosial lan utusan cepet minangka saluran komunikasi sing luwih gampang lan luwih cepet. Kanggo ngetutake pesainge, PBX kantor dadi luwih mirip karo dheweke: pindhah menyang awan, dikelola liwat antarmuka web lan terintegrasi karo sistem liyane liwat API. Ing kirim iki kita bakal pitutur marang kowe apa fungsi Rostelecom virtual PBX API wis lan carane bisa karo fungsi utama saka virtual PBX liwat.
Tugas utama Rostelecom virtual PBX API yaiku interaksi karo CRM utawa situs web perusahaan. Contone, API ngetrapake widget "telpon maneh" lan "telpon saka situs" kanggo sistem manajemen utama: WordPress, Bitrix, OpenCart. API ngidini:
- Nampa informasi, kabar status lan nelpon ing panjalukan saka sistem external;
- Entuk link sementara kanggo ngrekam obrolan;
- Ngatur lan nampa paramèter watesan saka pangguna;
- Entuk informasi babagan pangguna PBX virtual;
- Nyuwun riwayat debit lan biaya telpon;
- Upload log telpon.
Carane API bisa
API integrasi lan sistem eksternal sesambungan karo siji liyane nggunakake panjalukan HTTP. Ing akun pribadhi, administrator nyetel alamat ing ngendi panjaluk menyang API kudu teka lan ing ngendi panjaluk saka API kudu dikirim. Sistem eksternal kudu duwe alamat umum sing bisa diakses saka Internet kanthi sertifikat SSL sing diinstal.
Uga ing akun pribadhi, administrator domain bisa matesi sumber panjalukan nalika ngakses API dening IP.
Kita nampa informasi babagan pangguna PBX virtual
Kanggo entuk dhaptar pangguna utawa grup, sampeyan kudu ngirim panjaluk menyang PBX virtual nggunakake metode kasebut /users_info.
{
"domain":"example.ru"
}
Nanggepi, sampeyan bakal nampa dhaptar sing bisa disimpen.
{
"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^_^]
}
]
Cara iki ngliwati rong larik. Siji karo pangguna domain, siji karo grup domain. Klompok uga duwe kesempatan kanggo nemtokake email sing bakal dikirim ing panyuwunan.
Ngolah informasi babagan telpon mlebu
Nyambungake telpon perusahaan menyang macem-macem sistem CRM ngirit wektu kanggo karyawan sing sesambungan karo klien lan nyepetake pangolahan telpon mlebu. Contone, nalika telpon saka klien saiki, CRM bisa mbukak kertu, lan saka CRM sampeyan bisa ngirim telpon menyang klien lan nyambungake karo karyawan.
Kanggo entuk informasi babagan panggilan API, sampeyan kudu nggunakake metode kasebut / njaluk_nomer_info, sing nggawe dhaptar telpon kanthi informasi babagan grup sing disebarake telpon. Ayo nganggep yen nomer PBX virtual nampa telpon mlebu saka nomer 1234567890. Banjur PBX bakal ngirim panjalukan ing ngisor iki:
{
"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":""
}
Sabanjure sampeyan kudu nyambungake handler / njaluk_nomer_info. Panjaluk kasebut kudu dileksanakake nalika ana telpon mlebu ing baris mlebu sadurunge telpon diarahake. Yen respon kanggo panjalukan ora ditampa ing wektu sing ditemtokake, banjur telpon diterusake miturut aturan sing ditetepake ing domain kasebut.
Conto pawang ing sisih 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;
Tanggapan saka pawang.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Kita nglacak status lan ngundhuh rekaman telpon
Ing PBX virtual Rostelecom, rekaman telpon diaktifake ing akun pribadhi. Nggunakake API, sampeyan bisa nglacak status fungsi iki. Nalika ngolah mandap telpon ing telpon_acara sampeyan bisa ndeleng gendera 'is_record', sing menehi kabar marang pangguna babagan status entri: bener tegese fungsi rekaman telpon pangguna diaktifake.
Kanggo ngundhuh rekaman, sampeyan kudu nggunakake ID sesi telpon session_id ngirim panjalukan kanggo api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Nanggepi, sampeyan bakal nampa link sauntara kanggo ngundhuh file karo rekaman obrolan.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Wektu panyimpenan file disetel ing setelan akun pribadhi. Sawisé iku file bakal dibusak.
Statistik lan laporan
Ing akun pribadhi ing kaca sing kapisah sampeyan bisa ndeleng statistik lan nglaporake kabeh telpon lan aplikasi saringan miturut status lan wektu. Liwat API, sampeyan kudu ngolah telpon kanthi cara kasebut /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"
}
Banjur nelpon cara telpon_info kanggo ngolah array lan nampilake telpon ing sistem CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Nanggepi, sampeyan bakal nampa Uploaded data sing bisa diproses kanggo nyimpen data ing 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":""
}
}
Fitur PBX virtual liyane sing migunani
Saliyane API, PBX virtual duwe sawetara fitur migunani liyane sing bisa digunakake. Contone, iki minangka menu swara interaktif lan integrasi komunikasi seluler lan tetep.
Interactive Voice Response (IVR) yaiku apa sing kita krungu ing handset sadurunge wong kasebut mangsuli. Intine, iki minangka operator elektronik sing ngarahake telpon menyang departemen sing cocog lan mangsuli sawetara pitakon kanthi otomatis. Ora suwe bakal bisa nggarap IVR liwat API: saiki kita lagi ngembangake piranti lunak sing ngidini sampeyan nglacak kemajuan telpon liwat IVR lan nampa informasi babagan ketukan tombol nada tutul nalika pelanggan ana ing menu swara.
Kanggo nransfer telpon perusahaan menyang ponsel, sampeyan bisa nggunakake aplikasi softphone utawa ngaktifake layanan Fixed Mobile Convergence (FMC). Kanthi cara apa wae, telpon ing jaringan gratis, dadi bisa digunakake kanthi nomer cendhak, lan telpon bisa direkam lan statistik umum bisa disimpen.
Bentenipun iku softphones kudu Internet kanggo komunikasi, nanging padha ora disambungake menyang operator, nalika FMC disambungake menyang operator tartamtu, nanging bisa digunakake malah ing telpon push-tombol lawas.
Source: www.habr.com