Usaha modéren nganggap telepon darat salaku téknologi luntur: komunikasi sélulér mastikeun mobilitas sareng kasadiaan karyawan, jaringan sosial sareng utusan instan mangrupikeun saluran komunikasi anu langkung gampang sareng gancang. Pikeun ngajaga up kalawan pesaing maranéhanana, kantor PBXs jadi beuki loba sarupa aranjeunna: aranjeunna pindah ka awan, dikelola via panganteur web tur terpadu kalayan sistem lianna via API. Dina tulisan ieu kami bakal nyarioskeun ka anjeun naon fungsina Rostelecom virtual PBX API sareng kumaha cara damel sareng fungsi utama PBX virtual ngalangkunganana.
Tugas utama Rostelecom virtual PBX API nyaéta interaksi sareng CRM atanapi situs wéb perusahaan. Contona, API implements "nelepon deui" jeung "nelepon ti loka" widget pikeun sistem manajemen utama: WordPress, Bitrix, OpenCart. API ngamungkinkeun:
- Nampi inpormasi, ngabéjaan status sareng nelepon kana pamundut ti sistem éksternal;
- Kéngingkeun tautan samentawis pikeun ngarékam paguneman;
- Ngatur sareng nampi parameter larangan ti pangguna;
- Kéngingkeun inpormasi ngeunaan pangguna PBX virtual;
- Nyuhunkeun sajarah debit telepon sareng biaya;
- Unggah log telepon.
Kumaha API jalan
API integrasi sareng sistem éksternal saling berinteraksi nganggo pamundut HTTP. Dina akun pribadi, administrator netepkeun alamat dimana pamundut ka API kedah sumping sareng dimana pamundut ti API kedah dikirim. Sistem éksternal kedah gaduh alamat umum anu tiasa diaksés tina Internét nganggo sertipikat SSL anu dipasang.
Ogé dina akun pribadi, administrator domain tiasa ngawates sumber pamundut nalika ngaksés API ku IP.
Kami nampi inpormasi ngeunaan pangguna PBX virtual
Pikeun kéngingkeun daptar pangguna atanapi grup, anjeun kedah ngirim pamundut ka PBX virtual nganggo metodeu /users_info.
{
"domain":"example.ru"
}
Salaku jawaban, anjeun bakal nampi daptar anu anjeun tiasa simpen.
{
"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^_^]
}
]
Metoda ieu ngaliwatan dua arrays. Hiji sareng pangguna domain, hiji sareng grup domain. Grup ogé ngagaduhan kasempetan pikeun netepkeun email anu bakal dikirim dina pamundut.
Ngolah inpormasi ngeunaan telepon asup
Nyambungkeun telepon perusahaan ka sagala rupa sistem CRM ngahemat waktos pikeun pagawé anu berinteraksi sareng klien tur speeds up ngolah telepon asup. Contona, nalika nelepon ti klien ayeuna, CRM bisa muka kartu na, sarta ti CRM anjeun bisa ngirim telepon ka klien tur sambungkeun anjeunna jeung hiji pagawe.
Pikeun kéngingkeun inpormasi ngeunaan sauran API, anjeun kedah nganggo metodeu / meunang_number_info, anu ngahasilkeun daptar telepon sareng inpormasi ngeunaan grup dimana télépon disebarkeun. Anggap nomer PBX virtual narima telepon asup ti nomer 1234567890. Lajeng PBX bakal ngirim pamundut handap:
{
"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":""
}
Satuluyna anjeun perlu nyambungkeun panangan / meunang_number_info. Paménta kedah dieksekusi nalika telepon asup sumping dina saluran asup sateuacan telepon dituju. Upami réspon kana pamenta henteu ditampi dina waktos anu ditangtukeun, maka sauran diteruskeun dumasar kana aturan anu ditetepkeun dina domain.
Conto pawang di sisi 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 ti pawang.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Kami ngalacak status sareng ngaunduh rékaman telepon
Dina PBX virtual Rostelecom, rékaman telepon diaktipkeun dina akun pribadi anjeun. Ngagunakeun API, anjeun tiasa ngalacak status fungsi ieu. Nalika ngolah hiji terminasi panggero dina call_events anjeun tiasa ningali bandéra 'is_record', anu ngabéjaan pangguna ngeunaan status éntri: bener hartina pungsi rekaman panggero pamaké diaktipkeun.
Pikeun ngaunduh rékaman, anjeun kedah nganggo ID sési panggero sési_id ngirim pamundut ka api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Salaku réspon, anjeun bakal nampi tautan samentawis pikeun ngaunduh file sareng ngarékam paguneman.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Waktu neundeun payil disetel dina setelan akun pribadi Anjeun. Saatos éta file bakal dipupus.
Statistik sareng ngalaporkeun
Dina akun pribadi anjeun dina halaman anu misah anjeun tiasa ningali statistik sareng ngalaporkeun sadaya telepon sareng nerapkeun saringan dumasar kana status sareng waktos. Ngaliwatan API, Anjeun mimitina kudu ngolah panggero jeung métode /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"
}
Lajeng nelepon metoda call_info pikeun ngolah Asép Sunandar Sunarya tur mintonkeun panggero dina sistem CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Salaku réspon, anjeun bakal nampi sakumpulan data anu tiasa diolah pikeun nyimpen data dina 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 maya mangpaat séjén
Di sagigireun API, a PBX maya boga sababaraha fitur mangpaat séjén nu bisa Anjeun pake. Salaku conto, ieu mangrupikeun ménu sora interaktif sareng integrasi komunikasi sélulér sareng tetep.
Tanggapan Sora Interaktif (IVR) nyaéta naon anu urang kadéngé dina héndsét sateuacan jalma éta ngajawab. Intina, ieu mangrupikeun operator éléktronik anu alihan telepon ka departemén anu cocog sareng ngajawab sababaraha patarosan sacara otomatis. Moal lami deui tiasa dianggo sareng IVR via API: kami ayeuna nuju ngembangkeun parangkat lunak anu bakal ngamungkinkeun anjeun pikeun ngalacak kamajuan telepon ngalangkungan IVR sareng nampi inpormasi ngeunaan ketukan sentuhan nada nalika palanggan aya dina ménu sora.
Pikeun nransper telepon perusahaan ka telepon sélulér, anjeun tiasa nganggo aplikasi softphone atanapi sacara misah ngaktipkeun ladenan Fixed Mobile Convergence (FMC). Kalayan salah sahiji metodeu, telepon dina jaringan gratis, janten tiasa dianggo sareng nomer pondok, sareng telepon tiasa dirékam sareng statistik umum tiasa disimpen.
Bédana téh yén softphones butuh Internet pikeun komunikasi, tapi maranéhna teu dihijikeun ka operator, bari FMC dihijikeun ka operator husus, tapi bisa dipaké sanajan dina telepon push-tombol heubeul.
sumber: www.habr.com