Manaʻo nā ʻoihana hou i nā kelepona ʻāina ma ke ʻano he ʻenehana kahiko: ʻo ke kamaʻilio kelepona e hōʻoia i ka neʻe ʻana a me ka loaʻa mau o nā limahana, nā ʻupena pūnaewele a me nā ʻelele koke he ala maʻalahi a wikiwiki hoʻi. No ka hoʻomau ʻana i kā lākou mau mea hoʻokūkū, ʻoi aku ka nui o nā PBX o ke keʻena me lākou: ke neʻe nei lākou i ke ao, mālama ʻia ma o kahi kikowaena pūnaewele a hoʻohui pū me nā ʻōnaehana ʻē aʻe ma o API. Ma kēia pou e haʻi aku mākou iā ʻoe i nā hana a Rostelecom virtual PBX API a pehea e hana ai me nā hana nui o ka PBX virtual ma o ia.
ʻO ka hana nui o ka Rostelecom virtual PBX API ka pilina me CRM a i ʻole nā pūnaewele ʻoihana. No ka laʻana, hoʻokomo ka API i nā widget "kāhea mai" a me "kahea mai ka pūnaewele" no nā ʻōnaehana hoʻokele nui: WordPress, Bitrix, OpenCart. Hiki i ka API ke:
- Loaʻa i ka ʻike, hoʻolaha i ke kūlana a kāhea i nā kelepona ma ke noi mai kahi ʻōnaehana waho;
- E kiʻi i kahi loulou no ka hoʻopaʻa ʻana i ke kamaʻilio;
- Hoʻoponopono a loaʻa i nā palena palena mai nā mea hoʻohana;
- Loaʻa i ka ʻike e pili ana i ka mea hoʻohana virtual PBX;
- Noi i ka mōʻaukala o nā kelepona kelepona a me nā uku;
- Hoʻouka i ka moʻolelo kelepona.
Pehea e hana ai ka API
Hoʻopili ka API hoʻohui a me ka ʻōnaehana waho me ka hoʻohana ʻana i nā noi HTTP. Ma ka moʻokāki pilikino, hoʻonohonoho ka luna i nā helu wahi e hiki mai ai nā noi i ka API a kahi e hoʻouna ʻia ai nā noi mai ka API. Pono ka ʻōnaehana waho e loaʻa kahi helu lehulehu mai ka Pūnaewele me kahi palapala SSL i hoʻokomo ʻia.
I loko o ka moʻokāki pilikino, hiki i ka luna hoʻomalu ke kaupalena i nā kumu o nā noi i ka wā e komo ai i ka API e IP.
Loaʻa iā mākou ka ʻike e pili ana i nā mea hoʻohana virtual PBX
No ka loaʻa ʻana o kahi papa inoa o nā mea hoʻohana a i ʻole nā hui, pono ʻoe e hoʻouna i kahi noi i ka PBX virtual me ka hoʻohana ʻana i ke ʻano /users_info.
{
"domain":"example.ru"
}
Ma ka pane, e loaʻa iā ʻoe kahi papa inoa hiki iā ʻoe ke mālama.
{
"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^_^]
}
]
В данном методе передается два массива. Один с пользователями домена, один с группами домена. У группу также есть возможность указать электронную почту, которая будет передаваться в запросе.
Ke kaʻina ʻana i ka ʻike e pili ana i kahi kelepona hele mai
ʻO ka hoʻohui ʻana i ke kelepona hui i nā ʻōnaehana CRM like ʻole e mālama i ka manawa no nā limahana e launa pū me nā mea kūʻai aku a wikiwiki i ka hana ʻana i nā kelepona komo. No ka laʻana, ma ke kelepona mai kahi mea kūʻai aku i kēia manawa, hiki iā CRM ke wehe i kāna kāleka, a mai CRM hiki iā ʻoe ke hoʻouna i kahi kelepona i ka mea kūʻai aku a hoʻopili iā ia me kahi limahana.
No ka loaʻa ʻana o ka ʻike e pili ana i nā kelepona API, pono ʻoe e hoʻohana i ke ʻano /loaa_helu_info, ka mea e hoʻopuka i ka papa inoa o nā kelepona me ka ʻike e pili ana i ka hui kahi i puʻunaue ʻia ai ke kelepona. E noʻonoʻo kākou ua loaʻa i ka helu PBX virtual kahi kelepona mai ka helu 1234567890. A laila e hoʻouna ka PBX i kēia noi:
{
"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":""
}
A laila pono ʻoe e hoʻohui i ka mea lawelawe /loaa_helu_info. Pono e hoʻokō ʻia ke noi i ka wā e hiki mai ai kahi kelepona i ka laina komo ma mua o ka holo ʻana o nā kelepona. Inā ʻaʻole i loaʻa kahi pane i kahi noi i loko o ka manawa i ʻōlelo ʻia, a laila e hoʻokele ʻia ke kelepona e like me nā lula i hoʻokumu ʻia ma ka domain.
ʻO ka laʻana o kahi mea lawelawe ma ka ʻaoʻao 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;
Pane mai ka mea lawelawe.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Mālama mākou i ke kūlana a hoʻoiho i nā leo kelepona
Ma ka PBX virtual o Rostelecom, ua ho'ā 'ia ka ho'opa'a kelepona ma kāu mo'okāki pilikino. Ke hoʻohana nei i ka API, hiki iā ʻoe ke hahai i ke kūlana o kēia hana. I ka hana ʻana i kahi hoʻopau kelepona i loko call_events hiki iā ʻoe ke ʻike i ka hae 'is_record', e hoʻomaopopo i ka mea hoʻohana e pili ana i ke kūlana o ke komo ʻana: oiaio 'o ia ho'i, ua ho'ohana 'ia ka hana ho'opa'a kelepona a ka mea ho'ohana.
No ka hoʻoiho ʻana i kahi hoʻopaʻa leo, pono ʻoe e hoʻohana i ka ID session call session_id hoʻouna i kahi noi i api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ma ka pane ʻana, e loaʻa iā ʻoe kahi loulou no ka hoʻoiho ʻana i kahi faila me ka hoʻopaʻa ʻana o ke kamaʻilio.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Hoʻonohonoho ʻia ka manawa mālama waihona ma kāu mau hoʻonohonoho moʻokāki pilikino. Ma hope e holoi ʻia ka faila.
Heluhelu a me ka hoike
Ma kāu moʻokāki pilikino ma kahi ʻaoʻao ʻokoʻa hiki iā ʻoe ke ʻike i nā helu helu a me ka hōʻike ʻana i nā kelepona āpau a kau i nā kānana ma ke kūlana a me ka manawa. Ma o ka API, pono ʻoe e hana mua i ke kelepona me ke ʻano /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"
}
A laila e kāhea i ke ʻano call_info e hoʻoponopono i ka array a hōʻike i ke kelepona ma ka ʻōnaehana CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
I ka pane ʻana, e loaʻa iā ʻoe kahi ʻikepili i hiki ke hana ʻia e mālama i ka ʻikepili ma ka 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":""
}
}
ʻO nā hiʻohiʻona PBX virtual ʻē aʻe
Ma waho aʻe o ka API, loaʻa i kahi PBX virtual kekahi mau hiʻohiʻona pono e hiki ai iā ʻoe ke hoʻohana. No ka laʻana, he papa kuhikuhi leo pāʻani kēia a me ka hoʻohui ʻana o nā kamaʻilio kelepona a paʻa.
ʻO Interactive Voice Response (IVR) ka mea a mākou e lohe ai ma ka lima lima ma mua o ka pane ʻana o ke kanaka. ʻO ka mea nui, he mea uila uila kēia e hoʻohuli hou i nā kelepona i nā keʻena kūpono a pane maʻalahi i kekahi mau nīnau. ʻAʻole koke e hiki ke hana me IVR ma o ka API: ke kūkulu nei mākou i nā polokalamu e hiki ai iā ʻoe ke nānā i ka holomua o kahi kelepona ma o ka IVR a loaʻa i ka ʻike e pili ana i nā kī kī paʻi i ka wā o ka mea kākau inoa ma ka papa kuhikuhi leo.
No ka hoʻololi ʻana i ke kelepona hui i nā kelepona paʻa lima, hiki iā ʻoe ke hoʻohana i nā polokalamu kelepona paʻakikī a i ʻole e hoʻolaʻa kaʻawale i ka lawelawe Fixed Mobile Convergence (FMC). Me kekahi o nā ʻano, kelepona ʻole i loko o ka pūnaewele, hiki ke hana me nā helu pōkole, a hiki ke hoʻopaʻa ʻia nā kelepona a hiki ke mālama ʻia nā helu helu ma luna o lākou.
ʻO ka ʻokoʻa, pono nā kelepona paʻakikī i ka Pūnaewele e kamaʻilio, akā ʻaʻole naʻe i nakinaki ʻia i kahi mea hoʻohana, ʻoiai ʻo FMC i hoʻopaʻa ʻia i kahi mea hoʻohana kikoʻī, akā hiki ke hoʻohana ʻia ma nā kelepona paʻi pihi kahiko.
Source: www.habr.com