A modern üzleti élet a vezetékes telefonokat elavult technológiának tekinti: a mobilkommunikáció biztosítja a mobilitást és az alkalmazottak állandó elérhetőségét, a közösségi hálózatok és az azonnali üzenetküldők pedig könnyebb és gyorsabb kommunikációs csatornát jelentenek. Az irodai alközpontok, hogy lépést tartsanak versenytársaikkal, egyre jobban hasonlítanak rájuk: a felhőbe költöznek, webes felületen kezelik őket, és API-n keresztül integrálódnak más rendszerekkel. Ebben a bejegyzésben elmondjuk, hogy milyen funkciókkal rendelkezik a Rostelecom virtuális alközpont API, és hogyan lehet rajta keresztül dolgozni a virtuális alközpont fő funkcióival.
A Rostelecom virtuális PBX API fő feladata a CRM-mel vagy a vállalati webhelyekkel való interakció. Például az API „visszahívás” és „helyről hívás” widgeteket valósít meg a fő menedzsmentrendszerekhez: WordPress, Bitrix, OpenCart. Az API lehetővé teszi:
- Információk fogadása, állapotértesítés és kérésre hívásokat kezdeményezhet külső rendszerből;
- Szerezzen be egy ideiglenes hivatkozást a beszélgetés rögzítéséhez;
- Korlátozási paraméterek kezelése és fogadása a felhasználóktól;
- Információk beszerzése a virtuális alközpont felhasználóról;
- Kérje le a terhelések és díjak előzményeit;
- Hívásnapló feltöltése.
Hogyan működik az API
Az integrációs API és a külső rendszer HTTP-kérésekkel kommunikál egymással. A személyes fiókban az adminisztrátor beállítja azokat a címeket, ahová az API-kéréseknek meg kell érkezniük, és ahová az API-tól érkező kéréseket el kell küldeni. A külső rendszernek rendelkeznie kell az internetről elérhető nyilvános címmel, telepített SSL tanúsítvánnyal.
A személyes fiókban is a domain rendszergazdája korlátozhatja a kérések forrását, amikor IP-n keresztül éri el az API-t.
Információkat kapunk a virtuális alközponti felhasználókról
A felhasználók vagy csoportok listájának megtekintéséhez kérést kell küldenie a virtuális alközpontnak a metódus használatával /users_info.
{
"domain":"example.ru"
}
Válaszul kap egy listát, amelyet elmenthet.
{
"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^_^]
}
]
Ez a módszer két tömböt ad át. Egy tartományfelhasználókkal, egy tartománycsoportokkal. A csoportnak lehetősége van megadni egy e-mailt is, amelyet a kérésben elküldenek.
Bejövő hívás információinak feldolgozása
A vállalati telefonálás különböző CRM-rendszerekhez való csatlakoztatása időt takarít meg az ügyfelekkel interakcióba lépő alkalmazottak számára, és felgyorsítja a bejövő hívások feldolgozását. Például egy aktuális ügyfél hívása esetén a CRM megnyithatja a kártyáját, a CRM-ből pedig hívást küldhet az ügyfélnek, és összekapcsolhatja őt egy alkalmazottal.
Az API-hívásokkal kapcsolatos információk megszerzéséhez a módszert kell használnia /get_number_info, amely létrehoz egy híváslistát, amely tartalmazza a hívást elosztó csoportra vonatkozó információkat. Tegyük fel, hogy a virtuális alközponti szám a 1234567890-es számról fogad bejövő hívást. Ekkor az alközpont a következő kérést küldi:
{
"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":""
}
Ezután csatlakoztatnia kell a kezelőt /get_number_info. A kérést akkor kell végrehajtani, amikor bejövő hívás érkezik a bejövő vonalra, mielőtt a hívások átirányításra kerülnek. Ha egy kérésre nem érkezik válasz a megadott időn belül, akkor a hívás a tartományban meghatározott szabályok szerint kerül továbbításra.
Példa egy kezelőre a CRM oldalon.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Válasz a kezelőtől.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Nyomon követjük az állapotot és letöltjük a hívásfelvételeket
A Rostelecom virtuális alközpontjában a hívásrögzítés aktiválva van az Ön személyes fiókjában. Az API segítségével nyomon követheti ennek a funkciónak az állapotát. Hívásvégződtetés feldolgozása során call_events láthatod a zászlót 'is_record', amely értesíti a felhasználót a bejegyzés állapotáról: igaz azt jelenti, hogy a felhasználó hívásrögzítési funkciója engedélyezve van.
A felvétel letöltéséhez a hívásmenet azonosítóját kell használnia munkamenet azonosító címre küldjön kérést api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Válaszul kap egy ideiglenes hivatkozást, amellyel letöltheti a beszélgetést rögzítő fájlt.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
A fájl tárolási ideje a személyes fiókbeállításokban van beállítva. Ezt követően a fájl törlődik.
Statisztika és jelentés
Személyes fiókjában egy külön oldalon tekintheti meg az összes hívás statisztikáját és jelentését, valamint állapot és idő szerinti szűrőket alkalmazhat. Az API-n keresztül először fel kell dolgoznia a hívást a metódussal /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"
}
Ezután hívja a módszert call_info a tömb feldolgozásához és a hívás megjelenítéséhez a CRM rendszerben.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Válaszul egy sor adatot kap, amelyet feldolgozva tárolhat adatokat a CRM-naplóban.
{
"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":""
}
}
Egyéb hasznos virtuális alközponti funkciók
Az API-n kívül a virtuális alközpont számos más hasznos funkcióval is rendelkezik, amelyeket használhat. Ez például egy interaktív hangmenü, valamint a mobil és vezetékes kommunikáció integrációja.
Az interaktív hangreakció (IVR) az, amit a kézibeszélőn hallunk, mielőtt a személy válaszolna. Lényegében ez egy elektronikus kezelő, aki átirányítja a hívásokat a megfelelő osztályokra, és automatikusan válaszol bizonyos kérdésekre. Hamarosan az API-n keresztül is lehet majd dolgozni az IVR-rel: jelenleg olyan szoftvert fejlesztünk, amellyel nyomon követheti a hívás előrehaladását az IVR-en keresztül, és információt kaphat a hangos billentyűleütésekről, amikor az előfizető a hangmenüben van.
A vállalati telefonálás mobiltelefonra történő átviteléhez használhat softphone alkalmazásokat, vagy külön aktiválhatja a Fixed Mobile Convergence (FMC) szolgáltatást. Bármelyik módszerrel a hálózaton belüli hívások ingyenesek, lehetővé válik a rövid számokkal való munkavégzés, a hívások rögzíthetők és általános statisztika vezethető róluk.
A különbség annyi, hogy a softphone-oknak internet kell a kommunikációhoz, de nincsenek operátorhoz kötve, míg az FMC egy adott kezelőhöz, de akár a régi nyomógombos telefonokon is használható.
Forrás: will.com