عصري سوداګرۍ د ځمکې لاین تلیفونونه د پخوانۍ ټیکنالوژۍ په توګه پیژني: ګرځنده مخابرات د کارمندانو حرکت او دوامداره شتون تضمینوي ، ټولنیز شبکې او فوري میسنجرونه یو اسانه او ګړندی مخابراتي چینل دی. د خپلو سیالانو سره د ساتلو لپاره، د دفتر PBXs ورځ تر بلې ورته ورته کیږي: دوی کلاوډ ته ځي، د ویب انٹرفیس له لارې اداره کیږي او د API له لارې د نورو سیسټمونو سره مدغم کیږي. پدې پوسټ کې به موږ تاسو ته ووایو چې د Rostelecom مجازی PBX API کومې دندې لري او د دې له لارې د مجازی PBX اصلي دندو سره څنګه کار کول.
د Rostelecom مجازی PBX API اصلي دنده د CRM یا شرکت ویب پاڼو سره تعامل دی. د مثال په توګه، API د اصلي مدیریت سیسټمونو لپاره "بېرته زنګ وهي" او "له سایټ څخه زنګ وهي" ویجټونه پلي کوي: WordPress، Bitrix، OpenCart. API اجازه ورکوي:
- معلومات ترلاسه کړئ، وضعیت خبر کړئ او د بهرني سیسټم څخه غوښتنې ته زنګ ووهئ؛
- د خبرو اترو ثبتولو لپاره لنډمهاله لینک ترلاسه کړئ؛
- د کاروونکو څخه د محدودیت پیرامیټونه اداره او ترلاسه کول؛
- د مجازی PBX کارونکي په اړه معلومات ترلاسه کړئ؛
- د کال ډیبیټ او لګښتونو تاریخ غوښتنه وکړئ؛
- د کال لاګ پورته کړئ.
API څنګه کار کوي
د ادغام API او بهرنی سیسټم د HTTP غوښتنو په کارولو سره یو له بل سره اړیکه لري. په شخصي حساب کې، مدیر هغه پتې ټاکي چیرې چې API ته غوښتنې باید راشي او چیرې چې د API څخه غوښتنې باید واستول شي. بهرنی سیسټم باید یو عامه پته ولري چې د انټرنیټ څخه د نصب شوي SSL سند سره د لاسرسي وړ وي.
همدارنګه په شخصي حساب کې، د ډومین مدیر کولی شي د غوښتنې سرچینې محدود کړي کله چې د IP لخوا API ته لاسرسی ومومي.
موږ د مجازی PBX کاروونکو په اړه معلومات ترلاسه کوو
د کاروونکو یا ډلو لیست ترلاسه کولو لپاره ، تاسو اړتیا لرئ د میتود په کارولو سره مجازی PBX ته غوښتنه واستوئ د کاروونکو_معلومات.
{
"domain":"example.ru"
}
په ځواب کې، تاسو به یو لیست ترلاسه کړئ چې تاسو یې خوندي کولی شئ.
{
"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^_^]
}
]
دا طریقه دوه صفونه تیریږي. یو د ډومین کاروونکو سره، یو د ډومین ګروپونو سره. ګروپ هم فرصت لري چې یو بریښنالیک مشخص کړي چې په غوښتنه کې به لیږل کیږي.
د راتلونکي کال په اړه د معلوماتو پروسس کول
د مختلف CRM سیسټمونو سره د کارپوریټ تلیفوني نښلول د کارمندانو لپاره وخت خوندي کوي څوک چې د پیرودونکو سره اړیکه نیسي او د راتلونکو تلیفونونو پروسس ګړندی کوي. د مثال په توګه، د اوسني پیرودونکي په تلیفون کې، CRM کولی شي خپل کارت خلاص کړي، او د CRM څخه تاسو کولی شئ پیرودونکي ته زنګ ووهئ او هغه د یو کارمند سره وصل کړئ.
د API کالونو په اړه د معلوماتو ترلاسه کولو لپاره، تاسو اړتیا لرئ چې طریقه وکاروئ / get_number_info، کوم چې د هغه ګروپ په اړه معلوماتو سره د تلیفونونو لیست رامینځته کوي چې تلیفون توزیع شوی. راځئ فرض کړو چې د PBX مجازی شمیره د 1234567890 شمیرې څخه راتلونکی کال ترلاسه کوي. بیا به PBX لاندې غوښتنه واستوي:
{
"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":""
}
بیا تاسو اړتیا لرئ چې هینډلر وصل کړئ / get_number_info. غوښتنه باید هغه وخت اجرا شي کله چې د زنګ وهلو څخه دمخه په راتلونکی کرښه کې راتلونکی کال راشي. که چیرې غوښتنې ته ځواب په ټاکل شوي وخت کې ترلاسه نشي ، نو تلیفون په ډومین کې رامینځته شوي مقرراتو سره سم پرمخ وړل کیږي.
د 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;
د سمبالونکي څخه ځواب.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
موږ وضعیت تعقیب کوو او د تلیفون ریکارډونه ډاونلوډ کوو
د Rostelecom په مجازی PBX کې، د تلیفون ثبت کول ستاسو په شخصي حساب کې فعال شوي. د API په کارولو سره، تاسو کولی شئ د دې فعالیت حالت تعقیب کړئ. کله چې د تلیفون پای ته رسیدو پروسس کول call_events تاسو کولی شئ بیرغ وګورئ 'is_record', کوم چې کارونکي ته د ننوتلو حالت په اړه خبر ورکوي: رښتيا پدې معنی چې د کارونکي تلیفون ثبتولو فعالیت فعال شوی.
د ثبت کولو ډاونلوډ کولو لپاره ، تاسو اړتیا لرئ د کال سیشن ID وکاروئ ناسته_id ته غوښتنه واستوئ api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
په ځواب کې، تاسو به د خبرو اترو ثبتولو سره د فایل ډاونلوډ کولو لپاره لنډمهاله لینک ترلاسه کړئ.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
د فایل ذخیره کولو وخت ستاسو د شخصي حساب تنظیماتو کې تنظیم شوی. وروسته به فایل حذف شي.
احصایې او راپور ورکول
ستاسو په شخصي حساب کې په جلا پاڼه کې تاسو کولی شئ احصایې وګورئ او په ټولو تلیفونونو کې راپور ورکړئ او د وضعیت او وخت له مخې فلټرونه پلي کړئ. د API له لارې، تاسو باید لومړی د طریقې سره تلیفون پروسس کړئ /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"
}
بیا میتود ته زنګ ووهئ کال_معلومات د صف پروسس کولو لپاره او د CRM سیسټم کې زنګ ښکاره کړئ.
{
"session_id":"SDsnZugDFmTW7Sec"
}
په ځواب کې، تاسو به د ډیټا یو لړ ترلاسه کړئ چې د 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":""
}
}
نور ګټور مجازی PBX ځانګړتیاوې
د API سربیره، یو مجازی PBX ډیری نورې ګټورې ځانګړتیاوې لري چې تاسو یې کارولی شئ. د مثال په توګه، دا یو متقابل غږ مینو او د سیلولر او ثابت اړیکو ادغام دی.
د متقابل غږ ځواب (IVR) هغه څه دي چې موږ یې په هینډسیټ کې اورو مخکې له دې چې سړی ځواب ورکړي. په لازمي ډول ، دا یو بریښنایی آپریټر دی چې مناسبو څانګو ته تلیفونونه لیږلي او ځینې پوښتنې په اوتومات ډول ځوابوي. ډیر ژر به د API له لارې د IVR سره کار کول ممکن وي: موږ اوس مهال داسې سافټویر رامینځته کوو چې تاسو ته به اجازه درکړي د IVR له لارې د تلیفون پرمختګ تعقیب کړئ او د ټچ ټون کیسټروک په اړه معلومات ترلاسه کړئ کله چې پیرودونکي د غږ مینو کې وي.
ګرځنده تلیفونونو ته د کارپوریټ ټیلیفونونو لیږدولو لپاره، تاسو کولی شئ د سافټ فون غوښتنلیکونه وکاروئ یا په جلا توګه د فکسډ ګرځنده کنورژن (FMC) خدمت فعال کړئ. د هرې طریقې سره، په شبکه کې تلیفونونه وړیا دي، دا ممکنه ده چې د لنډو شمیرو سره کار وکړي، او تلیفونونه ثبت کیدی شي او عمومي احصایې ساتل کیدی شي.
توپیر دا دی چې سافټفونونه د خبرو اترو لپاره انټرنیټ ته اړتیا لري، مګر دوی په یو آپریټر پورې تړلي ندي، پداسې حال کې چې FMC په یو ځانګړي آپریټر پورې تړلی دی، مګر حتی په زاړه پش بټن تلیفونونو کې کارول کیدی شي.
سرچینه: www.habr.com