تعتبر الأعمال الحديثة الهواتف الأرضية بمثابة تقنية قديمة: توفر الاتصالات الخلوية إمكانية التنقل وتوافر مستمر للموظفين ، والشبكات الاجتماعية والرسائل الفورية هي قناة اتصال أسهل وأسرع. من أجل مواكبة منافسيهم ، أصبحت مكاتب PBXs أكثر شبهاً بهم: يذهبون إلى السحب ، وتتم إدارتهم عبر واجهة الويب ويتم دمجهم مع الأنظمة الأخرى من خلال واجهة برمجة التطبيقات. في هذا المنشور ، سنخبرك بالمهام التي تعمل بها Rostelecom الظاهري PBX API وكيفية التعامل معها من خلال الوظائف الأساسية لل PBX الظاهري.
تتمثل المهمة الرئيسية لـ Rostelecom الظاهري PBX API في التفاعل مع CRM أو مواقع الشركة. على سبيل المثال ، تتضمن واجهة برمجة التطبيقات عناصر واجهة المستخدم "معاودة الاتصال" و "الاتصال من الموقع" لأنظمة التحكم الرئيسية: WordPress و Bitrix و OpenCart. تتيح لك واجهة برمجة التطبيقات:
- تلقي المعلومات ، والإبلاغ عن الحالة وإجراء المكالمات بناء على طلب من نظام خارجي ؛
- الحصول على رابط مؤقت لتسجيل المحادثة.
- إدارة وتلقي إعدادات تقييد من المستخدمين.
- الحصول على معلومات حول مستخدم PBX الظاهري ؛
- طلب تاريخ من الرسوم والتكاليف على المكالمات.
- تحميل سجل المكالمات.
كيف يعمل API
تتفاعل واجهة برمجة تطبيقات التكامل والنظام الخارجي مع بعضها البعض باستخدام طلبات HTTP. في حسابك الشخصي ، يقوم المسؤول بتعيين العناوين التي يجب أن تأتي الطلبات إلى واجهة برمجة التطبيقات فيها وأين يجب إرسال الطلبات من واجهة برمجة التطبيقات. يجب أن يكون للنظام الخارجي عنوان عام يمكن الوصول إليه من الإنترنت مع تثبيت شهادة SSL.
أيضًا ، في حسابك الشخصي ، يمكن لمسؤول المجال تقييد مصادر طلبات IP عند الوصول إلى واجهة برمجة التطبيقات.
نحصل على معلومات حول مستخدمي 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":"test_user_1@mail.gov","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":"Ivanov@mail.gov", "distribution":1, "users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^] } ]
في هذه الطريقة ، يتم تمرير صفيفتين. واحد مع مستخدمي المجال ، واحد مع مجموعات المجال. المجموعة لديها أيضا القدرة على تحديد البريد الإلكتروني الذي سيتم إرساله في الطلب.
نحن نعالج المعلومات حول مكالمة واردة
يوفر الاتصال الهاتفي للشركات بأنظمة CRM المختلفة وقت الموظفين الذين يتفاعلون مع العملاء ويسرع معالجة المكالمات الواردة. على سبيل المثال ، في مكالمة من العميل الحالي ، يمكن لـ CRM فتح بطاقته ، ومن CRM ، يمكنك إرسال مكالمة إلى العميل وتوصيلها للموظف.
للحصول على معلومات حول المكالمات من خلال واجهة برمجة التطبيقات ، تحتاج إلى استخدام
/ get_number_info طريقة ، والتي تشكل قائمة من المكالمات مع معلومات حول المجموعة التي وزعت الدعوة. افترض أن مكالمة واردة من الرقم 1234567890 وصلت إلى رقم PBX الظاهري ، ثم سيتم إرسال طلب من 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 ، يتم تنشيط تسجيل المحادثات في حسابك الشخصي. باستخدام API ، يمكنك تتبع حالة هذه الوظيفة. عند معالجة إنهاء المكالمة في
call_events ، يمكنك رؤية علامة
"is_record" ، والتي
تُعلم المستخدم بحالة التسجيل:
true يعني أن المستخدم قد تم
تمكين وظيفة تسجيل المحادثة.
لتنزيل سجل ، يلزمك إرسال طلب إلى
api.cloudpbx.rt.ru/get_record باستخدام معرف جلسة مكالمة
session_id .
{ "session_id":"SDsnZugDFmTW7Sec" }
ستكون الاستجابة ارتباطًا مؤقتًا لتنزيل ملف تسجيل المحادثة.
{ "result": ^_^quot�quot^_^, "resultMessage": " ", "url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036" }
يتم تعيين وقت تخزين الملفات في إعدادات حسابك الشخصي. بعد حذف الملف.
الإحصاءات والتقارير
في حسابك على صفحة منفصلة ، يمكنك مشاهدة الإحصاءات وإعداد التقارير لجميع المكالمات وتطبيق عوامل التصفية حسب الحالة والوقت. من خلال واجهة برمجة التطبيقات ، يجب أولاً معالجة المكالمة باستخدام
/ 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":"admin@example.ru", "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) هي ما نسمعه في جهاز الاستقبال قبل أن يجيب الشخص. في الواقع ، هذا هو المشغل الإلكتروني الذي يعيد توجيه المكالمات إلى الإدارات المناسبة والإجابة على بعض الأسئلة تلقائيا. قريباً ، سيكون من الممكن العمل مع IVR من خلال واجهة برمجة التطبيقات: الآن نقوم بتطوير برنامج يتيح لك تتبع التقدم المحرز في مكالمة من خلال IVR وتلقي المعلومات حول مكابس ضغط المفاتيح عندما يكون المشترك في قائمة الصوت.
لنقل مهاتفة الشركات إلى الهواتف المحمولة ، يمكنك إما استخدام تطبيقات الهاتف الرقمي أو توصيل خدمة التقارب بين الهواتف الثابتة (FMC) بشكل منفصل. باستخدام أي من الطرق ، تكون المكالمات داخل الشبكة مجانية ، ومن الممكن العمل بأرقام قصيرة ، ويمكن تسجيل المكالمات ويمكن الاحتفاظ بالإحصاءات العامة عليها.
الفرق هو أن الهواتف المحمولة تحتاج إلى اتصال بالإنترنت ، لكنها غير مرتبطة بمشغل ، وترتبط FMC بمشغل معين ، ولكن يمكن استخدامها حتى على الهواتف القديمة التي تعمل بضغطة زر.