Rostelecom virtual PBX: ສິ່ງທີ່ສາມາດເຮັດໄດ້ຜ່ານ API

ທຸລະກິດທີ່ທັນສະໄຫມຮັບຮູ້ໂທລະສັບຕັ້ງໂຕະເປັນເຕັກໂນໂລຢີທີ່ລ້າສະໄຫມ: ການສື່ສານໂທລະສັບມືຖືຮັບປະກັນການເຄື່ອນທີ່ແລະການມີພະນັກງານຢ່າງຕໍ່ເນື່ອງ, ເຄືອຂ່າຍສັງຄົມແລະຜູ້ສົ່ງຂໍ້ຄວາມທັນທີແມ່ນຊ່ອງທາງການສື່ສານທີ່ງ່າຍແລະໄວກວ່າ. ເພື່ອຮັກສາຄູ່ແຂ່ງຂອງພວກເຂົາ, PBXs ຫ້ອງການແມ່ນມີຄວາມຄ້າຍຄືກັນຫຼາຍຂື້ນກັບພວກເຂົາ: ພວກເຂົາກໍາລັງເຄື່ອນຍ້າຍໄປຢູ່ໃນເມຄ, ຈັດການຜ່ານເວັບແລະປະສົມປະສານກັບລະບົບອື່ນໆຜ່ານ API. ໃນບົດຂຽນນີ້, ພວກເຮົາຈະບອກທ່ານວ່າ Rostelecom virtual PBX API ມີຫນ້າທີ່ໃດແລະວິທີການເຮັດວຽກກັບຫນ້າທີ່ຕົ້ນຕໍຂອງ virtual PBX ຜ່ານມັນ.

ວຽກງານຕົ້ນຕໍຂອງ Rostelecom virtual PBX API ແມ່ນການພົວພັນກັບ CRM ຫຼືເວັບໄຊທ໌ຂອງບໍລິສັດ. ຕົວຢ່າງ, API ປະຕິບັດ "ການໂທກັບຄືນ" ແລະ "ການໂທຈາກເວັບໄຊທ໌" ສໍາລັບລະບົບການຄຸ້ມຄອງຕົ້ນຕໍ: WordPress, Bitrix, OpenCart. API ອະ​ນຸ​ຍາດ​ໃຫ້​:

• ໄດ້​ຮັບ​ຂໍ້​ມູນ​ຂ່າວ​ສານ​, ແຈ້ງ​ການ​ສະ​ຖາ​ນະ​ພາບ​ແລະ​ການ​ໂທ​ຕາມ​ການ​ຮ້ອງ​ຂໍ​ຈາກ​ລະ​ບົບ​ພາຍ​ນອກ​;
• ໄດ້ຮັບການເຊື່ອມຕໍ່ຊົ່ວຄາວເພື່ອບັນທຶກການສົນທະນາ;
• ຈັດການແລະຮັບຕົວກໍານົດການຈໍາກັດຈາກຜູ້ໃຊ້;
• ໄດ້ຮັບຂໍ້ມູນກ່ຽວກັບຜູ້ໃຊ້ virtual PBX;
• ຮ້ອງຂໍປະຫວັດການຫັກຄ່າໂທ ແລະຄ່າບໍລິການ;
• ອັບໂຫຼດບັນທຶກການໂທ.

API ເຮັດວຽກແນວໃດ

API ການເຊື່ອມໂຍງແລະລະບົບພາຍນອກພົວພັນກັບກັນແລະກັນໂດຍໃຊ້ຄໍາຮ້ອງຂໍ HTTP. ໃນບັນຊີສ່ວນບຸກຄົນ, ຜູ້ບໍລິຫານກໍານົດທີ່ຢູ່ບ່ອນທີ່ຄໍາຮ້ອງຂໍໄປຫາ API ຄວນມາຮອດແລະບ່ອນທີ່ຄໍາຮ້ອງຂໍຈາກ API ຄວນຖືກສົ່ງໄປ. ລະບົບພາຍນອກຕ້ອງມີທີ່ຢູ່ສາທາລະນະທີ່ສາມາດເຂົ້າເຖິງໄດ້ຈາກອິນເຕີເນັດທີ່ມີໃບຢັ້ງຢືນ SSL ທີ່ຕິດຕັ້ງ.

ນອກຈາກນີ້ໃນບັນຊີສ່ວນບຸກຄົນ, ຜູ້ເບິ່ງແຍງໂດເມນສາມາດຈໍາກັດແຫຼ່ງຂອງການຮ້ອງຂໍເມື່ອເຂົ້າເຖິງ API ໂດຍ IP. 

ພວກເຮົາໄດ້ຮັບຂໍ້ມູນກ່ຽວກັບຜູ້ໃຊ້ PBX virtual 

ເພື່ອໃຫ້ໄດ້ຮັບບັນຊີລາຍຊື່ຂອງຜູ້ໃຊ້ຫຼືກຸ່ມ, ທ່ານຈໍາເປັນຕ້ອງສົ່ງຄໍາຮ້ອງຂໍໄປຫາ PBX virtual ໂດຍໃຊ້ວິທີການ /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^_^]
                            }
              ]

ວິທີການນີ້ຜ່ານສອງ array. ຫນຶ່ງກັບຜູ້ໃຊ້ໂດເມນ, ຫນຶ່ງທີ່ມີກຸ່ມໂດເມນ. ກຸ່ມຍັງມີໂອກາດທີ່ຈະລະບຸອີເມວທີ່ຈະຖືກສົ່ງໄປໃນຄໍາຮ້ອງຂໍ.

ກຳລັງປະມວນຜົນຂໍ້ມູນກ່ຽວກັບສາຍໂທເຂົ້າ

ການ​ເຊື່ອມ​ຕໍ່​ໂທລະ​ສັບ​ຂອງ​ບໍ​ລິ​ສັດ​ກັບ​ລະ​ບົບ CRM ຕ່າງໆ​ຊ່ວຍ​ປະ​ຢັດ​ເວ​ລາ​ສໍາ​ລັບ​ພະ​ນັກ​ງານ​ທີ່​ພົວ​ພັນ​ກັບ​ລູກ​ຄ້າ​ແລະ​ເລັ່ງ​ການ​ປຸງ​ແຕ່ງ​ຂອງ​ສາຍ​ໂທ​ເຂົ້າ​ໄດ້​. ຕົວຢ່າງ, ເມື່ອມີການໂທຈາກລູກຄ້າໃນປະຈຸບັນ, CRM ສາມາດເປີດບັດຂອງລາວ, ແລະຈາກ CRM ທ່ານສາມາດໂທຫາລູກຄ້າແລະເຊື່ອມຕໍ່ລາວກັບພະນັກງານ.

ເພື່ອໃຫ້ໄດ້ຮັບຂໍ້ມູນກ່ຽວກັບການໂທ API, ທ່ານຈໍາເປັນຕ້ອງໃຊ້ວິທີການ /get_number_info, ເຊິ່ງສ້າງບັນຊີລາຍຊື່ຂອງການໂທທີ່ມີຂໍ້ມູນກ່ຽວກັບກຸ່ມທີ່ການໂທຖືກແຈກຢາຍ. ສົມມຸດວ່າໝາຍເລກ PBX virtual ໄດ້ຮັບສາຍໂທເຂົ້າຈາກໝາຍເລກ 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":""
}

ຕໍ່ໄປ, ທ່ານຈໍາເປັນຕ້ອງເຊື່ອມຕໍ່ handler ໄດ້ /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>"
}

ພວກເຮົາຕິດຕາມສະຖານະການແລະດາວໂຫລດບັນທຶກການໂທ

ໃນ PBX virtual ຂອງ Rostelecom, ການບັນທຶກການໂທຈະຖືກເປີດໃຊ້ໃນບັນຊີສ່ວນຕົວຂອງທ່ານ. ການນໍາໃຊ້ API, ທ່ານສາມາດຕິດຕາມສະຖານະຂອງຫນ້າທີ່ນີ້. ເມື່ອປະມວນຜົນການຢຸດການໂທໃນ call_events ທ່ານສາມາດເບິ່ງທຸງ 'ແມ່ນ_ບັນທຶກ', ເຊິ່ງແຈ້ງເຕືອນຜູ້ໃຊ້ກ່ຽວກັບສະຖານະຂອງການເຂົ້າມາ: ທີ່ແທ້ຈິງ ຫມາຍຄວາມວ່າຟັງຊັນບັນທຶກການໂທຂອງຜູ້ໃຊ້ໄດ້ຖືກເປີດໃຊ້.

ເພື່ອດາວໂຫລດການບັນທຶກ, ທ່ານຈໍາເປັນຕ້ອງໃຊ້ 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 ເພື່ອປະມວນຜົນ array ແລະສະແດງການໂທໃນລະບົບ CRM.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

ໃນການຕອບສະຫນອງ, ທ່ານຈະໄດ້ຮັບ array ຂອງຂໍ້ມູນທີ່ສາມາດໄດ້ຮັບການປຸງແຕ່ງເພື່ອເກັບຂໍ້ມູນໃນບັນທຶກ 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 virtual ທີ່ເປັນປະໂຫຍດອື່ນໆ

ນອກຈາກ API, PBX virtual ມີຄຸນສົມບັດທີ່ເປັນປະໂຫຍດອື່ນໆທີ່ທ່ານສາມາດນໍາໃຊ້ໄດ້. ຕົວຢ່າງ, ນີ້ແມ່ນເມນູສຽງແບບໂຕ້ຕອບແລະການເຊື່ອມໂຍງຂອງການສື່ສານໂທລະສັບມືຖືແລະຄົງທີ່.

Interactive Voice Response (IVR) ແມ່ນສິ່ງທີ່ພວກເຮົາໄດ້ຍິນຢູ່ໃນມືຖືກ່ອນທີ່ຄົນຈະຕອບ. ໂດຍພື້ນຖານແລ້ວ, ນີ້ແມ່ນຜູ້ປະຕິບັດການອີເລັກໂທຣນິກທີ່ປ່ຽນເສັ້ນທາງການໂທໄປຫາພະແນກທີ່ເຫມາະສົມແລະຕອບຄໍາຖາມບາງຢ່າງໂດຍອັດຕະໂນມັດ. ໃນໄວໆນີ້ມັນຈະເປັນໄປໄດ້ທີ່ຈະເຮັດວຽກກັບ IVR ຜ່ານ API: ພວກເຮົາກໍາລັງພັດທະນາຊອບແວທີ່ຈະຊ່ວຍໃຫ້ທ່ານສາມາດຕິດຕາມຄວາມຄືບຫນ້າຂອງການໂທຜ່ານ IVR ແລະຮັບຂໍ້ມູນກ່ຽວກັບການກົດແປ້ນພິມແບບສໍາຜັດເມື່ອຜູ້ຈອງຢູ່ໃນເມນູສຽງ.

ເພື່ອ​ໂອນ​ໂທລະ​ສັບ​ຂອງ​ບໍ​ລິ​ສັດ​ກັບ​ໂທລະ​ສັບ​ມື​ຖື​, ທ່ານ​ສາ​ມາດ​ນໍາ​ໃຊ້​ຄໍາ​ຮ້ອງ​ສະ​ຫມັກ softphone ຫຼື​ແຍກ​ຕ່າງ​ຫາກ​ເປີດ​ບໍ​ລິ​ການ Fixed Mobile Convergence (FMC​)​. ດ້ວຍວິທີໃດກໍ່ຕາມ, ການໂທພາຍໃນເຄືອຂ່າຍແມ່ນບໍ່ເສຍຄ່າ, ມັນເປັນໄປໄດ້ທີ່ຈະເຮັດວຽກກັບຕົວເລກສັ້ນ, ແລະການໂທສາມາດບັນທຶກແລະສະຖິຕິທົ່ວໄປສາມາດເກັບຮັກສາໄວ້ໄດ້. 

ຄວາມແຕກຕ່າງແມ່ນວ່າ softphones ຕ້ອງການອິນເຕີເນັດເພື່ອຕິດຕໍ່ສື່ສານ, ແຕ່ພວກເຂົາເຈົ້າບໍ່ໄດ້ tied ກັບຜູ້ປະກອບການ, ໃນຂະນະທີ່ FMC ແມ່ນ tied ກັບຜູ້ປະກອບການສະເພາະໃດຫນຶ່ງ, ແຕ່ສາມາດນໍາໃຊ້ໄດ້ເຖິງແມ່ນວ່າໃນໂທລະສັບກົດປຸ່ມເກົ່າ.

ແຫຼ່ງຂໍ້ມູນ: www.habr.com