- 主页
- /
- 文章
感谢您的反馈。
为 9800（Unified CM）
在此文章中
反馈？作按钮是位于电话右上角的红色按钮。 它允许用户快速访问指定的服务，例如紧急或自定义服务。 您可以自定义按钮以启动适合您的特定用例的事件。 此页面上的信息适用于注册到 Cisco Unified Communications Manager（Unified CM）的 Cisco Desk Phone 9800 系列。
自定义“作”按钮
Cisco Desk Phone 9800 系列上的作按钮的自定义选项需要特定的 PhoneOS 固件支持。 有关详细信息，请参阅下表：
| 功能 | 所需的固件版本 |
|---|---|
| 紧急呼叫 | PhoneOS 3.0.1 及更高版本 |
| 定制服务 | PhoneOS 3.2.1 及更高版本 |
| 多个触发器 | PhoneOS 3.3.1 及更高版本 |
| HTTP POST | PhoneOS 3.3.1 及更高版本 |
| 单个触发器上的多个事件 | PhoneOS 3.4.1 及更高版本 |
| 1 |
登录 Cisco Unified Communications Manager 管理。 |
| 2 |
根据需要执行以下作之一：
配置遵循分层结构：
|
| 3 |
根据您的使用案例，使用以下参数自定义作按钮设置。 “作”按钮有三组参数，每组参数对应于具有唯一触发器的服务。 如果在多个组中指定了服务触发器，则组 1 中的设置优先于组 2 和 3 中的设置，而组 2 中的设置优先于组 3。
有关这些参数的详细信息，请参阅 作按钮的参数。 |
| 4 |
选择保存。 |
| 5 |
选择应用配置。 |
参考资料
作按钮的参数
这些参数有空在企业电话配置、通用电话档案和个人电话配置中。
| 参数 | 默认值和选项 | 说明 |
|---|---|---|
| 作按钮功能 1~3 |
默认值：关 选项：关闭、紧急呼叫、自定义 |
您可以使用特定服务配置按钮。
当您将该字段 设置为“紧急呼叫 ”或 “自定义”时，请确保在“ 作按钮服务目标 ”字段中输入服务目标。 或者，电话将显示配置错误。 |
| 作按钮服务名称 1~3 |
默认值：空 |
（可选）指定与作按钮关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。 如果您不指定名称，缺省名称将为紧急呼叫、静默紧急呼叫或自定义作（基于您在作按钮功能 字段中的选择 ）。 |
| 作按钮服务目标 1~3 |
默认值：空 |
根据分配给“作”按钮的服务，以下列格式之一提供服务目标：
如果在未设置有效服务目标的情况下启用作按钮，电话上的用户将看到一条提示进行配置的消息。 用户关闭此通知后，警告图标将始终保留在电话屏幕的标题中，直到正确配置或禁用该按钮。 电话号码不能用作自定义服务的目标。 如果您将作按钮 配置为自定义 并输入电话号码作为服务目标，电话上将显示一条警告消息，指示该按钮未配置。 相反，您可以按以下格式 如果不允许输入包含与号（&）的 URL，请使用 %26 作为替换。 例如，输入 http://1.2.3.4/phone?a=1%26b=2%26c=3 而不是 http://1.2.3.4/phone?a=1&b=2&c=3。 |
| 自定义内容字段 1~3 |
默认值：空 |
仅当“ 作按钮功能 ”设置为 “自定义”时，此设置才有效。 输入 HTTP 数据，例如方法、标头和 POST 内容，最大长度为 1024 个字符。 配置后，电话会在按下作时发送 HTTP POST 请求。 如果服务需要身份验证才能访问，请确保在“ 服务机密 ”字段中输入身份验证机密。 在 HTTP 数据中，使用宏 有关示例和语法，请参阅 “作”按钮的 HTTP POST 请求。 |
| 服务机密 1~3 |
默认值：空 |
服务密钥可以是身份验证密钥、令牌或密码。 输入的密钥显示为屏蔽字符串，可以使用自定义内容字段 |
| 服务触发器 1~3 |
默认：单按 选项：单按、长按、按 3 次 |
选择用户如何使用电话的作按钮拨打紧急呼叫或启动自定义服务。 单按：按作按钮以触发关联的呼叫或服务。 长按：按住作按钮至少 2 秒钟以触发关联的呼叫或服务。 按 3 次：按 Action 按钮 3 次，每次按下之间的间隔少于 2 秒，以触发关联的呼叫或服务。 不要跨多个服务重复触发器，因为优先级较低的参数将不起作用。 优先级顺序（从最高到最低）如下：组 1、组 2、组 3。 |
| 拨出延迟 1~3 |
默认值：5 选项：0 - 30 |
设置电话在按下作按钮后发起紧急呼叫或自定义作的超时时间（秒）。 如果您希望电话在检测到触发器后立即发起呼叫或启动事件，请将其设置为 0，具体方法是按一下、长按或按三次按钮。 |
| 无声紧急呼叫 1~3 |
默认值：Disabled 选项：启用、禁用 |
静音紧急呼叫专为在危险情况下提供谨慎的帮助而设计。 它使用户能够在不发出任何噪音的情况下寻求帮助。
|
| 允许静默紧急呼叫取回 |
默认值：No 选项：Yes, No |
控制用户是否可以在静默紧急呼叫期间检索电话功能。 缺省情况下，一旦发起静默紧急呼叫，电话将锁定所有功能，直到呼叫接收方结束呼叫。 当该参数设置为 是时，用户可以按任意键以恢复电话的正常作，同时保持紧急呼叫。 呼叫音频将保持静音，除非用户使用音量键提高音量。 |
对“作”按钮的 HTTP POST 请求
Cisco Desk Phone 9800 系列上的作按钮可配置为通过 HTTP POST 请求触发 XML 应用程序。
在 自定义内容字段中，输入您的自定义请求脚本。 您可以指定 XML 或 JSON 内容类型，并在请求中包含宏。 例如，可以将$SS 添加到脚本中，以检索“服务机密 ” 字段中提供的身份验证密码、令牌或密码。
以下示例位于 XML 和 JSON 中：
示例 #1：XML -- 方法 POST --header 'Content-Type：application/XML' --header 'Authorization：Bearer username：$SS' --body '<MetaData><Trigger>True</Trigger><Description>这是针对 HTTP POST XML</Description></MetaData>' 示例 #2：JSON -- 方法 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 Communications Manager（UCM）要求根据 RFC 3986 对保留字符进行百分比编码。
| 字符 | 百分比编码 |
|---|---|
| & | %26 |
| ' | %27 |
| " | %22 |
| < |
%3c |
| > |
%3e |
以下脚本是使用百分比编码字符串的示例。
-- 方法 POST --header %27Content-Type：application/XML%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3e 这是针对 HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27| 宏名称 | 宏扩展 |
|---|---|
| #DEVICENAME# | 呼叫系统中显示的设备名称。 例如，SEP845A3EC21288 |
| $SS | 服务机密，在电话配置页面中显示屏蔽字符串，例如身份验证机密、令牌或密码。 |
