O pisinisi fa'aonaponei o lo'o va'aia telefoni feavea'i e pei o se tekonolosi tuai: feso'ota'iga feavea'i e fa'amautinoa ai le feoa'i ma le maua pea o tagata faigaluega, feso'ota'iga fa'aagafesootai ma avefe'au vave o se auala fa'afeso'ota'i faigofie ma vave. Ina ia faʻatasi ma a latou tagata tauva, o ofisa PBX ua faʻateleina ma sili atu ona tutusa ma i latou: o loʻo latou agai atu i le ao, faʻatautaia e ala i se upega tafaʻilagi ma tuʻufaʻatasia ma isi faiga e ala i le API. I lenei pou o le a matou taʻu atu ia te oe le mea o loʻo i ai i le Rostelecom virtual PBX API ma pe faʻafefea ona galue ma galuega autu a le virtual PBX e ala i ai.
O le galuega autu a le Rostelecom virtual PBX API o le fegalegaleaiga ma le CRM poʻo le upega tafaʻilagi a le kamupani. Mo se faʻataʻitaʻiga, o le API o loʻo faʻaaogaina le "valaau i tua" ma le "valaau mai le nofoaga" widgets mo faiga faʻatautaia autu: WordPress, Bitrix, OpenCart. E mafai e le API ona:
- Maua faʻamatalaga, logoina tulaga ma faia ni valaʻau pe a talosagaina mai se faiga i fafo;
- Maua se sootaga le tumau e faamaumau ai le talanoaga;
- Puleaina ma maua tapula'a fa'atapula'a mai tagata fa'aoga;
- Maua fa'amatalaga e uiga i le tagata fa'aoga virtual PBX;
- Talosagaina le tala faasolopito o aitalafu ma totogi;
- Tu'u i luga le fa'amaumauga o telefoni.
Auala e galue ai le API
O le API tuʻufaʻatasia ma le faiga i fafo e fegalegaleai ai le tasi ma le isi e faʻaaoga ai talosaga HTTP. I totonu o le tala a le tagata lava ia, e setiina e le pule ia tuatusi e tatau ona taunuu ai talosaga i le API ma mea e tatau ona lafo ai talosaga mai le API. Ole faiga i fafo e tatau ona iai se tuatusi fa'alaua'itele e mafai ona maua mai le Initaneti fa'atasi ai ma se fa'ailoga SSL fa'apipi'i.
I totonu foi o le tala patino, e mafai e le pule o le pule ona faʻatapulaʻaina punaoa o talosaga pe a oʻo i le API e le IP.
Matou te mauaina faʻamatalaga e uiga i tagata faʻaoga PBX virtual
Ina ia maua se lisi o tagata faʻaoga poʻo vaega, e tatau ona e lafoina se talosaga i le virtual PBX e faʻaaoga ai le metotia /users_info.
{
"domain":"example.ru"
}
I le tali atu, o le ae mauaina se lisi e mafai ona e teuina.
{
"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^_^]
}
]
O lenei metotia e faʻaogaina ai laina e lua. Tasi e fa'aoga le vaega, tasi ma vaega fa'alapotopotoga. E maua foi e le vaega le avanoa e faʻamaonia ai se imeli o le a tuʻuina atu i le talosaga.
Fa'agaioiina o fa'amatalaga e uiga i se telefoni sau
O le fa'afeso'ota'i telefoni fa'apisinisi i faiga fa'a-CRM eseese e fa'asaoina ai le taimi mo tagata faigaluega o lo'o fegalegaleai ma tagata fa'atau ma fa'avavevave ai le fa'agaoioiga o telefoni e sau. Mo se faʻataʻitaʻiga, i luga o se telefoni mai se tagata o loʻo iai nei, e mafai e le CRM ona tatala lana kata, ma mai le CRM e mafai ona e lafoina se telefoni i le kalani ma faʻafesoʻotaʻi o ia ma se tagata faigaluega.
Ina ia maua faʻamatalaga e uiga i API telefoni, e tatau ona e faʻaogaina le metotia /get_number_info, lea e gaosia ai se lisi o telefoni ma faʻamatalaga e uiga i le vaega o loʻo tufatufaina i ai le telefoni. Sei o tatou manatu o le numera PBX virtual e maua se telefoni mai le numera 1234567890. Ona auina atu lea e le PBX le talosaga lenei:
{
"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":""
}
O le isi mea e te manaʻomia e faʻafesoʻotaʻi le lima /get_number_info. O le talosaga e tatau ona faʻatinoina pe a oʻo mai se valaau ulufale mai i luga o le laina o loʻo sau aʻo leʻi faʻaogaina telefoni. Afai e le maua se tali i se talosaga i totonu o le taimi faʻapitoa, ona faʻaogaina lea o le valaau e tusa ai ma tulafono faʻavae i totonu o le vaega.
Fa'ata'ita'iga o se fa'ata'ita'i ile itu 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;
Tali mai le pule.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Matou te siaki le tulaga ma la'u mai fa'amaumauga telefoni
I le PBX virtual a Rostelecom, o lo'o fa'agaoioia le pu'eina o le telefoni i lau tala patino. I le faʻaaogaina o le API, e mafai ona e siaki le tulaga o lenei galuega. A'o fa'agaoioia se fa'amuta telefoni i totonu valaau_events e mafai ona e vaʻai i le fuʻa ' is_record', lea e logoina ai le tagata fa'aoga e uiga i le tulaga o le tusi: moni o lona uiga ua mafai le galuega a le tagata fa'aoga e pu'eina.
Ina ia sii maia se lipine, e mana'omia lou fa'aogaina o le ID sauniga vala'au session_id lafo se talosaga i api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
I le tali atu, o le ae mauaina se fesoʻotaʻiga le tumau e sii mai ai se faila ma se faʻamaumauga o le talanoaga.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
O le taimi e teu ai faila o lo'o fa'atulaga i au fa'amaumauga patino. Mulimuli ane o le a tape le faila.
Fuainumera ma lipoti
I lau faʻamatalaga patino i luga o se isi itulau e mafai ona e vaʻai i fuainumera ma lipoti i luga o telefoni uma ma faʻaoga filiga i tulaga ma taimi. E ala i le API, e tatau ona e faʻagasolo muamua le telefoni ma le metotia /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"
}
Ona valaau lea o le metotia call_info e faʻagasolo le laina ma faʻaalia le valaau i le CRM system.
{
"session_id":"SDsnZugDFmTW7Sec"
}
I le tali atu, o le ae mauaina se faʻasologa o faʻamaumauga e mafai ona faʻatautaia e teu ai faʻamatalaga i le 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":""
}
}
O isi mea aoga fa'apitoa PBX
E ese mai i le API, o le virtual PBX e tele isi mea aoga e mafai ona e faʻaogaina. Mo se faʻataʻitaʻiga, o se lisi leo felagolagomai ma le tuʻufaʻatasia o fesoʻotaʻiga feaveaʻi ma fesoʻotaʻiga tumau.
Interactive Voice Response (IVR) o le mea lea tatou te fa'alogoina i le telefoni a'o le'i tali mai le tagata. O le mea moni, o se fa'aeletoroni fa'aeletonika e toe fa'afeiloa'i telefoni i matagaluega talafeagai ma tali otometi nisi o fesili. E le o toe mamao ae mafai ona galulue faatasi ma le IVR e ala i le API: o loʻo matou atinaʻe nei polokalama e mafai ai ona e siaki le alualu i luma o se telefoni e ala i le IVR ma maua faʻamatalaga e uiga i paʻu paʻu leo pe a iai le tagata fai saofaga i le lisi leo.
Ina ia fesiita'i telefoni fe'avea'i i telefoni fe'avea'i, e mafai ona e fa'aogaina telefoni feavea'i pe fa'agaoioi ese le auaunaga Fixed Mobile Convergence (FMC). Faatasi ai ma soʻo se auala, o telefoni i totonu o le upega tafaʻilagi e leai se totogi, e mafai ona galue i numera pupuu, ma e mafai ona faʻamaumau telefoni ma faʻamaumau faʻamaumauga lautele.
O le eseesega o telefoni feaveai e manaʻomia le Initaneti e fesoʻotaʻi ai, ae e le o noatia i se tagata faʻatautaia, ae o le FMC o loʻo nonoa i se tagata faʻapitoa, ae mafai ona faʻaoga e oʻo lava i telefoni tuai.
puna: www.habr.com