Nykyaikainen yritys näkee lankapuhelimet vanhentuneena teknologiana: matkapuhelinviestintä varmistaa työntekijöiden liikkuvuuden ja jatkuvan käytettävyyden, sosiaaliset verkostot ja pikaviestit ovat helpompi ja nopeampi viestintäkanava. Pysyäkseen kilpailijoidensa tahdissa toimistovaihteet muistuttavat yhä enemmän niitä: ne siirtyvät pilveen, niitä hallitaan verkkoliittymän kautta ja integroidaan muihin järjestelmiin API:n kautta. Tässä viestissä kerromme sinulle, mitä toimintoja Rostelecomin virtuaalisen PBX-sovellusliittymällä on ja kuinka työskennellä virtuaalisen PBX:n päätoimintojen kanssa sen kautta.
Rostelecomin virtuaalisen PBX API:n päätehtävä on vuorovaikutus CRM:n tai yrityksen verkkosivujen kanssa. Esimerkiksi API toteuttaa "soita takaisin" ja "soita sivustolta" -widgetit tärkeimpiin hallintajärjestelmiin: WordPress, Bitrix, OpenCart. API mahdollistaa:
- Vastaanottaa tietoja, ilmoittaa tilasta ja soittaa puheluita pyynnöstä ulkoisesta järjestelmästä;
- Hanki väliaikainen linkki keskustelun tallentamiseksi;
- Hallitse ja vastaanota rajoitusparametreja käyttäjiltä;
- Hanki tietoja virtuaalisesta PBX-käyttäjästä;
- Pyydä puhelujen veloitus- ja maksuhistoria;
- Lataa puheluloki.
Kuinka API toimii
Integrointisovellusliittymä ja ulkoinen järjestelmä ovat vuorovaikutuksessa keskenään HTTP-pyyntöjen avulla. Henkilökohtaisella tilillä järjestelmänvalvoja asettaa osoitteet, joihin API-pyyntöjen tulee saapua ja mihin API-pyynnöt lähetetään. Ulkoisessa järjestelmässä on oltava julkinen osoite, joka on käytettävissä Internetistä asennetun SSL-varmenteen kanssa.
Myös henkilökohtaisella tilillä verkkotunnuksen järjestelmänvalvoja voi rajoittaa pyyntöjen lähteitä käyttäessään API:a IP:n kautta.
Saamme tietoa virtuaalisista PBX-käyttäjistä
Saadaksesi luettelon käyttäjistä tai ryhmistä, sinun on lähetettävä pyyntö virtuaaliseen PBX:ään menetelmällä /users_info.
{
"domain":"example.ru"
}
Vastauksena saat luettelon, jonka voit tallentaa.
{
"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^_^]
}
]
Tämä menetelmä läpäisee kaksi taulukkoa. Yksi verkkotunnuksen käyttäjien kanssa, toinen verkkotunnusryhmien kanssa. Ryhmällä on myös mahdollisuus määrittää sähköposti, joka lähetetään pyynnössä.
Käsitellään saapuvan puhelun tietoja
Yrityspuheluiden yhdistäminen erilaisiin CRM-järjestelmiin säästää asiakkaiden kanssa vuorovaikutuksessa olevien työntekijöiden aikaa ja nopeuttaa saapuvien puhelujen käsittelyä. Esimerkiksi nykyiseltä asiakkaalta soitettaessa CRM voi avata hänen korttinsa, ja CRM:stä voit lähettää puhelun asiakkaalle ja yhdistää hänet työntekijään.
Jotta saat tietoja API-kutsuista, sinun on käytettävä menetelmää /get_number_info, joka luo luettelon puheluista, joka sisältää tiedot ryhmästä, jolle puhelu on jaettu. Oletetaan, että virtuaalinen PBX-numero vastaanottaa saapuvan puhelun numerosta 1234567890. Sitten PBX lähettää seuraavan pyynnön:
{
"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":""
}
Seuraavaksi sinun on kytkettävä käsittelijä /get_number_info. Pyyntö on suoritettava saapuvan puhelun saapuessa saapuvalle linjalle ennen kuin puhelut reititetään. Jos vastausta pyyntöön ei saada määrätyn ajan kuluessa, puhelu reititetään toimialueen sääntöjen mukaisesti.
Esimerkki CRM-puolen käsittelijästä.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Vastaus ohjaajalta.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Seuraamme tilaa ja lataamme puhelutallenteita
Rostelecomin virtuaalisessa PBX:ssä puheluiden tallennus aktivoidaan henkilökohtaisella tililläsi. API:n avulla voit seurata tämän toiminnon tilaa. Kun käsitellään puhelun katkaisua sisään call_events voit nähdä lipun 'is_record', joka ilmoittaa käyttäjälle merkinnän tilasta: totta tarkoittaa, että käyttäjän puhelun tallennustoiminto on käytössä.
Tallenteen lataamiseksi sinun on käytettävä puheluistunnon tunnusta istunnon tunniste lähetä pyyntö osoitteeseen api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Vastauksena saat väliaikaisen linkin keskustelun tallenteen sisältävän tiedoston lataamiseen.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Tiedostojen tallennusaika asetetaan henkilökohtaisen tilisi asetuksissa. Tämän jälkeen tiedosto poistetaan.
Tilastot ja raportointi
Henkilökohtaisella tililläsi erillisellä sivulla voit nähdä tilastot ja raportit kaikista puheluista ja käyttää suodattimia tilan ja ajan mukaan. API:n kautta sinun on ensin käsiteltävä puhelu menetelmällä /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"
}
Kutsu sitten menetelmä call_info taulukon käsittelemiseksi ja puhelun näyttämiseksi CRM-järjestelmässä.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Vastauksena saat joukon tietoja, joita voidaan käsitellä tietojen tallentamiseksi CRM-lokiin.
{
"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":""
}
}
Muita hyödyllisiä virtuaalisia PBX-ominaisuuksia
API:n lisäksi virtuaalisessa PBX:ssä on useita muita hyödyllisiä ominaisuuksia, joita voit käyttää. Tämä on esimerkiksi interaktiivinen äänivalikko ja matkapuhelinverkon ja kiinteän viestinnän integrointi.
Interactive Voice Response (IVR) on se, mitä kuulemme luurissa ennen kuin henkilö vastaa. Pohjimmiltaan tämä on sähköinen operaattori, joka ohjaa puhelut asianmukaisille osastoille ja vastaa joihinkin kysymyksiin automaattisesti. Pian on mahdollista työskennellä IVR:n kanssa API:n kautta: kehittelemme parhaillaan ohjelmistoa, jonka avulla voit seurata puhelun etenemistä IVR:n kautta ja saada tietoa ääninäppäimien painalluksista, kun tilaaja on äänivalikossa.
Yrityspuheluiden siirtämiseksi matkapuhelimiin voit joko käyttää softphone-sovelluksia tai aktivoida erikseen Fixed Mobile Convergence (FMC) -palvelun. Millä tahansa menetelmällä puhelut verkossa ovat ilmaisia, on mahdollista työskennellä lyhytnumeroiden kanssa ja puhelut voidaan tallentaa ja niistä voidaan pitää yleisiä tilastoja.
Erona on se, että softphonet tarvitsevat Internetiä kommunikoidakseen, mutta niitä ei ole sidottu operaattoriin, kun taas FMC on sidottu tiettyyn operaattoriin, mutta niitä voidaan käyttää jopa vanhoissa painikepuhelimissa.
Lähde: will.com