Iṣowo ode oni ṣe akiyesi awọn foonu ti ilẹ bi imọ-ẹrọ ti igba atijọ: awọn ibaraẹnisọrọ cellular ṣe idaniloju iṣipopada ati wiwa igbagbogbo ti awọn oṣiṣẹ, awọn nẹtiwọọki awujọ ati awọn ojiṣẹ lojukanna jẹ ọna asopọ ibaraẹnisọrọ rọrun ati yiyara. Lati tọju awọn oludije wọn, awọn PBXs ọfiisi n di diẹ sii ati siwaju sii si wọn: wọn nlọ si awọsanma, ti iṣakoso nipasẹ wiwo wẹẹbu kan ati ki o ṣepọ pẹlu awọn ọna ṣiṣe miiran nipasẹ API. Ninu ifiweranṣẹ yii a yoo sọ fun ọ kini awọn iṣẹ ti Rostelecom foju PBX API ni ati bii o ṣe le ṣiṣẹ pẹlu awọn iṣẹ akọkọ ti PBX foju nipasẹ rẹ.
Iṣẹ akọkọ ti Rostelecom foju PBX API jẹ ibaraenisepo pẹlu CRM tabi awọn oju opo wẹẹbu ile-iṣẹ. Fun apẹẹrẹ, API n ṣe “ipe pada” ati “ipe lati aaye” awọn ẹrọ ailorukọ fun awọn eto iṣakoso akọkọ: Wodupiresi, Bitrix, OpenCart. API gba laaye:
- Gba alaye, leti ipo ati ṣe awọn ipe lori ibeere lati eto ita;
- Gba ọna asopọ igba diẹ lati ṣe igbasilẹ ibaraẹnisọrọ naa;
- Ṣakoso ati gba awọn paramita ihamọ lati ọdọ awọn olumulo;
- Gba alaye nipa olumulo PBX foju;
- Beere itan-akọọlẹ ti awọn sisanwo ipe ati awọn idiyele;
- Po si ipe log.
Bawo ni API ṣiṣẹ
API isọpọ ati eto itagbangba ṣe ajọṣepọ pẹlu ara wọn nipa lilo awọn ibeere HTTP. Ninu akọọlẹ ti ara ẹni, oluṣakoso ṣeto awọn adirẹsi nibiti awọn ibeere si API yẹ ki o de ati nibiti awọn ibeere lati API yẹ ki o firanṣẹ. Eto ita gbọdọ ni adirẹsi gbogbo eniyan ti o wa lati Intanẹẹti pẹlu ijẹrisi SSL ti o fi sii.
Paapaa ninu akọọlẹ ti ara ẹni, oluṣakoso agbegbe le ṣe opin awọn orisun ti awọn ibeere nigbati o wọle si API nipasẹ IP.
A gba alaye nipa awọn olumulo PBX foju
Lati gba atokọ ti awọn olumulo tabi awọn ẹgbẹ, o nilo lati fi ibeere ranṣẹ si PBX foju ni lilo ọna naa /users_info.
{
"domain":"example.ru"
}
Ni idahun, iwọ yoo gba atokọ ti o le fipamọ.
{
"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^_^]
}
]
Ọna yii kọja awọn ọna meji. Ọkan pẹlu awọn olumulo agbegbe, ọkan pẹlu awọn ẹgbẹ agbegbe. Ẹgbẹ naa tun ni aye lati pato imeeli ti yoo firanṣẹ ni ibeere naa.
Alaye ilana nipa ipe ti nwọle
Sisopọ tẹlifoonu ajọ si ọpọlọpọ awọn ọna ṣiṣe CRM ṣafipamọ akoko fun awọn oṣiṣẹ ti o ṣe ajọṣepọ pẹlu awọn alabara ati yiyara sisẹ awọn ipe ti nwọle. Fun apẹẹrẹ, lori ipe lati ọdọ alabara lọwọlọwọ, CRM le ṣii kaadi rẹ, ati lati CRM o le fi ipe ranṣẹ si alabara ki o so rẹ pọ pẹlu oṣiṣẹ kan.
Lati gba alaye nipa awọn ipe API, o nilo lati lo ọna naa /gba_number_info, eyiti o ṣe agbejade atokọ ti awọn ipe pẹlu alaye nipa ẹgbẹ ti ipe ti pin si. Jẹ ki a ro pe nọmba PBX foju gba ipe ti nwọle lati nọmba 1234567890. Lẹhinna PBX yoo firanṣẹ ibeere atẹle:
{
"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":""
}
Nigbamii o nilo lati so oluṣakoso naa pọ /gba_number_info. Ibeere naa gbọdọ wa ni ṣiṣe nigbati ipe ti nwọle ba de lori laini ti nwọle ṣaaju ki awọn ipe ti wa ni ipalọlọ. Ti idahun si ibeere ko ba gba laarin akoko ti a ti sọ tẹlẹ, lẹhinna ipe naa jẹ ipalọlọ ni ibamu si awọn ofin ti iṣeto ni agbegbe naa.
Apeere ti olutọju kan ni ẹgbẹ 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;
Idahun lati ọdọ olutọju.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
A tọpinpin ipo naa ati ṣe igbasilẹ awọn gbigbasilẹ ipe
Ninu PBX foju Rostelecom, gbigbasilẹ ipe ti mu ṣiṣẹ ninu akọọlẹ ti ara ẹni. Lilo API, o le tọpa ipo iṣẹ yii. Nigbati o ba n ṣiṣẹ ifopinsi ipe kan wọle ipe_iṣẹlẹ o le wo asia 'jẹ_igbasilẹ', eyiti o sọ fun olumulo nipa ipo titẹ sii: otitọ tumọ si pe iṣẹ gbigbasilẹ ipe olumulo ti ṣiṣẹ.
Lati ṣe igbasilẹ igbasilẹ, o nilo lati lo ID igba ipe igba_id fi ìbéèrè si api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ni idahun, iwọ yoo gba ọna asopọ igba diẹ lati ṣe igbasilẹ faili kan pẹlu gbigbasilẹ ti ibaraẹnisọrọ naa.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Akoko ipamọ faili ti ṣeto ni awọn eto akọọlẹ ti ara ẹni. Lẹhinna faili yoo paarẹ.
Awọn iṣiro ati iroyin
Ninu akọọlẹ ti ara ẹni ni oju-iwe ọtọtọ o le wo awọn iṣiro ati ijabọ lori gbogbo awọn ipe ati lo awọn asẹ nipasẹ ipo ati akoko. Nipasẹ API, o gbọdọ kọkọ ṣe ilana ipe pẹlu ọna naa / ipe_iṣẹlẹ:
{
"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"
}
Lẹhinna pe ọna naa ipe_info lati ṣe ilana titobi ati ṣafihan ipe ninu eto CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Ni idahun, iwọ yoo gba ọpọlọpọ data ti o le ṣe ilana lati tọju data sinu akọọlẹ 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":""
}
}
Miiran wulo foju PBX awọn ẹya ara ẹrọ
Yato si API, PBX foju kan ni ọpọlọpọ awọn ẹya iwulo miiran ti o le lo. Fun apẹẹrẹ, eyi jẹ akojọ aṣayan ohun ibanisọrọ ati isọpọ ti cellular ati awọn ibaraẹnisọrọ ti o wa titi.
Idahun Ohun Ibanisọrọ (IVR) jẹ ohun ti a gbọ lori foonu ṣaaju ki eniyan to dahun. Ni pataki, eyi jẹ oniṣẹ ẹrọ itanna kan ti o ṣe atunṣe awọn ipe si awọn apa ti o yẹ ati dahun awọn ibeere kan laifọwọyi. Laipẹ o yoo ṣee ṣe lati ṣiṣẹ pẹlu IVR nipasẹ API: a n ṣe idagbasoke sọfitiwia lọwọlọwọ ti yoo gba ọ laaye lati tọpinpin ilọsiwaju ti ipe nipasẹ IVR ati gba alaye nipa awọn bọtini bọtini ohun orin ifọwọkan nigbati alabapin ba wa ninu akojọ ohun.
Lati gbe tẹlifoonu ile-iṣẹ lọ si awọn foonu alagbeka, o le lo awọn ohun elo foonu alagbeka tabi muuṣiṣẹ lọtọ iṣẹ Fixed Mobile Convergence (FMC). Pẹlu eyikeyi awọn ọna, awọn ipe laarin nẹtiwọọki jẹ ọfẹ, o ṣee ṣe lati ṣiṣẹ pẹlu awọn nọmba kukuru, ati pe awọn ipe le ṣe igbasilẹ ati awọn iṣiro gbogbogbo le wa ni ipamọ lori wọn.
Iyatọ naa ni pe awọn foonu alagbeka nilo Intanẹẹti lati ṣe ibaraẹnisọrọ, ṣugbọn wọn ko so mọ oniṣẹ ẹrọ, lakoko ti FMC ti so mọ oniṣẹ kan pato, ṣugbọn o le ṣee lo paapaa lori awọn foonu titari-bọtini atijọ.
orisun: www.habr.com