Rostelecom ভার্চুয়াল PBX: API এর মাধ্যমে কি এবং কিভাবে করা যেতে পারে

আধুনিক ব্যবসা ল্যান্ডলাইন ফোনগুলিকে একটি পুরানো প্রযুক্তি হিসাবে উপলব্ধি করে: সেলুলার যোগাযোগগুলি কর্মীদের গতিশীলতা এবং ধ্রুবক প্রাপ্যতা নিশ্চিত করে, সামাজিক নেটওয়ার্ক এবং তাত্ক্ষণিক মেসেঞ্জারগুলি একটি সহজ এবং দ্রুত যোগাযোগের চ্যানেল৷ তাদের প্রতিযোগীদের সাথে তাল মিলিয়ে চলার জন্য, অফিস পিবিএক্সগুলি তাদের সাথে আরও বেশি অনুরূপ হয়ে উঠছে: তারা ক্লাউডে চলে যাচ্ছে, একটি ওয়েব ইন্টারফেসের মাধ্যমে পরিচালিত হচ্ছে এবং API এর মাধ্যমে অন্যান্য সিস্টেমের সাথে একত্রিত হচ্ছে। এই পোস্টে আমরা আপনাকে বলব যে Rostelecom ভার্চুয়াল PBX API-এর কী কী ফাংশন রয়েছে এবং কীভাবে এটির মাধ্যমে ভার্চুয়াল PBX-এর প্রধান ফাংশনগুলির সাথে কাজ করা যায়।

Rostelecom ভার্চুয়াল PBX API-এর প্রধান কাজ হল CRM বা কোম্পানির ওয়েবসাইটগুলির সাথে মিথস্ক্রিয়া। উদাহরণস্বরূপ, এপিআই প্রধান ব্যবস্থাপনা সিস্টেমগুলির জন্য "কল ব্যাক" এবং "সাইট থেকে কল" উইজেটগুলি প্রয়োগ করে: ওয়ার্ডপ্রেস, বিট্রিক্স, ওপেনকার্ট। 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', যা ব্যবহারকারীকে এন্ট্রির স্থিতি সম্পর্কে অবহিত করে: সত্য মানে ব্যবহারকারীর কল রেকর্ডিং ফাংশন সক্রিয় করা হয়েছে।

একটি রেকর্ডিং ডাউনলোড করতে, আপনাকে কল সেশন আইডি ব্যবহার করতে হবে সেশন_আইডি একটি অনুরোধ পাঠান 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 বৈশিষ্ট্য

এপিআই ছাড়াও, একটি ভার্চুয়াল পিবিএক্সের আরও বেশ কিছু দরকারী বৈশিষ্ট্য রয়েছে যা আপনি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, এটি একটি ইন্টারেক্টিভ ভয়েস মেনু এবং সেলুলার এবং স্থির যোগাযোগের একীকরণ।

ইন্টারেক্টিভ ভয়েস রেসপন্স (IVR) হ্যান্ডসেটে যেটা আমরা শুনতে পাই সেই ব্যক্তি উত্তর দেওয়ার আগে। মূলত, এটি একটি ইলেকট্রনিক অপারেটর যিনি উপযুক্ত বিভাগগুলিতে কল পুনঃনির্দেশ করে এবং স্বয়ংক্রিয়ভাবে কিছু প্রশ্নের উত্তর দেয়। শীঘ্রই API এর মাধ্যমে IVR-এর সাথে কাজ করা সম্ভব হবে: আমরা বর্তমানে এমন সফ্টওয়্যার তৈরি করছি যা আপনাকে IVR-এর মাধ্যমে একটি কলের অগ্রগতি ট্র্যাক করতে এবং গ্রাহক ভয়েস মেনুতে থাকাকালীন টাচ-টোন কীস্ট্রোক সম্পর্কে তথ্য পেতে অনুমতি দেবে।

মোবাইল ফোনে কর্পোরেট টেলিফোনি স্থানান্তর করতে, আপনি হয় সফটফোন অ্যাপ্লিকেশন ব্যবহার করতে পারেন অথবা আলাদাভাবে ফিক্সড মোবাইল কনভারজেন্স (FMC) পরিষেবা সক্রিয় করতে পারেন৷ যেকোনো পদ্ধতির সাহায্যে নেটওয়ার্কের মধ্যে কল বিনামূল্যে, ছোট নম্বর দিয়ে কাজ করা সম্ভব হয় এবং কল রেকর্ড করা যায় এবং সাধারণ পরিসংখ্যান রাখা যায়। 

পার্থক্য হল যে সফ্টফোনগুলির যোগাযোগের জন্য ইন্টারনেটের প্রয়োজন হয়, তবে সেগুলি কোনও অপারেটরের সাথে আবদ্ধ হয় না, যখন FMC একটি নির্দিষ্ট অপারেটরের সাথে আবদ্ধ থাকে, তবে পুরানো পুশ-বোতাম ফোনেও ব্যবহার করা যেতে পারে।

উত্স: www.habr.com