Moderne sakeondernemings beskou landlynfone as 'n verouderde tegnologie: sellulêre kommunikasie verseker mobiliteit en konstante beskikbaarheid van werknemers, sosiale netwerke en kitsboodskappers is 'n makliker en vinniger kommunikasiekanaal. Om tred te hou met hul mededingers, word kantoor-PBX'e meer en meer soortgelyk aan hulle: hulle skuif na die wolk, bestuur via 'n webkoppelvlak en geïntegreer met ander stelsels via API. In hierdie pos sal ons jou vertel watter funksies die Rostelecom virtuele PBX API het en hoe om met die hooffunksies van die virtuele PBX daardeur te werk.
Die hooftaak van die Rostelecom virtuele PBX API is interaksie met CRM of maatskappywebwerwe. Byvoorbeeld, die API implementeer "bel terug" en "oproep vanaf werf" widgets vir die hoofbestuurstelsels: WordPress, Bitrix, OpenCart. Die API laat toe:
- Ontvang inligting, stel status in kennis en maak oproepe op versoek van 'n eksterne stelsel;
- Kry 'n tydelike skakel om die gesprek op te neem;
- Bestuur en ontvang beperkingsparameters van gebruikers;
- Kry inligting oor die virtuele PBX-gebruiker;
- Versoek die geskiedenis van oproepdebiete en heffings;
- Laai oproeplogboek op.
Hoe die API werk
Die integrasie-API en die eksterne stelsel werk met mekaar deur HTTP-versoeke te gebruik. In die persoonlike rekening stel die administrateur die adresse waar versoeke na die API moet kom en waar versoeke van die API gestuur moet word. Die eksterne stelsel moet 'n publieke adres hê wat toeganklik is vanaf die internet met 'n geïnstalleerde SSL-sertifikaat.
Ook in die persoonlike rekening kan die domeinadministrateur die bronne van versoeke beperk wanneer toegang tot die API deur IP verkry word.
Ons ontvang inligting oor virtuele PBX-gebruikers
Om 'n lys van gebruikers of groepe te kry, moet jy 'n versoek na die virtuele PBX stuur met behulp van die metode /gebruikersinligting.
{
"domain":"example.ru"
}
In reaksie sal jy 'n lys ontvang wat jy kan stoor.
{
"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^_^]
}
]
Hierdie metode slaag twee skikkings. Een met domeingebruikers, een met domeingroepe. Die groep het ook die geleentheid om 'n e-pos te spesifiseer wat in die versoek gestuur sal word.
Verwerk inligting oor 'n inkomende oproep
Die koppeling van korporatiewe telefonie aan verskeie CRM-stelsels spaar tyd vir werknemers wat met kliënte kommunikeer en bespoedig die verwerking van inkomende oproepe. Byvoorbeeld, met 'n oproep van 'n huidige kliënt, kan CRM sy kaart oopmaak, en vanaf CRM kan jy 'n oproep na die kliënt stuur en hom met 'n werknemer verbind.
Om inligting oor API-oproepe te kry, moet jy die metode gebruik /kry_nommer_inligting, wat 'n lys oproepe genereer met inligting oor die groep waarheen die oproep versprei word. Kom ons neem aan dat die virtuele PBX-nommer 'n inkomende oproep van die nommer 1234567890 ontvang. Dan sal die PBX die volgende versoek stuur:
{
"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":""
}
Volgende moet jy die hanteerder koppel /kry_nommer_inligting. Die versoek moet uitgevoer word wanneer 'n inkomende oproep op die inkomende lyn aankom voordat die oproepe herlei word. As 'n antwoord op 'n versoek nie binne die gespesifiseerde tyd ontvang word nie, word die oproep herlei volgens die reëls wat in die domein vasgestel is.
Voorbeeld van 'n hanteerder aan die CRM-kant.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Reaksie van die hanteerder.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Ons volg die status en laai oproepopnames af
In Rostelecom se virtuele PBX word oproepopname in jou persoonlike rekening geaktiveer. Deur die API te gebruik, kan u die status van hierdie funksie naspoor. Wanneer 'n oproepbeëindiging verwerk word in oproep_gebeurtenisse jy kan die vlag sien 'is_rekord', wat die gebruiker in kennis stel van die status van die inskrywing: waar beteken dat die gebruiker se oproepopnamefunksie geaktiveer is.
Om 'n opname af te laai, moet jy die oproepsessie-ID gebruik sessie ID stuur 'n versoek aan api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
In reaksie sal jy 'n tydelike skakel ontvang om 'n lêer met 'n opname van die gesprek af te laai.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Die lêerbergingstyd word in jou persoonlike rekeninginstellings gestel. Daarna sal die lêer uitgevee word.
Statistiek en verslagdoening
In jou persoonlike rekening op 'n aparte bladsy kan jy statistieke en verslagdoening oor alle oproepe sien en filters toepas volgens status en tyd. Deur die API moet jy eers die oproep met die metode verwerk /oproep_gebeurtenisse:
{
"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"
}
Roep dan die metode oproep_inligting om die skikking te verwerk en die oproep in die CRM-stelsel te vertoon.
{
"session_id":"SDsnZugDFmTW7Sec"
}
In reaksie hierop sal jy 'n verskeidenheid data ontvang wat verwerk kan word om data in die CRM-logboek te stoor.
{
"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":""
}
}
Ander nuttige virtuele PBX-kenmerke
Behalwe die API, het 'n virtuele PBX verskeie ander nuttige kenmerke wat jy kan gebruik. Dit is byvoorbeeld 'n interaktiewe stemkieslys en die integrasie van sellulêre en vaste kommunikasie.
Interaktiewe Stemreaksie (IVR) is wat ons op die selfoon hoor voordat die persoon antwoord. In wese is dit 'n elektroniese operateur wat oproepe na die toepaslike departemente herlei en sommige vrae outomaties beantwoord. Binnekort sal dit moontlik wees om met IVR via die API te werk: ons ontwikkel tans sagteware wat jou sal toelaat om die vordering van 'n oproep deur die IVR na te spoor en inligting te ontvang oor aanraaktoontoetsaanslae wanneer die intekenaar in die stemkieslys is.
Om korporatiewe telefonie na selfone oor te dra, kan jy óf sagtefoontoepassings gebruik óf die Fixed Mobile Convergence-diens (FMC) afsonderlik aktiveer. Met enige van die metodes is oproepe binne die netwerk gratis, dit word moontlik om met kort nommers te werk, en oproepe kan opgeneem word en algemene statistieke kan daaroor gehou word.
Die verskil is dat sagtefone die internet nodig het om te kommunikeer, maar hulle is nie aan 'n operateur gekoppel nie, terwyl FMC aan 'n spesifieke operateur gekoppel is, maar selfs op ou drukknoppie-fone gebruik kan word.
Bron: will.com