Modernt företag uppfattar fasta telefoner som en föråldrad teknik: mobilkommunikation säkerställer mobilitet och konstant tillgänglighet för anställda, sociala nätverk och snabbmeddelanden är en enklare och snabbare kommunikationskanal. För att hålla jämna steg med sina konkurrenter blir kontorsväxeln mer och mer lika dem: de flyttar till molnet, hanteras via ett webbgränssnitt och integreras med andra system via API. I det här inlägget kommer vi att berätta vilka funktioner Rostelecoms virtuella PBX-API har och hur man arbetar med den virtuella telefonväxelns huvudfunktioner genom den.
Huvuduppgiften för Rostelecoms virtuella PBX API är interaktion med CRM eller företagswebbplatser. Till exempel implementerar API:et "ring tillbaka" och "samtal från webbplats"-widgets för de viktigaste ledningssystemen: WordPress, Bitrix, OpenCart. API:et tillåter:
- Ta emot information, meddela status och ringa samtal på begäran från ett externt system;
- Få en tillfällig länk för att spela in konversationen;
- Hantera och ta emot begränsningsparametrar från användare;
- Få information om den virtuella PBX-användaren;
- Begär historik över samtalsdebiteringar och avgifter;
- Ladda upp samtalslogg.
Hur API fungerar
Integrerings-API:et och det externa systemet interagerar med varandra med hjälp av HTTP-förfrågningar. I det personliga kontot ställer administratören in adresserna dit förfrågningar till API:et ska anlända och dit förfrågningar från API:et ska skickas. Det externa systemet måste ha en offentlig adress som är tillgänglig från Internet med ett installerat SSL-certifikat.
Också i det personliga kontot kan domänadministratören begränsa källorna till förfrågningar vid åtkomst till API:t via IP.
Vi får information om virtuella PBX-användare
För att få en lista över användare eller grupper måste du skicka en förfrågan till den virtuella telefonväxeln med metoden /users_info.
{
"domain":"example.ru"
}
Som svar får du en lista som du kan spara.
{
"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^_^]
}
]
Denna metod passerar två arrayer. En med domänanvändare, en med domängrupper. Gruppen har även möjlighet att ange ett mejl som ska skickas i förfrågan.
Bearbetar information om ett inkommande samtal
Att koppla företagstelefoni till olika CRM-system sparar tid för anställda som interagerar med kunder och påskyndar behandlingen av inkommande samtal. Till exempel, vid ett samtal från en aktuell kund, kan CRM öppna hans kort, och från CRM kan du skicka ett samtal till kunden och koppla honom till en anställd.
För att få information om API-anrop måste du använda metoden /get_number_info, som genererar en lista över samtal med information om gruppen som samtalet distribueras till. Låt oss anta att det virtuella växelnumret tar emot ett inkommande samtal från numret 1234567890. Sedan skickar växeln följande begäran:
{
"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":""
}
Därefter måste du ansluta hanteraren /get_number_info. Begäran måste utföras när ett inkommande samtal kommer till den inkommande linjen innan samtalen dirigeras. Om ett svar på en förfrågan inte tas emot inom den angivna tiden, dirigeras samtalet enligt de regler som fastställts i domänen.
Exempel på en hanterare på CRM-sidan.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Svar från hanteraren.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Vi spårar status och laddar ner samtalsinspelningar
I Rostelecoms virtuella telefonväxel aktiveras samtalsinspelning på ditt personliga konto. Med hjälp av API:t kan du spåra statusen för denna funktion. Vid behandling av en samtalsavslutning i call_events du kan se flaggan 'är_rekord', som meddelar användaren om postens status: sann betyder att användarens samtalsinspelningsfunktion är aktiverad.
För att ladda ner en inspelning måste du använda samtalssessions-ID session_id skicka en förfrågan till api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Som svar får du en tillfällig länk för att ladda ner en fil med en inspelning av konversationen.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Fillagringstiden ställs in i dina personliga kontoinställningar. Därefter raderas filen.
Statistik och rapportering
I ditt personliga konto på en separat sida kan du se statistik och rapportering på alla samtal och tillämpa filter efter status och tid. Genom API:t måste du först bearbeta anropet med metoden /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"
}
Ring sedan metoden call_info för att bearbeta arrayen och visa samtalet i CRM-systemet.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Som svar kommer du att få en mängd data som kan bearbetas för att lagra data i CRM-loggen.
{
"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":""
}
}
Andra användbara virtuella PBX-funktioner
Förutom API:et har en virtuell PBX flera andra användbara funktioner som du kan använda. Detta är till exempel en interaktiv röstmeny och integrationen av mobil och fast kommunikation.
Interactive Voice Response (IVR) är vad vi hör på luren innan personen svarar. I huvudsak är detta en elektronisk operatör som omdirigerar samtal till lämpliga avdelningar och svarar på vissa frågor automatiskt. Snart kommer det att vara möjligt att arbeta med IVR via API:t: vi utvecklar för närvarande mjukvara som gör att du kan spåra ett samtals förlopp genom IVR och få information om knapptryckningar när abonnenten är i röstmenyn.
För att överföra företagstelefoni till mobiltelefoner kan du antingen använda mjukvaruapplikationer eller aktivera tjänsten Fixed Mobile Convergence (FMC) separat. Med vilken som helst av metoderna är samtal inom nätet gratis, det blir möjligt att arbeta med korta nummer, och samtal kan spelas in och allmän statistik kan föras över dem.
Skillnaden är att softphones behöver internet för att kommunicera, men de är inte knutna till en operatör, medan FMC är knutna till en specifik operatör, utan kan användas även på gamla tryckknappstelefoner.
Källa: will.com