Karsaziya nûjen têlefonên xênî wekî teknolojiyek kevnar dihesibîne: ragihandina hucreyî tevger û hebûna domdar a karmendan misoger dike, torên civakî û peyamberên tavilê kanalek ragihandinê ya hêsantir û bilez in. Ji bo ku bi hevrikên xwe re bimeşin, PBX-yên ofîsê her ku diçe dişibin wan: ew ber bi ewr ve diçin, bi navgînek webê ve têne rêve kirin û bi pergalên din re bi API-ê ve têne yek kirin. Di vê postê de em ê ji we re vebêjin ka çi fonksiyonên Rostelecom PBX virtual API heye û meriv çawa bi fonksiyonên sereke yên PBX-ya virtual bi navgîniya wê re dixebite.
Karê sereke ya Rostelecom virtual PBX API danûstendina bi CRM an malperên pargîdanî re ye. Mînakî, API ji bo pergalên rêveberiya sereke: WordPress, Bitrix, OpenCart widgetên "paşvegera bangê" û "banga ji malperê" bicîh tîne. API destûrê dide:
- Agahdariyê bistînin, statûyê agahdar bikin û li ser daxwazek ji pergalek derveyî bang bikin;
- Ji bo tomarkirina axaftinê girêdanek demkî bistînin;
- Rêvekirin û wergirtina pîvanên sînorkirinê ji bikarhêneran;
- Agahdariyê li ser bikarhênerê PBX-a virtual bistînin;
- Dîroka debît û xercên bangê daxwaz bikin;
- Têketinê banga barkirin.
API çawa dixebite
API-ya entegrasyonê û pergala derveyî bi karanîna daxwazên HTTP bi hevûdu re têkilî daynin. Di hesabê kesane de, rêveber navnîşanên ku divê daxwazên API-ê werin û li ku derê daxwazên API-ê bêne şandin destnîşan dike. Pêdivî ye ku pergala derveyî navnîşek gelemperî hebe ku ji Înternetê bi sertîfîkaya SSL-ya sazkirî ve tê gihîştin.
Di heman demê de di hesabê kesane de, rêvebirê domainê dema ku bi IP-ê bigihîje API-ê dikare çavkaniyên daxwazan sînordar bike.
Em di derbarê bikarhênerên PBX yên virtual de agahdarî digirin
Ji bo ku hûn navnîşek bikarhêner an koman bistînin, hûn hewce ne ku bi rêbazê daxwazek ji PBX-a virtual re bişînin /users_info.
{
"domain":"example.ru"
}
Di bersivê de, hûn ê navnîşek ku hûn dikarin hilînin bistînin.
{
"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^_^]
}
]
Ev rêbaz du rêzan derbas dike. Yek bi bikarhênerên domainê re, yek bi komên domainê. Kom di heman demê de derfet heye ku e-nameyek ku dê di daxwaznameyê de were şandin diyar bike.
Pêvajoya agahdariya li ser bangek hatî
Girêdana têlefoniya pargîdanî bi pergalên cihêreng ên CRM-ê re dem ji bo karmendên ku bi xerîdaran re têkilî daynin xilas dike û pêvajoya bangên hatine bileztir dike. Mînakî, li ser bangek ji xerîdarek heyî, CRM dikare qerta xwe veke, û ji CRM hûn dikarin bangek ji xerîdar re bişînin û wî bi karmendek ve girêdin.
Ji bo agahdariya li ser bangên API-ê bistînin, hûn hewce ne ku rêbazê bikar bînin /get_number_info, ku navnîşek bangan bi agahdariya li ser koma ku bang lê tê belavkirin çêdike. Ka em bihesibînin ku jimara PBX-a virtual ji jimareya 1234567890 bangek werdigire. Dûv re PBX dê daxwaza jêrîn bişîne:
{
"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":""
}
Dûv re hûn hewce ne ku hilberê ve girêbidin /get_number_info. Pêdivî ye ku daxwaz were cîbicîkirin dema ku bangek gihîştî tê ser xeta hatî berî ku bang werin rêkirin. Ger bersivek daxwazek di dema diyarkirî de neyê wergirtin, wê hingê bang li gorî rêgezên ku di domainê de hatine destnîşankirin têne rêve kirin.
Mînaka rêvekerek li ser milê 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;
Bersiva ji handler.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Em rewşê dişopînin û tomarên bangê dakêşin
Di PBX-a virtual ya Rostelecom de, tomarkirina bangê di hesabê weya kesane de tê çalak kirin. Bi karanîna API-ê, hûn dikarin rewşa vê fonksiyonê bişopînin. Dema ku tê de qutkirina bangekê tête kirin call_events hûn dikarin ala bibînin 'is_record', ku bikarhêner li ser rewşa têketinê agahdar dike: rast tê wê wateyê ku fonksiyona tomarkirina banga bikarhêner çalak e.
Ji bo dakêşandina tomarek, hûn hewce ne ku nasnameya danişîna bangê bikar bînin session_id daxwazek bişînin api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Di bersivê de, hûn ê girêdanek demkî bistînin da ku pelek bi tomarek danûstendinê dakêşin.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Dema hilanîna pelê di mîhengên hesabê weya kesane de tê danîn. Piştre pel dê were jêbirin.
Statîstîk û rapor
Di hesabê xweya kesane de li ser rûpelek cûda hûn dikarin statîstîk û raporên li ser hemî bangan bibînin û li gorî rewş û demê fîlteran bicîh bikin. Bi API-ê, divê hûn pêşî bangê bi rêbazê pêvajoyê bikin /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"
}
Piştre rêbazê bang bikin call_info da ku array pêvajoyê bikin û bangê di pergala CRM de nîşan bidin.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Di bersivê de, hûn ê komek daneyan bistînin ku dikarin werin hilanîn da ku daneyan di têketina CRM de hilînin.
{
"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":""
}
}
Taybetmendiyên din ên kêrhatî yên virtual PBX
Ji bilî API-ê, PBX-ya virtual çend taybetmendiyên din ên bikêr hene ku hûn dikarin bikar bînin. Mînakî, ev pêşekek dengek înteraktîf e û yekbûna danûstendinên hucreyî û sabît e.
Bersiva Dengê Interaktîf (IVR) tiştê ku em li ser têlefonê dibihîzin berî ku mirov bersivê bide ye. Di bingeh de, ev operatorek elektronîkî ye ku bang li dezgehên guncav beralî dike û bixweber bersiva hin pirsan dide. Di nêzîk de dê gengaz be ku bi IVR-ê re bi API-yê re bixebitin: em niha nermalava pêşdebir dikin ku dê bihêle hûn pêşkeftina bangekê bi IVR-ê bişopînin û dema ku abonet di menuya deng de ye agahdariya li ser lêdanên bişkojka bi deng-tonê bistînin.
Ji bo veguheztina têlefoniya pargîdanî li têlefonên desta, hûn dikarin serîlêdanên têlefonê nerm bikar bînin an jî karûbarê Hevgirtina Mobîl a Rastkirî (FMC) veqetandî çalak bikin. Bi her rêbazî re, bangên di nav torê de belaş in, bi hejmarên kurt re xebitîn gengaz dibe, û bang têne tomar kirin û statîstîkên gelemperî li ser wan têne girtin.
Cûdahî ev e ku têlefonên nerm ji bo danûstendinê hewcedarê Înternetê ne, lê ew ne bi operatorek ve girêdayî ne, dema ku FMC bi operatorek taybetî ve girêdayî ye, lê dikare li ser têlefonên bişkojk ên kevn jî were bikar anîn.
Source: www.habr.com