配置操作按钮（统一配置管理）

操作按钮是位于 Cisco 无线电话 9821 右侧的红色按钮。它使用户能够快速访问指定的服务，例如紧急服务或定制服务。您可以自定义按钮，以触发适合您特定使用场景的事件。

自定义操作按钮

1	在 Cisco Unified Communications Manager 管理界面中，根据需要执行以下操作之一：要配置所有已部署的电话，请转到系统 > 企业电话配置。要配置共享同一手机配置文件的手机，请转到设备 > 设备设置 > 通用手机配置文件。要配置单个手机，请转到设备 > 电话。然后找到你的手机并打开手机配置页面。该配置遵循层级结构：设备个人设置优先于通用手机配置文件和企业级设置。通用电话配置文件设置会覆盖企业级设置。
2	根据您的使用场景自定义操作按钮参数。 “操作”按钮有三组参数，每组参数对应一个具有唯一触发器的服务。如果在多个组中指定了服务触发器，则第 1 组的设置优先于第 2 组和第 3 组的设置，而第 2 组的设置优先于第 3 组。紧急呼叫定制服务多重触发单个触发器触发多个事件有关这些参数的更多信息，请参阅产品特定配置参数。
3	选择保存。
4	选择应用配置。

紧急呼叫参数设置

请配置以下紧急呼叫参数。

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

自定义服务参数设置

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

表2。自定义服务参数设置
参数	设置
操作按钮功能	选择自定义。
操作按钮服务目标	请输入自定义服务的网址。URL 必须以 `http://` 或 `https://`开头，例如 `https://10.11.20.159/path/service.xml`。
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，屏幕上将显示此名称，指示将触发哪个服务。如果没有指定名称，则使用自定义服务作为显示名称。
自定义内容字段	（可选）如果您希望手机在按下操作按钮时发送 HTTP Post 请求，请输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。有关 POST 脚本示例和语法，请参阅操作按钮的 HTTP Post 请求。
拨号延迟	设置手机在检测到触发信号后发起事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件会在检测到触发后立即启动。延迟屏幕会显示倒计时计时器，允许用户取消由操作按钮触发的操作。在自定义服务场景中，思科无线电话 9821 会持续振动，同时显示延迟屏幕。
服务触发器	从列表中选择一个触发器：单次按下，长按，或三次按下。
机密	设置一个密钥字符串，它可以是身份验证密钥、令牌或密码。输入的密钥显示为掩码字符串，可以使用宏 `$SS` 在自定义内容字段和操作按钮服务目标中引用。

多重触发器参数设置

分别设置各组的参数。请参阅上方的 紧急呼叫 和 定制服务 部分。

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

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

表3。单个触发器用于多个事件参数设置
参数	设置
操作按钮功能	选择自定义。
操作按钮服务目标	请按以下格式输入要拨打的电话号码和 XML 服务 URL： `tel: +` URL 必须以 `http://` 或 `https://`开头。例如： `tel:1234 + https://10.11.20.159/path/service.xml`
操作按钮服务名称	（可选）指定与触发器关联的服务的名称。当用户按下按钮时，屏幕上将显示此名称，指示将触发哪个服务。如果没有指定名称，则使用自定义服务作为显示名称。
自定义内容字段	（可选）如果您希望手机在按下操作按钮时发送 HTTP Post 请求，请输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。有关 POST 脚本示例和语法，请参阅操作按钮的 HTTP Post 请求。
拨号延迟	设置手机在检测到触发信号后发起事件的超时时间（以秒为单位）。默认值为 5 秒。设置为 0 时，事件会在检测到触发后立即启动。延迟屏幕会显示倒计时计时器，允许用户取消由操作按钮触发的操作。在紧急呼叫和自定义服务场景中，思科无线电话 9821 会持续振动，同时显示延迟屏幕。但是，对于无声紧急呼叫或信号，思科无线电话 9821 不会振动。
服务触发器	从列表中选择一个触发器：单次按下，长按，或三次按下。
机密	设置一个密钥字符串，它可以是身份验证密钥、令牌或密码。输入的密钥显示为掩码字符串，可以使用宏 `$SS` 在自定义内容字段和操作按钮服务目标中引用。
无声紧急呼叫	（可选）默认情况下，紧急呼叫功能为双向呼叫，类似于其他拨出电话。启用静音紧急呼叫后，呼叫方的声音将保持静音，以避免在通话过程中引起注意。只有通话接收者才能结束静音紧急呼叫。在进行静默紧急呼叫时，思科无线电话 9821 的屏幕将关闭。其他所有功能均无法使用。通话结束后，手机恢复正常运行。
允许静默紧急呼叫检索	（可选）如果您允许用户在保持紧急呼叫的同时按任意键恢复正常电话操作，请启用此功能。除非用户使用音量键调高扬声器音量，否则通话音频将保持静音。

操作按钮的 HTTP POST 请求

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

在自定义内容字段中，输入您的自定义请求脚本。您可以指定 XML 或 JSON 内容类型，并在请求中包含宏。例如，可以在脚本中添加 $SS来检索在服务密钥字段中提供的身份验证密钥、令牌或密码。

以下示例采用 XML 和 JSON 格式：

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}'

Cisco Unified CM 要求按照 RFC 3986 对保留字符进行百分比编码。

表 4. 保留字符的百分比编码
特点	百分比编码
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

以下脚本是使用百分比编码字符串的示例。

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27

表 5. 支持的宏
宏名称	宏观扩张
#DEVICENAME#	呼叫系统中显示的设备名称。例如，SEP845A3EC21288
$SS	服务密钥，即在手机配置页面中显示的掩码字符串，例如身份验证密钥、令牌或密码。

Cisco AI Assistant

感谢您的反馈。

自定义操作按钮

紧急呼叫参数设置

自定义服务参数设置

多重触发器参数设置

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

操作按钮的 HTTP POST 请求

小型企业

大型企业

设备

解决方案

资源

公司