جديد ڪاروبار لينڊ لائن فونز کي هڪ پراڻي ٽيڪنالاجي طور سمجهي ٿو: سيلولر ڪميونيڪيشن متحرڪ ۽ ملازمن جي مسلسل دستيابي کي يقيني بڻائي ٿي، سماجي نيٽ ورڪ ۽ فوري پيغام ڏيندڙ هڪ آسان ۽ تيز مواصلاتي چينل آهن. انهن جي مقابلي ۾ رکڻ لاء، آفيس 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 ڏانهن هڪ درخواست موڪلڻ جي ضرورت آهي /users_info.
{
"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 استعمال ڪندي، توهان هن فنڪشن جي صورتحال کي ٽريڪ ڪري سگهو ٿا. جڏهن پروسيسنگ ۾ ڪال ختم ٿيڻ ڪال_ايونٽس توهان پرچم ڏسي سگهو ٿا 'is_record'، جيڪو صارف کي داخلا جي صورتحال بابت اطلاع ڏئي ٿو: سچ مطلب ته صارف جي ڪال رڪارڊنگ فنڪشن کي فعال ڪيو ويو آهي.
هڪ رڪارڊنگ ڊائون لوڊ ڪرڻ لاء، توهان کي استعمال ڪرڻ جي ضرورت آهي ڪال سيشن ID session_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"
}
ان کان پوء طريقو سڏيو call_info صف کي پروسيس ڪرڻ ۽ 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 وٽ ٻيون به مفيد خاصيتون آهن جيڪي توهان استعمال ڪري سگهو ٿا. مثال طور، هي هڪ انٽرايڪٽو وائس مينيو آهي ۽ سيلولر ۽ فڪسڊ ڪميونيڪيشن جو انضمام.
Interactive Voice Response (IVR) اهو آهي جيڪو اسان هينڊ سيٽ تي ٻڌون ٿا ان کان اڳ جو ماڻهو جواب ڏئي. لازمي طور تي، هي هڪ اليڪٽرڪ آپريٽر آهي جيڪو ڪالز کي مناسب ڊپارٽمنٽ ڏانهن موٽائي ٿو ۽ ڪجهه سوالن جا جواب خودڪار طور تي. جلد ئي IVR سان API ذريعي ڪم ڪرڻ ممڪن ٿيندو: اسان هن وقت سافٽ ويئر ٺاهي رهيا آهيون جيڪو توهان کي اجازت ڏيندو ته توهان IVR ذريعي ڪال جي پيش رفت کي ٽريڪ ڪري سگهو ٿا ۽ ٽچ ٽون ڪي اسٽروڪ بابت معلومات حاصل ڪندا جڏهن سبسڪرائبر وائس مينيو ۾ هوندو.
ڪارپوريٽ ٽيليفوني کي موبائيل فونن تي منتقل ڪرڻ لاءِ، توهان يا ته استعمال ڪري سگهو ٿا سافٽ فون ايپليڪيشنون يا الڳ طور تي فيڪسڊ موبائيل ڪنورجينس (FMC) سروس چالو ڪري سگهو ٿا. ڪنهن به طريقي سان، نيٽ ورڪ اندر ڪالون مفت هونديون آهن، مختصر نمبرن سان ڪم ڪرڻ ممڪن ٿيندو آهي، ۽ ڪالز رڪارڊ ڪري سگھجن ٿيون ۽ انهن تي عام انگ اکر رکي سگهجن ٿا.
فرق اهو آهي ته سافٽ فونز کي رابطي لاءِ انٽرنيٽ جي ضرورت هوندي آهي، پر اهي ڪنهن آپريٽر سان جڙيل نه هوندا آهن، جڏهن ته FMC هڪ مخصوص آپريٽر سان جڙيل هوندو آهي، پر پراڻي پش-بٽن فونن تي به استعمال ڪري سگهجي ٿو.
جو ذريعو: www.habr.com