CSTA 控制
用户代理计算机支持电信应用(uaCSTA)的详细说明可以参考 Using CSTA for SIP Phone User Agents (uaCSTA) 和 Services for Computer Supported Telecommunications Applications Phase III。
话机上的 uaCSTA 功能可以用于从计算机应用程序(如 PC 软电话)远程控制话机。你可以使用应用程序控制话机执行基本的呼叫操作。例如,拨打电话、接听电话、结束电话和将电话转接给其他方。
网页配置
在网页界面上,选择:功能 > 远端控制 > CSTA控制。
参数配置
下表列出了用于配置 CSTA 控制的参数。
features.csta_control.enable
M7参数
取值范围
出厂默认值
功能说明
features.csta_control.enable[1]
0-禁用1-启用
0
启用或禁用 CSTA 功能。
[1] 如果更改此参数,话机会重启以使更改生效。
Action URL
Action URL 允许话机通过发送 HTTP 或 HTTPS GET 请求与 Web 服务器应用程序交互。
你可以指定一个 URL,当指定事件发生时触发 GET 请求。Action URL 只能由预定义事件触发(例如,打开 DND)。有效的 URL 格式为:http(s)://<serverIPAddress>/help.xml?。
HTTP 或 HTTPS GET 请求可能包含变量名和变量值,用“=”分隔。每个变量值在 URL 的查询部分以 $ 开头。有效的 URL 格式为:http(s)://<serverIPAddress>/help.xml?variable name=$variable value。
变量名可以由用户自定义,而变量值是预定义的。例如,为事件 Mute 指定一个 URL http://192.168.1.10/help.xml?mac=$mac,当话机静音通话时,$mac 将动态替换为话机的 MAC 地址。
预定义事件列表
下表列出了Action URL 的预定义事件。
事件
描述
Setup Completed
话机完成启动时。
Registered
话机成功注册账户时。
Unregistered
话机注销注册账户时。
Register Failed
话机注册账户失败时。
Off Hook
话机摘机时。
On Hook
话机挂断时。
Incoming Call
话机接收到来电时。
Outgoing Call
话机拨打电话时。
Established
话机建立通话时。
Terminated
话机终止通话时。
Open DND
话机启用 DND 模式时。
说明:当 DND 模式为 Phone 时,话机会发送所有账户的Action URL;当 DND 模式为 Custom 时,话机只发送相应账户的Action URL。
Close DND
话机禁用 DND 模式时。
说明:当 DND 模式为 Phone 时,话机会发送所有账户的Action URL;当 DND 模式为 Custom 时,话机只发送相应账户的Action URL。
Always Forward On
话机启用始终转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
Always Forward Off
话机禁用始终转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
Busy Forward On
话机启用忙碌转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
Busy Forward Off
话机禁用忙碌转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
No Answer Forward On
话机启用无应答转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
No Answer Forward Off
话机禁用无应答转发时。
说明:当转发模式为 Phone 时,话机会发送所有账户的Action URL;当转发模式为 Custom 时,话机只发送相应账户的Action URL。
Transfer Call
话机转接电话时。
Blind Transfer
话机执行盲转接时。
Attended Transfer
话机执行半盲/盲转接时。
Hold
话机将通话置于保持状态时。
UnHold
话机恢复保持的通话时。
Held
话机上的通话被保持时。
UnHeld
话机恢复保持的通话时。
Mute
话机静音通话时。
UnMute
话机取消静音通话时。
Missed Call
话机错过来电时。
IP Changed
话机 IP 地址更改时。
Idle To Busy
话机状态从空闲变为忙碌时。
Busy To Idle
话机状态从忙碌变为空闲时。
Reject Incoming Call
话机拒绝来电时。
Answer New Incoming Call
话机接听新来电时。
Transfer Failed
话机转接电话失败时。
Transfer Finished
话机完成电话转接时。
Forward Incoming Call
话机转发来电时。
Autop Finish
话机完成自动配置时。
Call Waiting On
话机启用呼叫等待时。
Call Waiting Off
话机禁用呼叫等待时。
Headset
话机按下耳机键时。
Handfree
话机按下免提键时。
Cancel Call Out
话机在回铃状态下取消外拨通话时。
Remote Busy
外拨通话被拒绝时。
Call Remote Canceled
远程方在振铃状态下取消外拨通话时。
Peripheral Information
配件插拔时。
VPN IP
话机 IP 地址由 VPN 服务器分配更改时。
变量值列表
下表列出了预定义的变量值。
变量值
描述
$mac
话机的 MAC 地址。
$ip
话机的 IP 地址。
$model
话机型号。
$firmware
话机的固件版本。
$active_url
当话机拨打电话、接听来电或建立通话时的当前账户的 SIP URI。
$active_user
当话机拨打电话、接听来电或建立通话时的当前账户的 SIP URI 的用户部分。
$active_host
当话机拨打电话、接听来电或建立通话时的当前账户的 SIP URI 的主机部分。
$local
当话机拨打电话时的主叫方 SIP URI。当话机接听来电时的被叫方 SIP URI。
$remote
当话机拨打电话时的被叫方 SIP URI。当话机接听来电时的主叫方 SIP URI。
$display_local
当话机拨打电话时的主叫方显示名称。当话机接听来电时的被叫方显示名称。
$display_remote
当话机拨打电话时的被叫方显示名称。当话机接听来电时的主叫方显示名称。
$call_id
活动通话的 call-id。
$callerID
当话机接听来电时的主叫方显示名称。
$calledNumber
当话机拨打电话时的被叫号码。
$exp_number
已连接的扩展模块数量。
$ehs_number
已连接的 EHS 数量。
$udisk_number
已连接的 USB 闪存驱动器数量。
$usbheadset_number
已连接的 USB 耳机设备数量。
$wifi_number
已连接的 Wi-Fi 加密狗数量。
$bluetooth_number
已连接的蓝牙加密狗数量。
$vpn_ip
VPN 服务器分配的 IP 地址。
$cfg_all
CFG 配置文件包含话机的所有当前配置。
有效的 URI 是:http://<serverIPAddress>/<filename>/?variable name=$variable value。
$cfg_local
CFG 配置文件包含通过话机用户界面和网页用户界面进行的所有非静态参数。
仅当“static.auto_provision.custom.protect”设置为 1(启用)时有效。有效的 URI 是:http://<serverIPAddress>/<filename>/?variable name=$variable value。
网页配置
在网页界面上,选择到:功能 > Action URL。
参数配置
下表列出了用于配置Action URL 的参数。
action_url.setup_completed
action_url.registered
action_url.unregistered
action_url.register_failed
action_url.off_hook
action_url.on_hook
action_url.incoming_call
action_url.outgoing_call
action_url.call_established
action_url.call_terminated
action_url.dnd_on
action_url.dnd_off
action_url.always_fwd_on
action_url.always_fwd_off
action_url.busy_fwd_on
action_url.busy_fwd_off
action_url.no_answer_fwd_on
action_url.no_answer_fwd_off
action_url.transfer_call
action_url.blind_transfer_call
action_url.attended_transfer_call
action_url.hold
action_url.unhold
action_url.held
action_url.unheld
action_url.mute
action_url.unmute
action_url.missed_call
action_url.busy_to_idle
action_url.idle_to_busy
action_url.ip_change
action_url.reject_incoming_call
action_url.answer_new_incoming_call
action_url.forward_incoming_call
action_url.transfer_finished
action_url.transfer_failed
action_url.setup_autop_finish
action_url.call_waiting_on
action_url.call_waiting_off
action_url.headset
action_url.handfree
action_url.cancel_callout
action_url.remote_busy
action_url.call_remote_canceled
action_url.peripheral_information
action_url.vpn_ip
custom.action_url.view_misscall
custom.action_url.view_forward
action_url.call_established
action_url.sip_info_display_update
action_url.idle_to_busy
M7参数
取值范围
出厂默认值
功能说明
action_url.setup_completed
URL 长度不超过 511 个字符
空
配置话机启动后发送的Action URL。示例:action_url.setup_completed = http://192.168.0.20/help.xml?IP=$ip
action_url.registered
URL 长度不超过 511 个字符
空
配置话机注册账户后发送的Action URL。示例:action_url.registered = http://192.168.0.20/help.xml?IP=$ip
action_url.unregistered
URL 长度不超过 511 个字符
空
配置话机注销账户后发送的Action URL。示例:action_url.unregistered = http://192.168.0.20/help.xml?IP=$ip
action_url.register_failed
URL 长度不超过 511 个字符
空
配置话机注册失败后发送的Action URL。示例:action_url.register_failed = http://192.168.0.20/help.xml?IP=$ip
action_url.off_hook
URL 长度不超过 511 个字符
空
配置话机摘机时发送的Action URL。示例:action_url.off_hook = http://192.168.0.20/help.xml?IP=$ip
action_url.on_hook
URL 长度不超过 511 个字符
空
配置话机挂断时发送的Action URL。示例:action_url.on_hook = http://192.168.0.20/help.xml?IP=$ip
action_url.incoming_call
URL 长度不超过 511 个字符
空
配置话机接收到来电时发送的Action URL。示例:action_url.incoming_call = http://192.168.0.20/help.xml?IP=$ip
action_url.outgoing_call
URL 长度不超过 511 个字符
空
配置话机拨打电话时发送的Action URL。示例:action_url.outgoing_call = http://192.168.0.20/help.xml?IP=$ip
action_url.call_established
URL 长度不超过 511 个字符
空
配置话机建立通话时发送的Action URL。示例:action_url.call_established = http://192.168.0.20/help.xml?IP=$ip
action_url.call_terminated
URL 长度不超过 511 个字符
空
配置话机终止通话时发送的Action URL。示例:action_url.call_terminated = http://192.168.0.20/help.xml?IP=$ip
action_url.dnd_on
URL 长度不超过 511 个字符
空
配置话机启用 DND 功能时发送的Action URL。示例:action_url.dnd_on = http://192.168.0.20/help.xml?IP=$ip
action_url.dnd_off
URL 长度不超过 511 个字符
空
配置话机禁用 DND 功能时发送的Action URL。示例:action_url.dnd_off = http://192.168.0.20/help.xml?IP=$ip
action_url.always_fwd_on
URL 长度不超过 511 个字符
空
配置话机启用始终转发功能时发送的Action URL。示例:action_url.always_fwd_on = http://192.168.0.20/help.xml?IP=$ip
action_url.always_fwd_off
URL 长度不超过 511 个字符
空
配置话机禁用始终转发功能时发送的Action URL。示例:action_url.always_fwd_off = http://192.168.0.20/help.xml?IP=$ip
action_url.busy_fwd_on
URL 长度不超过 511 个字符
空
配置话机启用忙碌转发功能时发送的Action URL。示例:action_url.busy_fwd_on = http://192.168.0.20/help.xml?IP=$ip
action_url.busy_fwd_off
URL 长度不超过 511 个字符
空
配置话机在禁用忙时转移时发送的Action URL。示例:action_url.busy_fwd_off = http://192.168.0.20/help.xml?IP=$ip
action_url.no_answer_fwd_on
URL 长度不超过 511 个字符
空
配置话机在启用无应答转移时发送的Action URL。示例:action_url.no_answer_fwd_on = http://192.168.0.20/help.xml?IP=$ip
action_url.no_answer_fwd_off
URL 长度不超过 511 个字符
空
配置话机在禁用无应答转移时发送的Action URL。示例:action_url.no_answer_fwd_off = http://192.168.0.20/help.xml?IP=$ip
action_url.transfer_call
URL 长度不超过 511 个字符
空
配置话机在执行呼叫转接时发送的Action URL。示例:action_url.transfer_call = http://192.168.0.20/help.xml?IP=$ip
action_url.blind_transfer_call
URL 长度不超过 511 个字符
空
配置话机在执行盲转呼叫时发送的Action URL。示例:action_url.blind_transfer_call = http://192.168.0.20/help.xml?IP=$ip
action_url.attended_transfer_call
URL 长度不超过 511 个字符
空
配置话机在执行咨询转接/半咨询转接时发送的Action URL。示例:action_url.attended_transfer_call = http://192.168.0.20/help.xml?IP=$ip
action_url.hold
URL 长度不超过 511 个字符
空
配置话机在将通话置于保持时发送的Action URL。示例:action_url.hold = http://192.168.0.20/help.xml?IP=$ip
action_url.unhold
URL 长度不超过 511 个字符
空
配置话机在恢复保持通话时发送的Action URL。示例:action_url.unhold = http://192.168.0.20/help.xml?IP=$ip
action_url.held
URL 长度不超过 511 个字符
空
配置话机在通话被保持时发送的Action URL。示例:action_url.held = http://192.168.0.20/help.xml?IP=$ip
action_url.unheld
URL 长度不超过 511 个字符
空
配置话机在恢复保持通话时发送的Action URL。示例:action_url.unheld = http://192.168.0.20/help.xml?IP=$ip
action_url.mute
URL 长度不超过 511 个字符
空
配置话机在静音通话时发送的Action URL。示例:action_url.mute = http://192.168.0.20/help.xml?IP=$ip
action_url.unmute
URL 长度不超过 511 个字符
空
配置话机在取消静音通话时发送的Action URL。示例:action_url.unmute = http://192.168.0.20/help.xml?IP=$ip
action_url.missed_call
URL 长度不超过 511 个字符
空
配置话机在错过来电时发送的Action URL。示例:action_url.missed_call = http://192.168.0.20/help.xml?IP=$ip
action_url.busy_to_idle
URL 长度不超过 511 个字符
空
配置话机在从忙碌状态变为空闲状态时发送的Action URL。示例:action_url.busy_to_idle = http://192.168.0.20/help.xml?IP=$ip
action_url.idle_to_busy
URL 长度不超过 511 个字符
空
配置话机在从空闲状态变为忙碌状态时发送的Action URL。示例:action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip
action_url.ip_change
URL 长度不超过 511 个字符
空
配置话机在更改 IP 地址时发送的Action URL。示例:action_url.ip_change = http://192.168.0.20/help.xml?IP=$ip
action_url.reject_incoming_call
URL 长度不超过 511 个字符
空
配置话机在拒接来电时发送的Action URL。示例:action_url.reject_incoming_call = http://192.168.0.20/help.xml?IP=$ip
action_url.answer_new_incoming_call
URL 长度不超过 511 个字符
空
配置话机在接听新来电时发送的Action URL。示例:action_url.answer_new_incoming_call = http://192.168.0.20/help.xml?IP=$ip
action_url.forward_incoming_call
URL 长度不超过 511 个字符
空
配置话机在转接来电时发送的Action URL。示例:action_url.forward_incoming_call = http://192.168.0.20/help.xml?IP=$ip
action_url.transfer_finished
URL 长度不超过 511 个字符
空
配置话机在完成呼叫转接时发送的Action URL。示例:action_url.transfer_finished = http://192.168.0.20/help.xml?IP=$ip
action_url.transfer_failed
URL 长度不超过 511 个字符
空
配置话机在呼叫转接失败时发送的Action URL。示例:action_url.transfer_failed = http://192.168.0.20/help.xml?IP=$ip
action_url.setup_autop_finish
URL 长度不超过 511 个字符
空
配置话机在通过开机自动配置完成时发送的Action URL。示例:action_url.setup_autop_finish = http://192.168.0.20/help.xml?IP=$ip
action_url.call_waiting_on
URL 长度不超过 511 个字符
空
配置话机在启用呼叫等待功能时发送的Action URL。示例:action_url.call_waiting_on = http://192.168.0.20/help.xml?IP=$ip
action_url.call_waiting_off
URL 长度不超过 511 个字符
空
配置话机在禁用呼叫等待功能时发送的Action URL。示例:action_url.call_waiting_off = http://192.168.0.20/help.xml?IP=$ip
action_url.headset
URL 长度不超过 511 个字符
空
配置话机在按下耳机键时发送的Action URL。示例:action_url.headset = http://192.168.0.20/help.xml?IP=$ip
action_url.handfree
URL 长度不超过 511 个字符
空
配置话机在按下免提键时发送的Action URL。示例:action_url.handfree = http://192.168.0.20/help.xml?IP=$ip
action_url.cancel_callout
URL 长度不超过 511 个字符
空
配置话机在回铃状态下取消呼出电话时发送的Action URL。示例:action_url.cancel_callout = http://192.168.0.20/help.xml?IP=$ip
action_url.remote_busy
URL 长度不超过 511 个字符
空
配置话机在呼出电话被拒接时发送的Action URL。示例:action_url.remote_busy = http://192.168.0.20/help.xml?IP=$ip
action_url.call_remote_canceled
URL 长度不超过 511 个字符
空
配置话机在远程方在振铃状态下取消呼出电话时发送的Action URL。示例:action_url.call_remote_canceled = http://192.168.0.20/help.xml?IP=$ip
action_url.peripheral_information
URL 长度不超过 511 个字符
空
配置话机在插拔配件时发送的Action URL。示例:action_url.peripheral_information = http://192.168.0.20/help.xml?IP=$ip&WIFI=$wifi_number
action_url.vpn_ip
URL 长度不超过 511 个字符
空
配置话机在 VPN 服务器分配的 IP 地址更改时发送的Action URL。示例:action_url.vpn_ip = http://192.168.0.20/help.xml?IP=$ip
custom.action_url.view_misscall
URL 长度不超过 511 个字符
空
用于配置查看未接来电的Action URL。
custom.action_url.view_forward
URL 长度不超过 511 个字符
空
用于配置查看转接来电的Action URL。
action_url.call_established
URL 长度不超过 511 个字符
空
配置话机在通话建立时发送的Action URL。示例:action_url.call_established = http://192.168.0.20/help.xml?IP=$ip
action_url.sip_info_display_update
URL 长度不超过 511 个字符
空
用于配置在通话期间接收 SIP INFO 消息时触发的Action URL。
action_url.idle_to_busy
URL 长度不超过 511 个字符
空
配置话机在从空闲状态变为忙碌状态时发送的Action URL。示例:action_url.idle_to_busy = http://192.168.0.20/help.xml?IP=$ip
Action URI
话机可以通过接收和处理HTTP或HTTPS GET请求或接受带有“SIP NOTIFY”消息头的SIP代理服务器消息来执行指定的操作。
支持的HTTP/HTTPS GET请求
与Action URL相反,Action URI允许话机通过接收和处理HTTP或HTTPS GET请求与Web服务器应用程序进行交互。当接收到GET请求时,电话将执行指定的操作并响应200 OK消息。
GET请求可能包含一个名为“key”的变量和一个变量值,这些变量和值之间用“=”分隔。有效的URI格式为:http(s)://<phoneIPAddress>/servlet?key=variable value。
话机兼容另外两种旧的有效URI格式: http(s)://<phoneIPAddress>/cgi-bin/ConfigManApp.com?key=variable value 和 http(s)://<phoneIPAddress>/cgi-bin/cgiServer.exx?key=variable value。
出于安全原因,话机默认情况下不处理HTTP/HTTPS GET请求。你需要为Action URI指定受信任的IP地址。你可以在话机上指定一个或多个受信任的IP地址,或配置话机以接收和处理来自任何IP地址的URI。
支持的SIP Notify消息
此外,话机可以通过接受带有“SIP NOTIFY”消息头的SIP代理服务器消息立即执行指定的操作。SIP NOTIFY消息的消息体可能包含一个名为“key”的变量和一个变量值,这些变量和值之间用“=”分隔。
此方法对于那些在小型办公室/家庭办公室工作的用户特别有用,因为安全防火墙可能会阻止外部网络的HTTP或HTTPS GET请求。
如果你只希望接受来自SIP服务器和外部代理服务器的SIP NOTIFY消息,你必须启用“仅接受SIP信任服务器”的功能。有关更多信息,请参阅“仅接受SIP信任服务器”。
如果你使用SIP NOTIFY消息方法,则不需要为Action URI指定受信任的IP地址。但是,你应启用话机以接收Action URI请求。
SIP Notify消息示例(变量值为OK):
消息头
NOTIFY sip:3583@10.2.40.10:5062 SIP/2.0
Via: SIP/2.0/UDP 10.2.40.27:5063;branch=z9hG4bK4163876675
From: <sip:3586@10.2.1.48>;tag=2900480538
To: "3583" <sip:3583@10.2.1.48>;tag=490600926
Call-ID: 2923387519@10.2.40.10
CSeq: 4 NOTIFY
Contact: <sip:3586@10.2.40.27:5063>
Max-Forwards: 70
User-Agent: Yealink SIP-T46G
Event: ACTION-URI
Content-Type: message/sipfrag
Content-Length: 6
消息体
key=OK
变量值列表
话机还支持在URI中组合变量值,但变量值的顺序由电话的操作决定。有效的URI格式为:http(s)://<phoneIPAddress>/servlet?key=variable value[;variable value]。变量值之间用分号分隔。
以下是删除话机空闲时通话记录列表中所有条目的示例:
http://10.3.20.10/servlet?key=F1;F3;DOWN;DOWN;DOWN;OK;OK
变量值并不适用于所有事件。例如,变量值“MUTE”仅适用于话机通话期间。当需要身份验证时,可以使用以下URI格式:http(s)://username:password@/servlet?key=variable value。如果你使用的是浏览器,建议使用Firefox。
以下表格列出了预定义的变量值:
变量值
电话操作
OK
按下OK/√键。
ENTER
按下Enter软键。
SPEAKER
按下免提键。
F_TRANSFER
将呼叫转接给另一方。
VOLUME_UP
增加音量。
VOLUME_DOWN
减少音量。
MUTE
静音通话。
F_HOLD/HOLD
将活动通话保持。
F_CONFERENCE
按下Conf/Conference软键。
Cancel/CANCEL
取消操作、拒接来电或结束通话。
X
取消操作、拒接来电或静音/取消静音通话。
0-9/*/POUND
按下键盘(0-9、*或#)。
L1-LX
按下线路键。
LX_LONGPRESS[1]
长按线路键X执行相应操作。
BACK_IDLE
直接返回空闲屏幕。
F1-F4
按下软键。
MSG
按下消息键。
HEADSET
按下耳机键。
RD
按下重拨键。
UP/DOWN/LEFT/RIGHT
按下导航键。
Reboot
重启话机。
AutoP
执行自动配置。
DNDOn
启用免打扰功能。
说明:仅在“features.dnd.allow”设置为1(启用)时有效。
DNDOff
禁用免打扰功能。
说明:仅在“features.dnd.allow”设置为1(启用)时有效。
number=xxx&outgoing_uri=y
从SIP URI y拨打xxx号码。示例:http://10.3.20.10/servlet?key=number=1234&outgoing_uri=1006@10.2.1.48(1234表示拨出的号码,1006@10.2.1.48表示拨出的SIP URL)。
OFFHOOK
按下摘机键。
ONHOOK
按下挂机键。
ANSWER/ASW/Asw
接听来电。
Reset
重置话机。
ATrans=xxx
执行半咨询/咨询转接至xxx。
ATrans=callid_A@callid_B
使用呼叫ID将任意两个通话方连接在一起。通话建立后,这两方与电话断开连接。场景:A和D正在通话,通话处于活动状态;B和D正在通话,通话被保持;C和D正在通话,通话被保持;callid_A:32775callid_B:32776示例:http://10.10.20.10/servlet?key=ATrans=32775@32776这意味着A和B连接在一起,然后与D断开连接。但C和D之间的通话仍处于保持状态。
说明:要获取活动呼叫的 call-id,请配置操作 URL:http(s):///help.xml?CallId=$call_id。有关更多信息,请参阅操作 URL。
BTrans=xxx
执行盲转接至xxx。
phonecfg=get[&accounts=x][&dnd=x][&fw=x]
获取固件版本、注册、DND或转接配置信息。“x”的有效值为0或1,0表示不需要获取配置信息,1表示需要获取配置信息。
说明:有效的URI为:http(s):///servlet?phonecfg=get[&accounts=x][&dnd=x][&fw=x]。示例:http://10.3.20.10/servlet?phonecfg=get[&accounts=1][&dnd=0][&fw=1]
phonecfg=set[&configuration parameter=value]
为指定的参数配置设置有效值。
说明:有效的URI为:http(s):///servlet?phonecfg=set[&configuration parameter=value]…[&configuration parameter=value]。它可以包含多达10个参数配置。示例:http://10.3.20.10/servlet?phonecfg=set[&account.1.enable=1][&features.dnd.enable=1]
phonecfg=get[&configuration parameter]
获取指定的配置信息。
说明:有效的URI为:http(s):///servlet?phonecfg=get[&configuration parameter]…[&configuration parameter]。它可以包含多达10个参数配置。示例:http://10.3.20.10/servlet?phonecfg=get[&account.1.enable][&features.dnd.enable]
CallWaitingOn
启用呼叫等待功能。
CallWaitingOff
禁用呼叫等待功能。
AlwaysFwdOn/BusyFwdOn/NoAnswFwdOn=xxx=n
启用始终/忙时/无应答转接功能至xxx(“xxx”表示目的号码)“n”的有效值表示转接来电前的持续时间(秒)(n是6的倍数,例如24)。仅适用于无应答转接功能。
说明:对于话机,仅在“features.fwd.allow”设置为1(启用)且呼叫转接模式为Phone时有效,始终/忙时/无应答转接功能将应用于电话上的所有帐户。示例:http://10.10.20.10/servlet?key=NoAnswFwdOn=1001=24
AlwaysFwdOff/BusyFwdOff/NoAnswFwdOff
禁用话机的始终/忙时/无应答转接功能。
说明:对于话机,仅在“features.fwd.allow”设置为1(启用)且呼叫转接模式为Phone时有效,始终/忙时/无应答转接功能将应用于电话上的所有帐户。示例:http://10.10.20.10/servlet?key=NoAnswFwdOff
CALLEND/CallEnd
结束通话。
ASW/CANCEL/HOLD/UNHOLD:xxx
接听/结束/保持/取消保持通话(xxx指活动通话的呼叫ID)。示例:http://10.10.20.10/servlet?key=ASW:33093
说明:要获取活动通话的呼叫ID,请配置Action URL:http(s):///help.xml?CallId=$call_id。更多信息,请参阅Action URL。
ACDlogin
登录ACD系统。
说明:当需要ACD认证信息时,有效的URI为:http(s):///servlet?key=ACDlogin&agentID=xxx&password=xxx。当不需要ACD认证信息时,有效的URI为:http(s):///servlet?key=ACDlogin。
ACDlogout
登出ACD系统。
SWAP
当话机上有一个活动通话和一个保持通话时,切换到保持通话。
SPLIT
将本地会议通话拆分为单独的通话。拆分后,会议通话结束,其他方被保持。
说明:不适用于网络会议。
[1]X是线路键ID。
网页配置
在网页界面,选择:功能 > 远端控制 > 允许控制IP列表。
参数配置
下表列出了用于配置Action URI的参数。
features.action_uri.enable
features.show_action_uri_option
features.action_uri.limit_ip
M7参数
取值范围
出厂默认值
功能说明
features.action_uri.enable
0-禁用1-启用
1
启用或禁用电话接收Action URI请求。
features.show_action_uri_option
0-禁用1-启用
1
启用或禁用电话在接收Action URI请求时弹出允许远程控制提示。
说明:仅在“features.action_uri.enable”设置为1(启用)时有效。
features.action_uri.limit_ip
IP地址。空-电话将拒绝任何HTTP GET请求。any-电话将接受并处理来自任何IP地址的HTTP GET请求。
空
配置电话接收Action URI请求的服务器地址。多个地址用逗号分隔。(例如,10.1.4.3,10.1.4.23);支持星号通配符,每个星号代表IP地址的一个字段(10.10.*.*表示10.10.0.0至10.10.255.255)。
说明:仅在“features.action_uri.enable”设置为1(启用)时有效。
示例:捕获话机当前屏幕
你可以使用Action URI捕获话机的屏幕显示。话机可以处理HTTP或HTTPS GET请求。URI格式为http(s)://<phoneIPAddress>/screencapture。捕获的图片将保存为BMP或JPEG文件。
你也可以使用URI“http(s)://<phoneIPAddress>/screencapture/download”先捕获屏幕显示,然后将图像(保存为JPG文件,并以电话型号和捕获时间命名)下载到本地系统。
话机还支持使用旧的URI“http://<phoneIPAddress>/servlet?command=screenshot”捕获屏幕显示。
在捕获话机当前屏幕之前,确保计算机的IP地址包含在话机的Action URI受信任IP地址中。当你捕获屏幕显示时,如果浏览器没有记住网页用户界面登录的用户名和密码,话机可能会提示你输入管理员的用户名和密码。
操作步骤
在浏览器的地址栏中输入请求URI(例如:http://10.2.20.252/screencapture)并按下键盘上的Enter键。
执行以下操作之一:
在网页上输入用户名和密码。
刷新网页。
浏览器将显示话机当前屏幕的图像。你可以将图像保存到本地系统。
频繁捕获可能会影响话机性能。我们建议你以至少4秒的间隔捕获话机屏幕显示。
示例:通过网页用户界面拨打电话
操作步骤
转到 联系人 > 呼叫历史。
从呼出账号下拉菜单中选择所需的帐户。
在呼叫号码字段中输入被叫号码。
单击拨打拨打号码。
网页用户界面提示“拨打成功”,话机将自动拨打号码。
你可以单击Hang Up结束通话。
如果这是你第一次通过网页用户界面拨打电话,LCD屏幕将提示“允许远程控制?”。在话机上按OK以允许远程控制,然后话机将自动拨打号码。
你还可以通过网页用户界面拨打IP直拨电话。电话支持IPv4或IPv6地址。