Azụmahịa nke oge a na-ahụta ekwentị ala dị ka teknụzụ ochie: nkwukọrịta ekwentị na-eme ka ngagharị na ndị ọrụ na-adị mgbe niile, netwọkụ mmekọrịta na ndị ozi ozugbo bụ ọwa nkwukọrịta dị mfe na ngwa ngwa. Iji na-agbaso ndị asọmpi ha, ụlọ ọrụ PBX na-adịwanye ka ha: ha na-akwaga na ígwé ojii, jikwaa site na ntanetị weebụ ma jikọta ya na usoro ndị ọzọ site na API. Na post a, anyị ga-agwa gị ọrụ ndị Rostelecom virtual PBX API nwere yana otu esi arụ ọrụ na isi ọrụ nke PBX mebere site na ya.
Ọrụ bụ isi nke Rostelecom mebere PBX API bụ mmekọrịta na CRM ma ọ bụ webụsaịtị ụlọ ọrụ. Dịka ọmụmaatụ, API na-arụ ọrụ "oku azụ" na "oku sitere na saịtị" wijetị maka sistemụ njikwa isi: WordPress, Bitrix, OpenCart. API na-enye ohere:
- Anata ozi, gwa ọkwa ma kpọọ oku site na sistemụ mpụga;
- Nweta njikọ nwa oge ka ịdekọ mkparịta ụka;
- Jikwaa ma nata oke mmachi n'aka ndị ọrụ;
- Nweta ozi gbasara onye ọrụ PBX mebere;
- Rịọ akụkọ ihe mere eme nke debits na ụgwọ oku;
- Bulite ndekọ oku.
Otu API si arụ ọrụ
API mwekota na sistemu mpụta na-eji arịrịọ HTTP emekọrịta ihe. Na akaụntụ nkeonwe, onye nchịkwa na-edobe adreesị ebe arịrịọ API kwesịrị ịbịarute yana ebe a ga-eziga arịrịọ sitere na API. Sistemụ mpụga ga-enwerịrị adreesị ọhaneze enwere ike ịnweta na ịntanetị yana asambodo SSL arụnyere.
Nakwa na akaụntụ nkeonwe, onye nchịkwa ngalaba nwere ike ịmachi isi mmalite nke arịrịọ mgbe ị na-enweta API site na IP.
Anyị na-enweta ozi gbasara ndị ọrụ PBX mebere
Iji nweta ndepụta nke ndị ọrụ ma ọ bụ otu, ịkwesịrị iziga arịrịọ na PBX mebere site na iji usoro ahụ /users_info.
{
"domain":"example.ru"
}
Na nzaghachi, ị ga-enweta ndepụta nke ị nwere ike ịchekwa.
{
"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^_^]
}
]
Usoro a na-ewe nkeji iri abụọ. Otu nwere ngalaba ndị ọrụ, otu nwere ngalaba ngalaba. Otu ahụ nwekwara ohere ịkọwa ozi-e nke a ga-eziga na arịrịọ ahụ.
Na-ahazi ozi gbasara oku mbata
Ijikọ ekwentị ụlọ ọrụ na sistemụ CRM dị iche iche na-azọpụta oge maka ndị ọrụ na-emekọrịta ihe na ndị ahịa na-eme ka nhazi nke oku mbata dị ngwa ngwa. Dịka ọmụmaatụ, mgbe oku sitere n'aka onye ahịa ugbu a, CRM nwere ike imepe kaadị ya, na site na CRM ị nwere ike izipu oku na onye ahịa wee jikọọ ya na onye ọrụ.
Iji nweta ozi gbasara oku API, ịkwesịrị iji usoro a / nweta_nọmba_ozi, nke na-ewepụta ndepụta oku nwere ozi gbasara otu a na-ekesa oku a. Ka anyị were na nọmba PBX mebere na-enweta oku mbata site na nọmba 1234567890. Mgbe ahụ PBX ga-ezite arịrịọ a:
{
"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":""
}
Ọzọ ị ga-ejikọ onye njikwa / nweta_nọmba_ozi. Arịrịọ a ga-emerịrị mgbe oku mbata rutere n'ahịrị mbata tupu ebibie oku a. Ọ bụrụ na anabataghị nzaghachi maka arịrịọ n'ime oge a kapịrị ọnụ, mgbe ahụ, a na-emegharị oku ahụ dịka iwu ndị e guzobere na ngalaba.
Ọmụmaatụ nke onye njikwa n'akụkụ 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;
Azịza sitere n'aka onye njikwa.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Anyị na-eso ọkwa ma budata ndekọ oku
Na Rostelecom mebere PBX, ndekọ oku na-arụ ọrụ na akaụntụ nkeonwe gị. Iji API, ị nwere ike soro ọnọdụ ọrụ a. Mgbe ị na-ahazi nkwụsị oku na-abanye ihe omume oku ị nwere ike ịhụ ọkọlọtọ 'bụ_ndekọ', nke na-eme ka onye ọrụ mara maka ọkwa ntinye: ezi pụtara na agbanyere ọrụ ndekọ oku onye ọrụ.
Iji budata ndekọ, ịkwesịrị iji NJ nnọkọ oku session_id ziga arịrịọ ka api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Na nzaghachi, ị ga-enweta njikọ nwa oge iji budata faịlụ nwere ndekọ mkparịta ụka.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Edebere oge nchekwa faịlụ na ntọala akaụntụ nkeonwe gị. Emechaa faịlụ a ga-ehichapụ.
Statistics na akuko
Na akaụntụ nkeonwe gị na ibe dị iche ị nwere ike ịhụ ọnụ ọgụgụ na ịkọ akụkọ oku niile wee tinye nzacha site na ọkwa na oge. Site na API, ị ga-ebu ụzọ hazie oku a na usoro / ihe omume oku:
{
"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"
}
Mgbe ahụ kpọọ usoro oku_info iji hazie nhazi ahụ wee gosipụta oku na sistemụ CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Na nzaghachi, ị ga-enweta ọtụtụ data enwere ike ịhazi iji chekwaa data na log 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":""
}
}
Atụmatụ PBX mebere ndị ọzọ bara uru
E wezụga API, PBX mebere nwere ọtụtụ atụmatụ bara uru ndị ọzọ ị nwere ike iji. Dịka ọmụmaatụ, nke a bụ nchịkọta olu na-emekọrịta ihe yana njikọta nke ekwentị mkpanaaka na nke edoziri.
Nzaghachi Voice Interactive (IVR) bụ ihe anyị na-anụ na ekwentị tupu onye ahụ azaa. N'ụzọ bụ isi, nke a bụ onye na-ahụ maka eletrọnịkị na-ebugharị oku gaa na ngalaba dabara adaba wee zaa ajụjụ ụfọdụ na-akpaghị aka. N'oge na-adịghị anya, ọ ga-ekwe omume ịrụ ọrụ na IVR site na API: ugbu a anyị na-emepụta ngwanrọ nke ga-enye gị ohere soro ọganihu nke oku na-aga site na IVR wee nweta ozi gbasara mkpịsị aka ụda mgbe onye debanyere aha nọ na menu olu.
Ka ịnyefe ekwentị ụlọ ọrụ na ekwentị mkpanaaka, ị nwere ike iji ngwa ekwentị ma ọ bụ mee ka ọrụ Fixed Mobile Convergence (FMC) rụọ ọrụ iche. N'ime usoro ọ bụla, oku n'ime netwọk ahụ bụ n'efu, ọ ga-ekwe omume iji nọmba dị mkpirikpi rụọ ọrụ, enwere ike ịdekọ oku yana enwere ike idobe ọnụ ọgụgụ izugbe na ha.
Ihe dị iche bụ na ekwentị dị nro chọrọ ịntanetị iji kparịta ụka, mana ejikọtaghị ha na onye na-arụ ọrụ, ebe FMC na-ejikọta ya na onye ọrụ kpọmkwem, mana enwere ike iji ya ọbụna na ekwentị push-button ochie.
isi: www.habr.com