Ang modernong negosyo nagtan-aw sa landline nga mga telepono isip usa ka karaan nga teknolohiya: ang mga komunikasyon sa cellular nagsiguro sa paglihok ug kanunay nga pagkaanaa sa mga empleyado, mga social network ug mga instant messenger usa ka mas sayon ug mas paspas nga agianan sa komunikasyon. Aron makasunod sa ilang mga kakompetensya, ang mga PBX sa opisina nahimong mas ug mas susama kanila: sila mibalhin ngadto sa panganod, gidumala pinaagi sa web interface ug gisagol sa ubang mga sistema pinaagi sa API. Niini nga post isulti namon kanimo kung unsa ang mga gimbuhaton sa Rostelecom virtual PBX API ug kung giunsa ang pagtrabaho sa mga nag-unang gimbuhaton sa virtual PBX pinaagi niini.
Ang nag-unang tahas sa Rostelecom virtual PBX API mao ang interaksiyon sa CRM o mga website sa kompanya. Pananglitan, ang API nagpatuman sa "tawag balik" ug "tawag gikan sa site" nga mga widgets alang sa mga nag-unang sistema sa pagdumala: WordPress, Bitrix, OpenCart. Gitugotan sa API ang:
- Pagdawat sa kasayuran, pagpahibalo sa kahimtang ug paghimo mga tawag kung gihangyo gikan sa usa ka eksternal nga sistema;
- Pagkuha usa ka temporaryo nga link aron irekord ang panag-istoryahanay;
- Pagdumala ug pagdawat sa mga parameter sa pagdili gikan sa mga tiggamit;
- Pagkuha og impormasyon mahitungod sa virtual PBX user;
- Paghangyo sa kasaysayan sa mga debit sa tawag ug mga bayranan;
- Pag-upload sa log sa tawag.
Giunsa pagtrabaho ang API
Ang integrasyon nga API ug ang eksternal nga sistema nakig-uban sa usag usa gamit ang mga hangyo sa HTTP. Sa personal nga account, ang tagdumala nagtakda sa mga adres kung diin ang mga hangyo sa API kinahanglan nga moabut ug kung diin ang mga hangyo gikan sa API kinahanglan ipadala. Ang eksternal nga sistema kinahanglan adunay usa ka publiko nga adres nga ma-access gikan sa Internet nga adunay usa ka naka-install nga sertipiko sa SSL.
Usab sa personal nga asoy, ang tagdumala sa domain mahimong limitahan ang mga gigikanan sa mga hangyo kung mag-access sa API pinaagi sa IP.
Nakadawat kami og impormasyon bahin sa mga virtual nga tiggamit sa PBX
Aron makakuha usa ka lista sa mga tiggamit o grupo, kinahanglan nimo nga magpadala usa ka hangyo sa virtual nga PBX gamit ang pamaagi /users_info.
{
"domain":"example.ru"
}
Agig tubag, makadawat ka usa ka lista nga mahimo nimong i-save.
{
"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^_^]
}
]
Kini nga pamaagi moagi sa duha ka mga arrays. Usa nga adunay mga tiggamit sa domain, usa nga adunay mga grupo sa domain. Ang grupo usab adunay higayon sa pagtino sa usa ka email nga ipadala sa hangyo.
Pagproseso sa impormasyon bahin sa umaabot nga tawag
Ang pagkonektar sa corporate telephony ngadto sa nagkalain-laing CRM system makadaginot ug panahon para sa mga empleyado nga makig-interact sa mga kliyente ug makapadali sa pagproseso sa mga umaabot nga tawag. Pananglitan, sa usa ka tawag gikan sa usa ka kasamtangan nga kliyente, ang CRM mahimong magbukas sa iyang kard, ug gikan sa CRM mahimo nimong ipadala ang usa ka tawag sa kliyente ug ikonektar siya sa usa ka empleyado.
Aron makakuha og impormasyon bahin sa mga tawag sa API, kinahanglan nimong gamiton ang pamaagi /get_number_info, nga nagmugna og lista sa mga tawag nga adunay impormasyon mahitungod sa grupo diin ang tawag giapod-apod. Ibutang nato nga ang virtual PBX nga numero makadawat ug umaabot nga tawag gikan sa numero 1234567890. Unya ang PBX magpadala sa mosunod nga hangyo:
{
"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":""
}
Sunod kinahanglan nimo nga ikonektar ang handler /get_number_info. Ang hangyo kinahanglan ipatuman kung ang usa ka umaabot nga tawag moabut sa umaabot nga linya sa wala pa ang mga tawag madala. Kung ang usa ka tubag sa usa ka hangyo wala madawat sa sulod sa gitakda nga oras, nan ang tawag madala sumala sa mga lagda nga gitukod sa domain.
Pananglitan sa usa ka handler sa CRM nga bahin.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Tubag gikan sa handler.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Among gisubay ang kahimtang ug gi-download ang mga rekording sa tawag
Sa virtual nga PBX sa Rostelecom, ang pagrekord sa tawag gi-aktibo sa imong personal nga account. Gamit ang API, masubay nimo ang kahimtang sa kini nga function. Kung giproseso ang pagtapos sa tawag sa call_events makita nimo ang bandila 'is_record', nga nagpahibalo sa tiggamit bahin sa kahimtang sa pagsulod: tinuod nga nagpasabot nga ang function sa pagrekord sa tawag sa user gipaandar.
Aron maka-download og recording, kinahanglan nimong gamiton ang call session ID session_id magpadala ug hangyo sa api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Agig tubag, makadawat ka usa ka temporaryo nga link aron ma-download ang usa ka file nga adunay pagrekord sa panag-istoryahanay.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Ang oras sa pagtipig sa file gitakda sa mga setting sa imong personal nga account. Pagkahuman ang file matangtang.
Estadistika ug pagreport
Sa imong personal nga account sa usa ka bulag nga panid makita nimo ang mga estadistika ug pagreport sa tanan nga mga tawag ug magamit ang mga pagsala pinaagi sa kahimtang ug oras. Pinaagi sa API, kinahanglan nimo una nga iproseso ang tawag gamit ang pamaagi /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"
}
Unya tawagan ang pamaagi call_info aron maproseso ang array ug ipakita ang tawag sa CRM system.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Agig tubag, makadawat ka usa ka han-ay sa datos nga mahimong maproseso aron matipigan ang datos sa CRM log.
{
"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":""
}
}
Uban pang mapuslanon nga virtual nga mga bahin sa PBX
Gawas sa API, ang usa ka virtual nga PBX adunay daghang uban pang mapuslanon nga mga bahin nga imong magamit. Pananglitan, kini usa ka interactive nga voice menu ug ang panagsama sa cellular ug fixed nga komunikasyon.
Ang Interactive Voice Response (IVR) mao ang atong madungog sa handset sa dili pa motubag ang tawo. Sa tinuud, kini usa ka elektronik nga operator nga nag-redirect sa mga tawag sa angay nga mga departamento ug awtomatiko nga gitubag ang pipila ka mga pangutana. Sa dili madugay mahimong posible nga magtrabaho uban sa IVR pinaagi sa API: kami sa pagkakaron nagpalambo og software nga magtugot kanimo sa pagsubay sa pag-uswag sa usa ka tawag pinaagi sa IVR ug makadawat og impormasyon mahitungod sa touch-tone keystroke kung ang subscriber anaa sa voice menu.
Aron mabalhin ang corporate telephony ngadto sa mga mobile phone, mahimo nimong gamiton ang softphone applications o bulag nga i-activate ang Fixed Mobile Convergence (FMC) nga serbisyo. Sa bisan unsa nga mga pamaagi, ang mga tawag sa sulod sa network libre, mahimo’g posible nga magtrabaho uban ang mubu nga mga numero, ug ang mga tawag mahimong marekord ug ang mga kinatibuk-ang estadistika mahimong itago sa kanila.
Ang kalainan mao nga ang mga softphone nagkinahanglan sa Internet aron makigkomunikar, apan wala kini gihigot sa usa ka operator, samtang ang FMC gihigot sa usa ka piho nga operator, apan mahimong gamiton bisan sa daan nga push-button nga mga telepono.
Source: www.habr.com