Bhizinesi remazuva ano rinoona nharembozha setekinoroji yechinyakare: nharembozha inovimbisa kufamba uye kuwanikwa kwevashandi nguva dzose, masocial network uye vatumwa varipo inzira iri nyore uye nekukurumidza yekutaurirana. Kuti uenderane nevakwikwidzi vavo, maPBX ehofisi ari kuwedzera kufanana navo: ari kutamira kune gore, anotungamirwa kuburikidza newebhu interface uye akabatanidzwa nemamwe masisitimu kuburikidza neAPI. Mune ino post tichakuudza kuti ndeapi mabasa ayo Rostelecom virtual PBX API ine uye maitiro ekushanda nemabasa makuru eiyo chaiyo PBX kuburikidza nayo.
Basa guru reRostelecom virtual PBX API kudyidzana neCRM kana webhusaiti yekambani. Semuenzaniso, iyo API inoshandisa "call back" uye "kufona kubva kune saiti" majeti eiyo huru manejimendi masisitimu: WordPress, Bitrix, OpenCart. Iyo API inobvumira:
- Gamuchira ruzivo, zivisa chimiro uye kufona pakukumbira kubva kune yekunze system;
- Tora chinongedzo chenguva pfupi kuti urekodhe hurukuro;
- Tonga uye gamuchira zvirambidzo paramita kubva kune vashandisi;
- Wana ruzivo nezve chaiyo PBX mushandisi;
- Kumbira nhoroondo yekufona debits nemachaji;
- Isa chinyorwa chekufona.
Iyo API inoshanda sei
Iyo yekubatanidza API uye yekunze sisitimu inodyidzana nemumwe uchishandisa zvikumbiro zveHTTP. Muakaunti yako pachako, maneja anoseta kero uko zvikumbiro kuAPI zvinofanirwa kusvika uye uko zvikumbiro kubva kuAPI zvinofanirwa kutumirwa. Iyo yekunze sisitimu inofanirwa kuve neruzhinji kero inowanikwa kubva paInternet ine yakaiswa SSL chitupa.
Zvakare muakaundi yako pachako, iyo domain administrator inogona kudzikamisa masosi ezvikumbiro kana uchiwana iyo API neIP.
Isu tinogashira ruzivo nezve chaiyo PBX vashandisi
Kuti uwane runyorwa rwevashandisi kana mapoka, unofanirwa kutumira chikumbiro kune chaiyo PBX uchishandisa nzira /users_info.
{
"domain":"example.ru"
}
Mukupindura, iwe uchagamuchira runyoro rwaunogona kuchengetedza.
{
"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^_^]
}
]
Iyi nzira inopfuura mitsara miviri. Imwe ine vashandisi vedomasi, imwe ine madomasi mapoka. Boka racho rinewo mukana wekutsanangura email ichatumirwa mukukumbira.
Kugadzirisa ruzivo rwekufona kuri kuuya
Kubatanidza runhare rwemakambani kune akasiyana CRM masisitimu anochengetedza nguva yevashandi vanodyidzana nevatengi uye nekumhanyisa kugadzirisa kwemafoni anouya. Semuenzaniso, parunhare kubva kumutengi aripo, CRM inogona kuvhura kadhi rake, uye kubva kuCRM unogona kutumira runhare kumutengi uye kumubatanidza nemushandi.
Kuti uwane ruzivo nezve API mafoni, unofanirwa kushandisa nzira /tora_nhamba_info, iyo inogadzira runyoro rwekufona neruzivo nezve boka iro runhare rwunogoverwa. Ngatifungei kuti nhamba yePBX chaiyo inogamuchira runhare kubva panhamba 1234567890. Ipapo PBX inotumira chikumbiro chinotevera:
{
"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":""
}
Next unofanira kubatanidza handler /tora_nhamba_info. Chikumbiro chinofanirwa kuitwa kana runhare rwunopinda rwasvika pamutsetse unouya kufona kusati kwaitwa. Kana mhinduro yechikumbiro isingagamuchirwi mukati menguva yakatarwa, ipapo kufona kunofambiswa maererano nemitemo yakagadzwa mudura.
Muenzaniso wemubati padivi reCRM.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Mhinduro kubva kumubati.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Isu tinoteedzera chimiro uye kurodha marekodhi ekufona
MuRostelecom's virtual PBX, kurekodha kwekufona kunoitwa muaccount yako. Uchishandisa iyo API, unogona kuteedzera chimiro chebasa iri. Paunenge uchigadzirisa kumisa kufona mukati kufona_zviitiko unogona kuona mureza 'is_record', iyo inozivisa mushandisi nezve mamiriro ekupinda: zvechokwadi zvinoreva kuti basa rekurekodha remushandisi rinogoneswa.
Kuti utore kurekodha, unofanirwa kushandisa iyo yekufona chikamu ID chikamu_id tumira chikumbiro kuna api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mukupindura, iwe unogashira chinongedzo chechinguvana chekurodha faira nerekodha yehurukuro.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Iyo nguva yekuchengetera faira yakaiswa mune yako account account marongero. Pashure pacho faira ichadzimwa.
Statistics uye reporting
Mune yako account account pane yakaparadzana peji iwe unogona kuona nhamba uye kushuma pane ese mafoni uye shandisa mafirita nechimiro uye nenguva. Kuburikidza neAPI, unofanira kutanga wagadzirisa kufona nenzira /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"
}
Wobva wafonera nzira call_info kugadzirisa hurongwa uye kuratidza kufona muCRM system.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mukupindura, iwe unogashira dhata re data rinogona kugadziriswa kuchengetedza data muCRM 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":""
}
}
Zvimwe zvinobatsira zvePBX zvinoshanda
Kunze kweiyo API, chaiyo PBX ine akati wandei mamwe maficha aunogona kushandisa. Semuenzaniso, iyi inopindirana yemenu yezwi uye kubatanidzwa kweserura uye yakagadziriswa kutaurirana.
Interactive Voice Response (IVR) ndizvo zvatinonzwa paruoko munhu asati apindura. Chaizvoizvo, uyu mushandisi wemagetsi anodzosera mafoni kumadhipatimendi akakodzera uye anopindura mimwe mibvunzo otomatiki. Nenguva isipi zvinogoneka kushanda neIVR kuburikidza neAPI: isu tiri kugadzira software iyo ichakubvumidza kuti utarise kufambira mberi kwekufona kuburikidza neIVR uye kugamuchira ruzivo nezve touch-toni keystrokes kana munyoreri ari mumenyu yezwi.
Kuendesa nharembozha kunharembozha, unogona kushandisa maapplication efoni nyoro kana kumisa sevhisi yeFixed Mobile Convergence (FMC). Neimwe yenzira idzi, mafoni ari mukati metiweki akasununguka, zvinogoneka kushanda nenhamba pfupi, uye mafoni anogona kurekodhwa uye huwandu hwese hunogona kuchengetwa pavari.
Musiyano ndewekuti maSoftphone anoda Indaneti kuti ataure, asi haana kusungirirwa kune anoshanda, nepo FMC yakasungirirwa kune mumwe munhu anoshanda, asi inogona kushandiswa kunyange pamafoni ekare e-push-bhatani.
Source: www.habr.com