🥇Rostelecom 가상 PBX: API를 통해 무엇을, 어떻게 수행할 수 있나요

현대 기업은 유선 전화를 오래된 기술로 인식합니다. 셀룰러 통신은 직원의 이동성과 지속적인 가용성을 보장하며 소셜 네트워크와 인스턴트 메신저는 더 쉽고 빠른 통신 채널입니다. 경쟁업체를 따라잡기 위해 사무실 PBX는 점점 더 유사해지고 있습니다. 즉, 클라우드로 이동하고 웹 인터페이스를 통해 관리하며 API를 통해 다른 시스템과 통합되고 있습니다. 이 게시물에서는 Rostelecom 가상 PBX API의 기능과 이를 통해 가상 PBX의 주요 기능을 사용하는 방법을 설명합니다.

Rostelecom 가상 PBX API의 주요 작업은 CRM 또는 회사 웹 사이트와의 상호 작용입니다. 예를 들어, API는 WordPress, Bitrix, OpenCart와 같은 주요 관리 시스템에 대한 "콜백" 및 "사이트에서 호출" 위젯을 구현합니다. API를 사용하면 다음이 가능합니다.

정보 수신, 상태 알림, 외부 시스템 요청 시 전화 걸기
대화를 녹음하려면 임시 링크를 받으세요.
사용자로부터 제한 매개변수를 관리하고 수신합니다.
가상 PBX 사용자에 대한 정보를 얻습니다.
통화 이체 및 요금 내역을 요청합니다.
통화 기록을 업로드합니다.

API 작동 방식

통합 API와 외부 시스템은 HTTP 요청을 사용하여 서로 상호 작용합니다. 개인 계정에서 관리자는 API에 대한 요청이 도착해야 하는 주소와 API의 요청을 보내야 하는 주소를 설정합니다. 외부 시스템에는 SSL 인증서가 설치된 인터넷에서 액세스할 수 있는 공용 주소가 있어야 합니다.

또한 개인 계정에서 도메인 관리자는 IP를 통해 API에 액세스할 때 요청 소스를 제한할 수 있습니다.

가상 PBX 사용자에 대한 정보를 받습니다.

사용자 또는 그룹 목록을 얻으려면 다음 메소드를 사용하여 가상 PBX에 요청을 보내야 합니다. /사용자_정보.

{
        "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를 사용하면 이 기능의 상태를 추적할 수 있습니다. 통화 종료를 처리할 때 call_events 깃발을 볼 수 있어요 'is_record', 사용자에게 항목 상태를 알려줍니다. 참된 는 사용자의 통화 녹음 기능이 활성화되었음을 의미합니다.

녹음을 다운로드하려면 통화 세션 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 배열을 처리하고 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를 통해 IVR로 작업할 수 있게 될 것입니다. 현재 IVR을 통해 통화 진행 상황을 추적하고 가입자가 음성 메뉴에 있을 때 터치톤 키 입력에 대한 정보를 받을 수 있는 소프트웨어를 개발 중입니다.

기업 전화를 휴대폰으로 전환하려면 소프트폰 애플리케이션을 사용하거나 FMC(Fixed Mobile Convergence) 서비스를 별도로 활성화하면 됩니다. 어떤 방법을 사용하든 네트워크 내 통화는 무료이며 짧은 번호로 작업이 가능하며 통화를 녹음하고 일반 통계를 유지할 수 있습니다.

차이점은 소프트폰은 통신을 위해 인터넷이 필요하지만 운영자에게 연결되어 있지 않은 반면, FMC는 특정 운영자에게 연결되어 있지만 구형 푸시 버튼 전화기에서도 사용할 수 있다는 것입니다.

출처 : habr.com

Rostelecom 가상 PBX: API를 통해 무엇을, 어떻게 수행할 수 있습니까?