CSTA 控制 用户代理计算机支持电信应用（uaCSTA）的详细说明可以参考 Using CSTA for SIP Phone User Agents (uaCSTA) 和 Services for Computer Supported Telecommunications Applications Phase III。 话机上的 uaCSTA 功能可以用于从计算机应用程序（如 PC 软电话）远程控制话机。你可以使用应用程序控制话机执行基本的呼叫操作。例如，拨打电话、接听电话、结束电话和将电话转接给其他方。 CSTA 控制配置 通过网页用户界面设置 在网页用户界面，选择：功能 > 远端控制 > CSTA控制。 image.png 配置参数 下表列出了用于配置 CSTA 控制的参数。 features.csta_control.enable 参数 允许值 默认值 描述 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。 image.png 配置参数 下表列出了用于配置 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 参数 允许值 默认值 描述 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。 Action URI 配置 通过网页用户界面设置 在网页用户界面，选择：功能 > 远端控制 > 允许控制IP列表。 image.png 配置参数 下表列出了用于配置Action URI的参数。 features.action_uri.enable features.show_action_uri_option features.action_uri.limit_ip 参数 允许的值 默认值 描述 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键。 执行以下操作之一： 在网页上输入用户名和密码。 刷新网页。 浏览器将显示话机当前屏幕的图像。你可以将图像保存到本地系统。 image.png 频繁捕获可能会影响话机性能。我们建议你以至少4秒的间隔捕获话机屏幕显示。 示例：通过网页用户界面拨打电话 操作步骤 转到 联系人 > 呼叫历史。 从呼出账号下拉菜单中选择所需的帐户。 在呼叫号码字段中输入被叫号码。 ​ image.png 单击拨打拨打号码。 网页用户界面提示“拨打成功”，话机将自动拨打号码。 你可以单击Hang Up结束通话。 如果这是你第一次通过网页用户界面拨打电话，LCD屏幕将提示“允许远程控制？”。在话机上按OK以允许远程控制，然后话机将自动拨打号码。 你还可以通过网页用户界面拨打 IP 直拨电话。话机支持 IPv4 或 IPv6 地址。