جدید کاروبار لینڈ لائن فونز کو ایک پرانی ٹیکنالوجی کے طور پر سمجھتا ہے: سیلولر کمیونیکیشن ملازمین کی نقل و حرکت اور مستقل دستیابی کو یقینی بناتی ہے، سوشل نیٹ ورکس اور فوری میسنجر ایک آسان اور تیز تر مواصلاتی چینل ہیں۔ اپنے حریفوں کے ساتھ رہنے کے لیے، آفس PBXs ان سے زیادہ سے زیادہ ملتے جلتے ہوتے جا رہے ہیں: وہ کلاؤڈ پر جا رہے ہیں، ایک ویب انٹرفیس کے ذریعے منظم اور API کے ذریعے دوسرے سسٹمز کے ساتھ مربوط ہیں۔ اس پوسٹ میں ہم آپ کو بتائیں گے کہ Rostelecom ورچوئل PBX API کے کیا فنکشنز ہیں اور اس کے ذریعے ورچوئل PBX کے اہم فنکشنز کے ساتھ کیسے کام کرنا ہے۔
Rostelecom ورچوئل PBX API کا بنیادی کام CRM یا کمپنی کی ویب سائٹس کے ساتھ تعامل ہے۔ مثال کے طور پر، API مین مینیجمنٹ سسٹمز کے لیے "کال بیک" اور "سائٹ سے کال" ویجیٹس کو لاگو کرتا ہے: WordPress، Bitrix، OpenCart۔ API اجازت دیتا ہے:
- معلومات حاصل کریں، اسٹیٹس کو مطلع کریں اور بیرونی سسٹم سے درخواست کرنے پر کال کریں؛
- گفتگو کو ریکارڈ کرنے کے لیے ایک عارضی لنک حاصل کریں۔
- صارفین سے پابندی کے پیرامیٹرز کا نظم کریں اور وصول کریں۔
- ورچوئل پی بی ایکس صارف کے بارے میں معلومات حاصل کریں۔
- کال ڈیبٹ اور چارجز کی تاریخ کی درخواست کریں۔
- کال لاگ اپ لوڈ کریں۔
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، جو اس گروپ کے بارے میں معلومات کے ساتھ کالوں کی ایک فہرست تیار کرتا ہے جس میں کال تقسیم کی جاتی ہے۔ آئیے فرض کریں کہ ورچوئل پی بی ایکس نمبر کو 1234567890 نمبر سے آنے والی کال موصول ہوتی ہے۔ پھر پی بی ایکس درج ذیل درخواست بھیجے گا:
{
"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 استعمال کرنے کی ضرورت ہے۔ سیشن_ آئی ڈی کو ایک درخواست بھیجیں۔ 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 کے ذریعے، آپ کو پہلے طریقہ کے ساتھ کال پر کارروائی کرنی ہوگی۔ /کال_ایونٹس:
{
"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 کے علاوہ، ورچوئل پی بی ایکس میں کئی دوسری مفید خصوصیات ہیں جو آپ استعمال کر سکتے ہیں۔ مثال کے طور پر، یہ ایک انٹرایکٹو وائس مینو اور سیلولر اور فکسڈ کمیونیکیشنز کا انضمام ہے۔
انٹرایکٹو وائس رسپانس (IVR) وہ ہے جو ہم ہینڈ سیٹ پر شخص کے جواب دینے سے پہلے سنتے ہیں۔ بنیادی طور پر، یہ ایک الیکٹرانک آپریٹر ہے جو مناسب محکموں کو کالوں کو ری ڈائریکٹ کرتا ہے اور کچھ سوالات کا خود بخود جواب دیتا ہے۔ جلد ہی API کے ذریعے IVR کے ساتھ کام کرنا ممکن ہو جائے گا: ہم فی الحال ایسا سافٹ ویئر تیار کر رہے ہیں جو آپ کو IVR کے ذریعے کال کی پیشرفت کو ٹریک کرنے اور سبسکرائبر کے وائس مینو میں ہونے پر ٹچ ٹون کی اسٹروک کے بارے میں معلومات حاصل کرنے کی اجازت دے گا۔
کارپوریٹ ٹیلی فونی کو موبائل فون پر منتقل کرنے کے لیے، آپ یا تو سافٹ فون ایپلی کیشنز استعمال کر سکتے ہیں یا الگ سے فکسڈ موبائل کنورجینس (FMC) سروس کو چالو کر سکتے ہیں۔ کسی بھی طریقے سے، نیٹ ورک کے اندر کالز مفت ہیں، مختصر نمبروں کے ساتھ کام کرنا ممکن ہو جاتا ہے، اور کالز ریکارڈ کی جا سکتی ہیں اور ان پر عمومی اعدادوشمار رکھے جا سکتے ہیں۔
فرق یہ ہے کہ سافٹ فونز کو بات چیت کے لیے انٹرنیٹ کی ضرورت ہوتی ہے، لیکن وہ آپریٹر سے منسلک نہیں ہوتے، جب کہ FMC ایک مخصوص آپریٹر سے منسلک ہوتا ہے، لیکن پرانے پش بٹن فونز پر بھی استعمال کیا جا سکتا ہے۔
ماخذ: www.habr.com