Khoebo ea sejoale-joale e nka mehala ea mohala e le theknoloji e siiloeng ke nako: likhokahano tsa mehala li netefatsa ho tsamaea le ho fumaneha kamehla ha basebetsi, marang-rang a sechaba le manqosa a potlakileng ke mocha oa puisano o bonolo le o potlakileng. Ho tsamaisana le bahlolisani ba bona, li-PBX tsa ofisi li ntse li tšoana le tsona: li fallela marung, li laoloa ka sebopeho sa marang-rang 'me li kopantsoe le mekhoa e meng ka API. Ka poso ena re tla u bolella hore na ke mesebetsi efe eo Rostelecom virtual PBX API e nang le eona le mokhoa oa ho sebetsa le mesebetsi ea mantlha ea PBX ea sebele ka eona.
Mosebetsi o ka sehloohong oa Rostelecom virtual PBX API ke ho sebelisana le CRM kapa liwebsaete tsa khampani. Mohlala, API e sebelisa li-widget tsa "call back" le "call from site" bakeng sa litsamaiso tse kholo tsa taolo: WordPress, Bitrix, OpenCart. API e lumella:
- Fumana tlhahisoleseling, tsebisa boemo le ho etsa mehala ha u e kopa ho tsoa ho sistimi e kantle;
- Fumana sehokelo sa nakoana ho hatisa moqoqo;
- Laola le ho amohela lithibelo tsa lithibelo ho tsoa ho basebelisi;
- Fumana leseli mabapi le mosebelisi oa PBX oa sebele;
- Kopa nalane ea mekoloto ea mehala le litefiso;
- Kenya tlaleho ea mehala.
Kamoo API e sebetsang kateng
API ea ho kopanya le sistimi ea kantle e sebelisana ka likopo tsa HTTP. Tlalehong ea botho, mookameli o beha liaterese moo likōpo ho API li lokelang ho fihla teng le moo likōpo tse tsoang ho API li lokelang ho romeloa teng. Sistimi ea kantle e tlameha ho ba le aterese ea sechaba e fumanehang marang-rang e nang le setifikeiti sa SSL se kentsoeng.
Hape ho akhaonto ea hau, mookameli oa sebaka sa marang-rang a ka fokotsa mehloli ea likopo ha a fihlella API ka IP.
Re fumana leseli mabapi le basebelisi ba PBX ba sebele
Ho fumana lenane la basebelisi kapa lihlopha, o hloka ho romella kopo ho PBX ea sebele u sebelisa mokhoa /users_info.
{
"domain":"example.ru"
}
Ha u arabela, u tla fumana lethathamo leo u ka le bolokang.
{
"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^_^]
}
]
Mokhoa ona o kenyelletsa likarolo tse peli. E 'ngoe e nang le basebelisi ba domain, e' ngoe e nang le lihlopha tsa domain. Sehlopha se boetse se na le monyetla oa ho hlakisa lengolo-tsoibila le tla romelloa kopong.
E sebetsana le tlhahisoleseling mabapi le mohala o kenang
Ho hokela mehala ea khoebo ho litsamaiso tse fapaneng tsa CRM ho boloka nako bakeng sa basebetsi ba sebelisanang le bareki le ho potlakisa ho sebetsa ha mehala e kenang. Mohlala, ha o letsetsa moreki oa hajoale, CRM e ka bula karete ea hae, 'me ho tsoa ho CRM o ka romella mohala ho moreki mme oa mo hokahanya le mohiruoa.
Ho fumana leseli mabapi le mehala ea API, o hloka ho sebelisa mokhoa ona /fumana_nomoro_info, e hlahisang lenane la di-call tse nang le tlhahisoleseding mabapi le sehlopha seo mohala o romelwang ho sona. Ha re nke hore nomoro ea PBX ea sebele e fumana mohala o kenang ho tsoa ho nomoro ea 1234567890. Joale PBX e tla romela kopo e latelang:
{
"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":""
}
Ka mor'a moo, o hloka ho hokahanya mochine /fumana_nomoro_info. Kopo e tlameha ho phethoa ha mohala o kenang o fihla mohaleng o kenang pele li-call li tsamaisoa. Haeba karabo ea kopo e sa amoheloe ka nako e behiloeng, joale mohala o tsamaisoa ho latela melao e thehiloeng sebakeng sa marang-rang.
Mohlala oa motho ea sebetsang ka lehlakoreng la CRM.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Karabo ho tsoa ho mohlokomeli.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Re lekola boemo mme re jarolla lirekoto tsa mohala
Ho PBX ea sebele ea Rostelecom, ho rekota mohala ho kentsoe tšebetsong akhaonteng ea hau. U sebelisa API, u ka latela boemo ba mosebetsi ona. Ha o sebetsa ho kgaotsa mohala ho letsa_liketsahalo u ka bona folakha 'ke_rekoto', e tsebisang mosebelisi ka boemo ba ho kena: 'nete ho bolela hore mosebetsi oa ho rekota mohala oa mosebelisi o nolofalitsoe.
Ho jarolla rekoto, o hloka ho sebelisa ID ea nako ea mohala seboka_id romela kopo ho api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ho arabela, o tla fumana sehokelo sa nakoana sa ho khoasolla faele e nang le rekoto ea moqoqo.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Nako ea ho boloka lifaele e behiloe litlhophisong tsa akhaonto ea hau. Ka mor'a moo, faele e tla hlakoloa.
Lipalopalo le tlaleho
Ak'haonteng ea hau leqepheng le arohaneng u ka bona lipalo-palo le ho tlaleha mehala eohle le ho sebelisa li-filters ho latela maemo le nako. Ka API, o tlameha ho qala ho sebetsana le mohala ka mokhoa /letsa_liketsahalo:
{
"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"
}
Ebe u letsetsa mokhoa letsetsa_info ho sebetsana le sehlopha le ho bonts'a mohala ho sistimi ea CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ha u araba, u tla fumana lethathamo la lintlha tse ka sebetsoang ho boloka data ho log ea CRM.
{
"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":""
}
}
Likarolo tse ling tse sebetsang tsa PBX
Ntle le API, PBX ea sebele e na le likarolo tse ling tsa bohlokoa tseo u ka li sebelisang. Ka mohlala, ena ke menu e sebetsanang ea lentsoe le ho kopanya melaetsa ea selefouno le e tsitsitseng.
Interactive Voice Response (IVR) ke seo re se utloang ka mohala pele motho a araba. Ha e le hantle, enoa ke opareitara ea elektroniki e khutlisetsang mehala ho mafapha a nepahetseng ebe e araba lipotso tse ling ka bo eona. Haufinyane ho tla khonahala ho sebetsa le IVR ka API: hajoale re ntse re nts'etsapele software e tla u lumella ho lekola tsoelo-pele ea mohala ka IVR le ho fumana tlhahisoleseling mabapi le li-keytroke tsa ho ama ha motho ea ngolisitseng a le lethathamong la lentsoe.
Ho fetisetsa mohala oa khoebo ho lifono tsa cellular, u ka sebelisa lisebelisoa tsa softphone kapa ua kenya tšebetsong tšebeletso ea Fixed Mobile Convergence (FMC). Ka mekhoa efe kapa efe, li-call ka har'a marang-rang li lokolohile, hoa khoneha ho sebetsa ka linomoro tse khutšoanyane, 'me li-call li ka tlalehoa' me lipalo-palo tse akaretsang li ka bolokoa ho tsona.
Phapang ke hore li-softphone li hloka Inthanete ho buisana, empa ha li tlameletsoe ho opareitara, ha FMC e tlameletsoe ho opareitara e itseng, empa e ka sebelisoa esita le ka lifono tsa khale tsa push-button.
Source: www.habr.com