电话集成-自定义电话服务器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地址
- <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"
}
"caller" : "8888" ,
"callee" : "4444"
}
响应示例
{
"response_status": {
"status_code":
2000,
"messages": [
{
"status_code":
2000,
"type":
"success",
"message":
"电话操作完成"
}
],
"status":
"success"
}
}
Postman示例
接听
API调用URL地址
- <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"
}
"caller" : "8888" ,
"callee" : "3333"
}
响应示例
{
"response_status": {
"status_code":
2000,
"messages": [
{
"status_code":
2000,
"type":
"success",
"message":
"电话操作完成"
}
],
"status":
"success"
}
}
Postman示例
挂断
API调用URL地址
<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"
}
"caller" : "8888" ,
"callee" : "3333"
}
响应示例
{
"response_status": {
"status_code":
2000,
"messages": [
{
"status_code":
2000,
"type":
"success",
"message":
"电话操作完成"
}
],
"status":
"success"
}
}
Postman示例
Related Articles
电话集成-Asterisk
引言 电话集成简化了与用户的通信，从而让您的帮助台为客户更好的提供服务。将 ServiceDesk Plus 与您的电话服务器集成后，技术员可以从他们的计算机上接听，发起呼叫，无需拿起电话听筒。 注：仅 SDP 企业版支持电话集成 特点 通话弹窗将显示详细的用户信息，包括用户已提交的请求及所属资产。未知的用户将在SDP中添加为新用户。 可将通话详情与请求关联。 在通话结束时，可使用通话详细信息提交新请求。 如演示： ...资产扫描FAQs
常见问题 1. 在 ServiceDesk Plus 中如何做域扫描？ 当你安装并第一次启动 ServiceDesk Plus，它会自动检测所在网络中的所有的域，点击 管理 >> Windows域扫描 可查看所有的域。对于你需要扫描的域，你可以输入域控信息，域管理员登录名，密码。11300版本之后的 ServiceDesk Plus 使用 Endpoint Central 代理来扫描Windows计算机。并且，基于代理的扫描是强制的。 点击下列链接了解更多： EC 代理扫描 Windows ...