主持人 > 博客 > 管理 > Rostelecom 虚拟 PBX：通过 API 可以做什么以及如何做

Rostelecom 虚拟 PBX：通过 API 可以做什么以及如何做

Rostelecom 虚拟 PBX：通过 API 可以做什么以及如何做

现代企业认为固定电话是一种过时的技术：蜂窝通信确保员工的移动性和持续可用性，社交网络和即时通讯工具是更简单、更快捷的通信渠道。 为了跟上竞争对手的步伐，办公室 PBX 变得越来越相似：它们正在迁移到云端，通过 Web 界面进行管理，并通过 API 与其他系统集成。 在这篇文章中，我们将告诉您Rostelecom虚拟PBX API有哪些功能以及如何通过它来使用虚拟PBX的主要功能。

Rostelecom 虚拟 PBX API 的主要任务是与 CRM 或公司网站交互。 例如，API 为主要管理系统实现了“回调”和“从站点调用”小部件：WordPress、Bitrix、OpenCart。 该 API 允许：

  • 根据外部系统的请求接收信息、通知状态并拨打电话；
  • 获取临时链接来记录对话；
  • 管理和接收来自用户的限制参数；
  • 获取虚拟PBX用户信息；
  • 请求通话借记和费用的历史记录；
  • 上传通话记录。

API 的工作原理

集成 API 和外部系统使用 HTTP 请求进行交互。 在个人账户中，管理员设置API请求应到达的地址以及API请求应发送的地址。 外部系统必须具有可通过 Internet 访问且已安装 SSL 证书的公共地址。

Rostelecom 虚拟 PBX：通过 API 可以做什么以及如何做

同样在个人账户中，域管理员可以在通过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调用的信息，您需要使用该方法 /获取号码信息，它生成一个呼叫列表，其中包含有关呼叫分配到的组的信息。 假设虚拟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":""
}

接下来您需要连接处理程序 /获取号码信息。 当传入呼叫到达传入线路时，必须在呼叫被路由之前执行该请求。 如果在指定时间内未收到对请求的响应，则根据域中建立的规则路由呼叫。

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，您可以跟踪此功能的状态。 当处理呼叫终止时 呼叫事件 你可以看到旗帜 '是记录', 它通知用户有关条目的状态： true 表示用户的通话录音功能已开启。

要下载录音，您需要使用通话会话 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"
        }

然后调用方法 呼叫信息 处理数组并在 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) 服务。 使用任何一种方法，网络内的呼叫都是免费的，可以使用短号码，并且可以记录呼叫并对其进行一般统计。 

不同之处在于，软电话需要互联网进行通信，但它们不与运营商绑定，而 FMC 与特定运营商绑定，但甚至可以在旧的按键电话上使用。

来源： habr.com

添加评论