电话集成-自定义电话服务器PBX

电话集成-自定义电话服务器PBX

适用场景

1. 用户可以通过集成电话服务器（PBX）来为客户提供更好的服务。当用户呼叫技术员时，SDP中会弹窗显示用户的详细信息，包括用户已提交的请求和所属资产，对于未知的用户则可将其添加为新用户。

2. 通话过程中可以在 “电话注释” 中记录备忘信息，在通话结束可以方便的将备忘信息添加到已有请求或新建请求

3. 可以从请求详细页面直接呼叫用户，通过电话服务器的配置可以进一步实现 技术员可以从计算机上发起呼叫和接听，无需 拿起听筒再 手动输入号码。

集成配置


工作原理

当从页面呼叫用户时，会通过 makecall.txt 中的文本信息调用 test脚本。在脚本执行期间，前端页面会显示为“拨出呼叫，请提取话机开始交谈”，期间需要调用到后面提到的三个 API 来实时更新通话的状态。

脚本

makecall.txt 文件中输入需要执行的脚本 
      cmd /c test.bat 


ServiceDesk Plus 在执行该脚本时会默认携带三个参数分别为系统中记录的呼叫者的SIP分机号，SIP用户名，被呼叫者的手机号。
如示例 test.bat:

      ::for sleep about 5s
      ping -n 5 127.0.0.1
      echo  %date% %time%  the params are  %1  %2 %3 > c:\Users\18436\Desktop\file.txt

示例



获取到的参数：
 12/21/2021 Tue 16:52:11.52  the params are  3333  4444 8888 

电话相关API及演示

测试示例中：3333为技术员SIP分机号，4444为技术员SIP用户名，8888为用户手机号

来电显示

API调用URL地址
  1. <protocol>://<hostname>:<port number>/api/v3/telephony/make_call

示例：http://192.168.0.163:8080/api/v3/telephony/make_call

请求参数

方法：POST

请求参数：

参数名

值

位置

input_data

<JSON_String>

body

authtoken

<API Key>

header
输入示例
{
     "caller" : "8888" ,
     "callee" : "4444"
}
响应示例

 {

     "response_status": {
         "status_code":  2000,
         "messages": [
            {
                 "status_code":  2000,
                 "type":  "success",
                 "message":  "电话操作完成"
            }
        ],
         "status":  "success"
    }
}
Postman示例

接听

API调用URL地址
  1. <protocol>://<hostname>:<port number>/api/v3/telephony/pick_call

示例：http://192.168.0.163:8080/api/v3/telephony/pick_call

请求参数

方法：PUT

请求参数：

参数名

值

位置

input_data

<JSON_String>

body

authtoken

<API Key>

header
输入示例
{
     "caller" : "8888" ,
     "callee" : "3333"
}
响应示例
{
     "response_status": {
         "status_code":  2000,
         "messages": [
            {
                 "status_code":  2000,
                 "type":  "success",
                 "message":  "电话操作完成"
            }
        ],
         "status":  "success"
    }
}
Postman示例

挂断

API调用URL地址

  1. <protocol>://<hostname>:<port number>/api/v3/telephony/drop_call

示例：http://192.168.0.163:8080/api/v3/telephony/drop_call

请求参数

方法：DELETE

请求参数：

参数名

值

位置

input_data

<JSON_String>

body

authtoken

<API Key>

header
输入示例
{
     "caller" : "8888" ,
     "callee" : "3333"
}
响应示例
{
     "response_status": {
         "status_code":  2000,
         "messages": [
            {
                 "status_code":  2000,
                 "type":  "success",
                 "message":  "电话操作完成"
            }
        ],
         "status":  "success"
    }
}
Postman示例