🥇 PBX مجازی Rostelecom: چه کاری و چگونه می توان از طریق API انجام داد

تجارت مدرن تلفن های ثابت را به عنوان یک فناوری منسوخ درک می کند: ارتباطات سلولی تحرک و در دسترس بودن مداوم کارمندان را تضمین می کند، شبکه های اجتماعی و پیام رسان های فوری کانال ارتباطی آسان تر و سریع تر هستند. سانترال های اداری برای عقب نماندن از رقبای خود، شباهت بیشتری به آنها پیدا می کنند: آنها به سمت ابر حرکت می کنند، از طریق یک رابط وب مدیریت می شوند و از طریق API با سیستم های دیگر یکپارچه می شوند. در این پست به شما خواهیم گفت که API مجازی سانترال Rostelecom چه کارایی دارد و چگونه از طریق آن با عملکردهای اصلی سانترال مجازی کار کنید.

وظیفه اصلی API PBX مجازی Rostelecom تعامل با CRM یا وب سایت های شرکت است. به عنوان مثال، API ویجت‌های «بازگشت تماس» و «تماس از سایت» را برای سیستم‌های مدیریت اصلی پیاده‌سازی می‌کند: WordPress، Bitrix، OpenCart. API اجازه می دهد:

دریافت اطلاعات، اطلاع از وضعیت و برقراری تماس در صورت درخواست از یک سیستم خارجی؛
دریافت یک پیوند موقت برای ضبط مکالمه؛
مدیریت و دریافت پارامترهای محدودیت از کاربران؛
کسب اطلاعات در مورد کاربر مجازی PBX.
تاریخچه بدهی ها و هزینه های تماس را درخواست کنید.
گزارش تماس را بارگذاری کنید.

نحوه عملکرد API

API یکپارچه سازی و سیستم خارجی با استفاده از درخواست های HTTP با یکدیگر تعامل دارند. در حساب شخصی، مدیر آدرس‌هایی را تعیین می‌کند که در آن درخواست‌ها به API باید ارسال شوند و درخواست‌های API باید در کجا ارسال شوند. سیستم خارجی باید دارای آدرس عمومی قابل دسترسی از اینترنت با گواهی SSL نصب شده باشد.

همچنین در حساب شخصی، مدیر دامنه می تواند منابع درخواست ها را هنگام دسترسی به API توسط IP محدود کند.

ما اطلاعاتی در مورد کاربران مجازی 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، ضبط تماس در حساب شخصی شما فعال می شود. با استفاده از API می توانید وضعیت این تابع را ردیابی کنید. هنگام پردازش یک پایان تماس در call_events می توانید پرچم را ببینید 'is_record'، که کاربر را از وضعیت ورودی مطلع می کند: درست به این معنی است که عملکرد ضبط تماس کاربر فعال است.

برای دانلود فایل ضبط شده، باید از شناسه جلسه تماس استفاده کنید شناسه جلسه ارسال درخواست به 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 مجازی دارای چندین ویژگی مفید دیگر است که می توانید از آنها استفاده کنید. به عنوان مثال، این یک منوی صوتی تعاملی و ادغام ارتباطات سلولی و ثابت است.

پاسخ صوتی تعاملی (IVR) چیزی است که قبل از پاسخ دادن شخص در گوشی می شنویم. در اصل، این یک اپراتور الکترونیکی است که تماس ها را به بخش های مربوطه هدایت می کند و به برخی از سوالات به طور خودکار پاسخ می دهد. به زودی کار با تلفن گویا از طریق API امکان پذیر خواهد بود: ما در حال حاضر در حال توسعه نرم افزاری هستیم که به شما امکان می دهد پیشرفت تماس را از طریق تلفن گویا ردیابی کنید و هنگامی که مشترک در منوی صوتی است، اطلاعاتی در مورد ضربه های کلید لمسی دریافت کنید.

برای انتقال تلفن شرکتی به تلفن‌های همراه، می‌توانید از برنامه‌های نرم‌افزاری استفاده کنید یا به‌طور جداگانه سرویس همگرایی تلفن همراه ثابت (FMC) را فعال کنید. با هر یک از روش‌ها، تماس‌های درون شبکه رایگان است، کار با شماره‌های کوتاه امکان‌پذیر می‌شود و می‌توان تماس‌ها را ضبط کرد و آمار کلی از آن‌ها ثبت کرد.

تفاوت این است که تلفن های نرم افزاری برای برقراری ارتباط به اینترنت نیاز دارند، اما به اپراتور متصل نیستند، در حالی که FMC به یک اپراتور خاص متصل است، اما می توان از آن حتی در تلفن های دکمه ای قدیمی استفاده کرد.

منبع: www.habr.com

سانترال مجازی Rostelecom: چه کاری و چگونه می توان از طریق API انجام داد