Res hodiernae telephonicas landlineas percipit ut technologiae iam pridem: communicationum cellularum mobilitatem et constantem promptitudinem opificum, retiacula socialia et nuntios instantes faciliores et velociores canales communicationis sunt. Ut cum competitoribus suis, officium PBXs illis magis ac magis similes fiunt: moventur ad nubem, per interfaciem interreti administrantur et cum aliis systematibus per API integrantur. In hoc poste narrabimus tibi quae munera Rostelecom virtualis PBX API habeat et quomodo operari cum functionibus principalibus virtualis PBX per illam.
Praecipuum munus Rostelecom virtualis PBX API est commercium cum CRM vel societati websites. Exempli gratia, instrumenta API "revocare" et "vocare a site" contenta pro principali systemate administratione: WordPress, Bitrix, OpenCart. API concedit:
- Informationes accipere, statum certiorem facere et postulationem ab externo systemate fac;
- Coniunge tempus ut colloquii notet;
- Curo et restrictionem parametri ab utentibus accipias;
- Habere informationem de usure virtuali PBX;
- Petitio historiae vocationem debitorum et criminum;
- Index vocationem iniuriarum.
Quomodo API operatur
Integratio API et systema externum inter se mutuae petitiones HTTP utentes. In ratione personali, administrator inscriptiones ponit ubi petitiones ad API perveniant et ubi postulationes ab API mitterentur. Ratio externa debet habere electronicam publicam accessum e Interrete cum libellum SSL inauguratum.
Etiam in ratione propria, administrator dominici fontes petitionum circumscribere potest cum accessu API per IP.
Nos informationes de virtualis PBX users
Ut indicem usorum vel sodalitatum accipias, rogationem ad virtualem PBX mittere debes methodo utendi /users_info.
{
"domain":"example.ru"
}
Respondens habebis indicem quod servare potes.
{
"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^_^]
}
]
Duos hic vestit modus transit. Unus cum usoribus dominicis, unus cum coetibus dominicis. Coetus etiam facultatem habet specificare electronicam quae mittetur in petitione.
Processus notitia de advenientis vocatio
Coniungens telephonia corporatum variis systematibus CRM servat tempus conductorum qui se occurrunt cum clientibus et accelerat processum advenientis vocat. Exempli gratia, vocationi a cliente currente, CRM suum chartam aperire potest, et ex CRM vocationem ad clientem mittere potes et eum cum operario coniungere.
Ut informationes de API vocat, methodo uti debes /get_number_infoquae elenchum generat cum informatione de coetu ad quem vocationem distribuitur. Ponamus virtualem PBX numerum recipere vocationem advenientem ex numero 1234567890. Deinde mittet PBX sequentem petitionem;
{
"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":""
}
Deinde vos postulo tracto coniungere /get_number_info. Postulatio exsecutioni mandanda est cum advenientis vocatio advenit in linea advenientis antequam vocationum fusae sunt. Si responsio ad petitionem intra praefinitum tempus non recipitur, vocatio fugatur secundum normas in dominio statutas.
Exemplum tracto in CRM parte.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Responsio a tracto.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Nos status ac download inuestigandum vocationem tabulas
In Rostelecom virtuali PBX, memoria in tua propria ratione reducitur. API utens, statum huius functionis indagare potes. Cum processus vocationem terminatur call_events potes videre vexillum 'is_record', quae notificat usorem de statu introitus; verum significat quod munus usoris vocationis recordationis idoneus est.
Ad tabulam detrahendam, sessionem vocationis uti debes ID session_id petentibus mittere api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
In responsio, nexum temporalem recipies ut tabellam cum monumento colloquii accipias.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Tabella repono tempus in rationi personali positum est. Postea tabella delebitur.
Statistics et renuntiationes
In ratione personali in pagina separato potes videre statisticam et renuntiationem in omnibus vocationibus et filtras per statum tempusque applica. Per API, oportet primum processum vocationis cum methodo /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"
}
Tum vocant modum call_info ad processum ordinata et propono vocationem in CRM ratio.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Respondens accipietis ordinem notitiarum quae discursum esse potest ad congregem in CRM stipes.
{
"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":""
}
}
Aliae utiles virtualis PBX features
Praeter API, virtualis PBX varias alias notas utiles habet quibus uti potes. Exempli gratia, haec est menu vocis interactiva et integratio communicationum cellularum et fixarum.
Interactive Voice Responsio (IVR) est quod audimus in telephono mobili coram persona responsa. Essentialiter hic est operator electronicus qui redirectiones vocat ad proprias Dicasteria et nonnullas quaestiones ipso facto respondet. Mox cum IVR per API laborare poterit: programmatis nunc invenimus qui te per IVR progressum vocationis indagare permittet et informationes de sono clavium tactus recipiat cum subscribens in voce menu est.
Ad telephonia telephonica mobile transferre, uti potes vel applicationibus cinematographicis uti vel separatim mobile fixum concursus (FMC) operandi. Cum quibusvis methodis, quae intra retiacula libera sunt, fieri potest ut brevibus numeris laborare, et vocatus adnotetur et statistica generalis in illis retineri potest.
Differentia est quod softphones egent interreti ad communicandum, sed operatori non ligantur, cum FMC cuidam operanti specifico ligatur, sed etiam in phones dis-buttonis antiquis adhiberi potest.
Source: www.habr.com