Kaasaegne äri tajub lauatelefone kui vananenud tehnoloogiat: mobiilside tagab töötajate mobiilsuse ja pideva kättesaadavuse, suhtlusvõrgustikud ja kiirsõnumid on lihtsam ja kiirem suhtluskanal. Konkurentidega sammu pidamiseks on kontorikeskjaamad muutumas üha sarnasemaks neile: kolitakse pilve, hallatakse veebiliidese kaudu ja integreeritakse API kaudu teiste süsteemidega. Selles postituses räägime teile, millised funktsioonid on Rostelecomi virtuaalse PBX API-l ja kuidas selle kaudu töötada virtuaalse PBX põhifunktsioonidega.
Rostelecomi virtuaalse PBX API põhiülesanne on suhtlemine CRM-i või ettevõtte veebisaitidega. Näiteks rakendab API peamiste haldussüsteemide jaoks vidinaid “tagasihelista” ja “helista saidilt”: WordPress, Bitrix, OpenCart. API võimaldab:
- Vastu võtta teavet, teavitada olekust ja teha nõudmisel kõnesid välisest süsteemist;
- Hankige vestluse salvestamiseks ajutine link;
- hallata ja saada kasutajatelt piiranguparameetreid;
- Hankige teavet virtuaalse PBX-i kasutaja kohta;
- Küsige kõnede deebetite ja tasude ajalugu;
- Laadi üles kõnelogi.
Kuidas API töötab
Integratsiooni API ja väline süsteem suhtlevad üksteisega HTTP-päringute abil. Isiklikul kontol määrab administraator aadressid, kuhu API päringud peaksid saabuma ja kuhu API päringud saata. Välissüsteemil peab olema installitud SSL-sertifikaadiga Internetist juurdepääsetav avalik aadress.
Ka isiklikul kontol saab domeeni administraator piirata päringute allikaid, kui pääseb API-le IP kaudu.
Saame teavet virtuaalse PBX-i kasutajate kohta
Kasutajate või rühmade loendi saamiseks peate saatma meetodi abil taotluse virtuaalsele PBX-ile /kasutajate_info.
{
"domain":"example.ru"
}
Vastuseks saate nimekirja, mille saate salvestada.
{
"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^_^]
}
]
See meetod läbib kaks massiivi. Üks domeenikasutajatega, teine domeenirühmadega. Samuti on grupil võimalus määrata päringus saadetav e-kiri.
Sissetuleva kõne teabe töötlemine
Ettevõtte telefoniside ühendamine erinevate CRM-süsteemidega säästab klientidega suhtlevate töötajate aega ja kiirendab sissetulevate kõnede töötlemist. Näiteks praeguse kliendi kõne korral saab CRM avada tema kaardi ja CRM-ist saate kliendile kõne saata ja töötajaga ühendada.
API-kõnede kohta teabe saamiseks peate kasutama meetodit /get_number_info, mis loob kõnede loendi teabega grupi kohta, kellele kõne jagatakse. Oletame, et virtuaalne PBX number saab sissetuleva kõne numbrilt 1234567890. Seejärel saadab PBX järgmise päringu:
{
"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":""
}
Järgmisena peate ühendama käitleja /get_number_info. Päring tuleb täita, kui sissetulevale liinile saabub sissetulev kõne enne kõnede suunamist. Kui päringule määratud aja jooksul vastust ei laeku, suunatakse kõne vastavalt domeenis kehtestatud reeglitele.
CRM-i poole töötleja näide.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Vastus käitlejalt.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Jälgime olekut ja laadime alla kõnesalvestised
Rostelecomi virtuaalses PBX-is aktiveeritakse kõne salvestamine teie isiklikul kontol. API abil saate jälgida selle funktsiooni olekut. Kõne lõpetamise töötlemisel sisse call_events näete lippu 'is_rekord', mis teavitab kasutajat kirje olekust: tõsi tähendab, et kasutaja kõnede salvestamise funktsioon on lubatud.
Salvestise allalaadimiseks peate kasutama kõneseansi ID-d SESSION_ID saata päring aadressile api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Vastuseks saate ajutise lingi vestluse salvestusega faili allalaadimiseks.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Failide salvestusaeg määratakse teie isikliku konto seadetes. Pärast seda fail kustutatakse.
Statistika ja aruandlus
Isiklikul kontol eraldi lehel näete kõigi kõnede statistikat ja aruandeid ning saate rakendada oleku ja aja järgi filtreid. API kaudu peate esmalt kõnet töötlema meetodiga /kõne_sündmused:
{
"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"
}
Seejärel helistage meetodile call_info massiivi töötlemiseks ja kõne kuvamiseks CRM-süsteemis.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Vastuseks saate hulga andmeid, mida saab töödelda andmete salvestamiseks CRM-i logisse.
{
"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":""
}
}
Muud kasulikud virtuaalse PBX-i funktsioonid
Lisaks API-le on virtuaalsel PBX-il mitmeid muid kasulikke funktsioone, mida saate kasutada. Näiteks on see interaktiivne häälmenüü ning mobiilse ja fikseeritud side integreerimine.
Interaktiivne häälvastus (IVR) on see, mida kuuleme telefonitorus enne, kui inimene vastab. Sisuliselt on see elektrooniline operaator, kes suunab kõned vastavatesse osakondadesse ja vastab mõnele küsimusele automaatselt. Peagi saab IVR-iga töötada API kaudu: praegu töötame välja tarkvara, mis võimaldab jälgida kõne kulgu läbi IVR-i ja saada infot puutetundlike klahvivajutuste kohta, kui tellija on häälmenüüs.
Ettevõtte telefonikõnede edastamiseks mobiiltelefonidesse saate kasutada tarkvararakendusi või eraldi aktiveerida Fixed Mobile Convergence (FMC) teenuse. Kõigi meetoditega on võrgusisesed kõned tasuta, võimalik on töötada lühinumbritega ning kõnesid saab salvestada ja nende kohta üldist statistikat pidada.
Erinevus seisneb selles, et tarkvaratelefonid vajavad suhtlemiseks Internetti, kuid need ei ole operaatoriga seotud, FMC aga on seotud konkreetse operaatoriga, kuid neid saab kasutada isegi vanadel nupuvajutusega telefonidel.
Allikas: www.habr.com