配置操作按钮（Control Hub）

操作按钮是位于 Cisco 无线电话 9821 右侧的红色按钮。它允许用户快速访问指定的服务，例如紧急或自定义服务。您可以自定义按钮以启动适合您的特定用例的事件。

自定义“作”按钮

1	从 Control Hub 中的客户视图，转至设备，然后选择您的电话。
2	选择 “所有配置”。
3	导航到 “电话 ”部分并选择作按钮。
4	根据您的使用案例自定义操作按钮参数。紧急呼叫定制服务多个事件的单个触发器多个触发器有关这些参数的更多详细信息，请参阅 Control Hub 上的 Cisco 无线电话 9821 设置参数。
5	选择下一步。
6	查看更改并选择应用。
7	选择关闭以关闭页面。

紧急呼叫参数设置

紧急呼叫的作按钮可确保快速轻松地访问工作空间中的关键帮助。配置以下紧急呼叫参数。

表 1. 紧急呼叫参数设置
参数	设置
操作按钮功能	选择紧急呼叫。
操作按钮服务目标	输入紧急服务的电话号码或 URI。
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。如果未指定 `名称，将使用紧急呼叫` 或 `静默紧急呼叫` 作为显示名称。
拨出延迟	设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件在检测到触发器后立即启动。延迟屏幕显示倒数计时器，允许用户取消由操作按钮触发的操作。在紧急呼叫情况下，Cisco 无线电话 9821 在显示延迟屏幕时持续振动。但是，对于静默紧急呼叫或信号，Cisco 无线电话 9821 不会振动。
服务触发器	从列表中选择触发器：单按、长按或按 3 次。
无声紧急呼叫	（可选）默认情况下，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。启用静默紧急呼叫后，主叫方端的音频将保持静音，以免在通话期间引起注意。只有呼叫接收方可以结束静默紧急呼叫。在无提示紧急呼叫期间，Cisco 无线电话 9821 屏幕将被关闭。所有其他功能都无法访问。在接收者结束呼叫后，电话将恢复正常作。
允许静默紧急呼叫取回	（可选）如果您允许用户在保持紧急呼叫的同时按任意键来恢复电话的正常操作，请启用此功能。呼叫音频将保持静音，除非用户使用音量键提高扬声器音量。

自定义服务参数设置

当您将作按钮与自定义服务关联时，电话用户可以通过指定的触发器访问该服务，例如按键上的单按、长按或三按。

为自定义服务配置以下参数。

表 2. 自定义服务参数设置
参数	设置
操作按钮功能	选择自定义。
操作按钮服务目标	输入自定义服务的 URL。 URL 必须以 http:// 或 https:// 开头，例如 `https://10.11.20.159/path/service.xml` 。
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。如果未指定名称，将使用自定义服务作为显示名称。
自定义内容字段	（可选）如果您希望电话能够在按下操作按钮时发送 HTTP POST 请求，请输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。有关 POST 脚本示例和语法，请参阅作按钮的 HTTP POST 请求。
拨出延迟	设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件在检测到触发器后立即启动。延迟屏幕显示倒数计时器，允许用户取消由操作按钮触发的操作。在自定义服务方案中，显示延迟屏幕时，Cisco 无线电话 9821 会持续振动。
服务触发器	从列表中选择触发器：单按、长按或按 3 次。

多个事件参数设置的单个触发器

多个事件的单个触发器允许作按钮上的一个作同时启动多个相关进程。此功能增强了响应能力，降低了复杂性，并确保跨应用程序的无缝工作流执行。

配置以下参数以将多个事件分配给触发器。

表 3. 多个事件参数设置的单个触发器
参数	设置
操作按钮功能	选择自定义。
操作按钮服务目标	输入要呼叫的电话号码和 XML 服务 URL，格式如下： `tel：<phonenumber 或 SIP URI> + <serviceURL>` URL 必须以 `http:// 或` https:// 开头。例如： `tel：1234 + https://10.11.20.159/path/service.xml`
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。如果未指定名称，将使用自定义服务作为显示名称。
自定义内容字段	（可选）如果您希望电话能够在按下操作按钮时发送 HTTP POST 请求，请输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。有关 POST 脚本示例和语法，请参阅作按钮的 HTTP POST 请求。
拨出延迟	设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件在检测到触发器后立即启动。延迟屏幕显示倒数计时器，允许用户取消由操作按钮触发的操作。在紧急呼叫和自定义服务场景中，显示延迟屏幕时，Cisco 无线电话 9821 会持续振动。但是，对于静默紧急呼叫或信号，Cisco 无线电话 9821 不会振动。
服务触发器	从列表中选择触发器：单按、长按或按 3 次。
无声紧急呼叫	（可选）默认情况下，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。启用静默紧急呼叫后，主叫方端的音频将保持静音，以免在通话期间引起注意。只有呼叫接收方可以结束静默紧急呼叫。在无声紧急呼叫期间，Cisco 无线电话 9821 屏幕将被关闭。所有其他功能都无法访问。在接收者结束呼叫后，电话将恢复正常作。
允许静默紧急呼叫取回	（可选）如果您允许用户在保持紧急呼叫的同时按任意键来恢复电话的正常操作，请启用此功能。呼叫音频将保持静音，除非用户使用音量键提高扬声器音量。

配置多个触发器

您可以将作按钮配置为连接到多个服务，并为每个服务分配自己的触发器。例如，长按“作”按钮可呼叫指定的紧急代理；短按按钮 POST 向公司内的电话发送通知。

将服务触发器设置为多触发器。

选择“多重触发器 ”选项时，将仅应用“服务触发器”多触发器部分中的设置，而忽略该部分之外的“作”按钮的相关设置。
确保在选择“多重触发器 ”选项时至少配置一个触发器。

转到服务触发多触发器，然后从有空选项中选择所需的触发器 - 单按、长按和按 3 次。

为所选触发器配置以下参数：

表 4. 多个触发器参数设置
参数	设置
操作按钮功能	选择电话用户可通过触发器访问的服务。
操作按钮服务目标	输入电话号码或服务的 URI。
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。如果未指定名称，将使用自定义服务作为显示名称。
自定义内容字段	（可选）如果您希望电话能够在按下操作按钮时发送 HTTP POST 请求，请输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。有关 POST 脚本示例和语法，请参阅作按钮的 HTTP POST 请求。
拨出延迟	设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件在检测到触发器后立即启动。延迟屏幕显示倒数计时器，允许用户取消由操作按钮触发的操作。在紧急呼叫和自定义服务场景中，显示延迟屏幕时，Cisco 无线电话 9821 会持续振动。但是，对于静默紧急呼叫或信号，Cisco 无线电话 9821 不会振动。
无声紧急呼叫	（可选）默认情况下，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。启用静默紧急呼叫后，主叫方端的音频将保持静音，以免在通话期间引起注意。只有呼叫接收方可以结束静默紧急呼叫。在无声紧急呼叫期间，Cisco 无线电话 9821 屏幕将被关闭。所有其他功能都无法访问。在接收者结束呼叫后，电话将恢复正常作。
允许静默紧急呼叫取回	（可选）如果您允许用户在保持紧急呼叫的同时按任意键来恢复电话的正常操作，请启用此功能。呼叫音频将保持静音，除非用户使用音量键提高扬声器音量。

继续执行步骤 2 和 3 以配置更多触发器。

对“作”按钮的 HTTP POST 请求

Cisco 无线电话 9821 上的操作按钮可配置为通过 HTTP POST 请求触发 XML 应用程序。

在自定义内容字段中，输入请求脚本。您可以指定 XML 或 JSON 内容类型，并在请求中包含宏。

以下示例位于 XML 和 JSON 中：

示例 #1：XML -- 方法 POST --header 'Content-Type：application/XML' --body '<MetaData><Trigger>True</Trigger><Description>这是针对 HTTP POST XML</Description></MetaData>' 示例 #2：JSON -- 方法 POST --header 'Content-Type：application/json' --body '{“events”：[{“evtid”：“12345”，“parameters”：{“trigger”：true}，“Description”：“This is for HTTP POST JSON”}]}'

以下示例适用于 HTTP POST 请求。

-- 方法 POST --header 'Content-Type：application/XML' --body '<MetaData><Trigger>True</Trigger><Description>这是针对 HTTP POST XML</Description></MetaData>'

表 5. 支持的宏
宏名称	宏扩展
#DEVICENAME#	呼叫系统中显示的设备名称；例如，SEP845A3EC21288
$MA	使用小写十六进制数字的 MAC 地址 (000e08aabbcc)。
$MCASTADDR	组播寻呼应用程序的地址。
$PN $PSN	产品名称；例如，DP-9851、DP-9871。
$SN	序列号字符串；例如，FVH28022D0T。

XML URL 中支持的宏变量

您可以使用 XML URL 中的宏变量。支持以下宏变量：

用户 ID — UID1、UID2 至 UIDn
显示名称 — DISPLAYNAME1、DISPLAYNAME2 至 DISPLAYNAMEn
验证 ID — AUTHID1、AUTHID2 至 AUTHIDn
代理 — PROXY1、PROXY2 至 PROXYn
使用小写十六进制数字的 MAC 地址 — MA
产品名称 — PN
产品序列号 — PSN
序列号 — SERIAL_NUMBER

表 6. 支持的宏
宏名称	宏扩展
$	$$ 扩展为单个 $ 字符。
A through P	替换为通用参数 GPP_A 至 GPP_P。
SA through SD	替换为专用参数 GPP_SA 至 GPP_SD。这些参数存有在设置过程中使用的密钥或密码。 $SA 至 $SD 被认为是传递给可选重新同步 URL 限定符 — 密钥 — 的参数。
MA	使用小写十六进制数字的 MAC 地址 (000e08aabbcc)。
MAU	使用大写十六进制数字的 MAC 地址 (000E08AABBCC)。
MAC	使用小写十六进制数字并用冒号分隔数字对的 MAC 地址 (00:0e:08:aa:bb:cc)。
PN	产品名称；例如，Cisco 无线电话 9821。
PSN	产品系列号；例如，9821。
SN	序列号字符串；例如，FVH29513116。
CCERT	SSL 客户端证书状态，安装或未安装。
IP	电话在其本地子网内的 IP 地址；例如，192.168.1.100。
EXTIP	电话的外部 IP（在 Internet 上显示的 IP）；例如，66.43.16.52。
SWVER	软件版本字符串。例如，PHONEOS-9821.5-0-1-0004-19。
HWVER	硬件版本字符串。例如 2.0.1
PRVST	部署状态（数字字符串）： -1 = 显式重新同步请求 0 = 接通电源时重新同步 1 = 定期重新同步 2 = 重新同步失败，重试
UPGST	升级状态（数字字符串）： 1 = 第一次升级尝试 2 = 升级失败，重试
UPGERR	上次升级尝试的结果消息（错误）；例如，http_get 失败。
PRVTMR	距离上次重新同步尝试的秒数。
UPGTMR	距离上次升级尝试的秒数。
REGTMR1	线路 1 丢失在 SIP 服务器的注册信息后经历的秒数。
REGTMR2	线路 2 丢失在 SIP 服务器的注册信息后经历的秒数。
UPGCOND	原来的宏名称。
SCHEME	文件访问方案，TFTP、HTTP 或 HTTPS 之一，在解析重新同步或升级 URL 后获得。
SERV	请求目标服务器主机名，在解析重新同步或升级 URL 后获得。
SERVIP	请求目标服务器 IP 地址，在解析重新同步或升级 URL 后获得，可能在 DNS 查找之后。
PORT	请求目标 UDP/TCP 端口，在解析重新同步或升级 URL 后获得。
PATH	请求目标文件路径，在解析重新同步或升级 URL 后获得。
ERR	重新同步或升级尝试的结果消息。只有助于生成结果系统日志消息。尝试升级时，值将保留在 UPGERR 变量中。
UIDn	线路 n UserID 配置参数的内容。
ISCUST	如果已对设备进行自定义，则值 = 1，否则值为 0。可在“Web UI 信息”页上查看自定义状态。
INCOMINGNAME	与第一个已接通、振铃或入站呼叫相关联的名称。
REMOTENUMBER	第一个已接通、振铃或入站呼叫的电话号码。如果有多个呼叫，会提供与找到的第一个呼叫相关的数据。
DISPLAYNAMEn	线路 N“显示名称”配置参数的内容。
AUTHIDn	线路 N“验证 ID”配置参数的内容。

Cisco AI Assistant

感谢您的反馈。