Cisco 台式电话 9800 系列上的操作按钮的自定义选项需要特定的 PhoneOS 固件支持。 详情请参阅下表：

功能所需固件版本
紧急呼叫PhoneOS 3.0.1 及更高版本
定制服务PhoneOS 3.2.1 及更高版本
多个触发器PhoneOS 3.3.1 及更高版本
HTTP 帖子PhoneOS 3.3.1 及更高版本
单个触发器上的多个事件PhoneOS 3.4.1 及更高版本

配置紧急呼叫的操作按钮

紧急呼叫的操作按钮可确保您在工作场所快速轻松地获得关键帮助。

1

从客户角度来看 控制中心，前往 设备，然后选择您的手机。

2

选择 所有配置。

3

导航至 电话 部分并选择 动作按钮。

4

配置以下参数：

  • 操作按钮功能： 选择 紧急呼叫。

  • 操作按钮服务目的地：输入紧急服务的电话号码或URI。

  • 操作按钮服务名称 （可选）：指定与操作触发器关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕消息中，指示将启动哪个事件。 如果没有指定名称， 紧急呼叫 将用作显示名称。

  • 拨出延迟：设置手机检测到触发后发起紧急呼叫的超时时间（以秒为单位）。 默认值为 5 秒。 如果设置为 0，则在检测到触发器时立即拨打电话。

  • 服务触发器 从列表中选择一个触发器： 单击， 长按， 或者 按3次。

  • 静默紧急呼叫 （可选）：默认情况下，紧急呼叫为双向呼叫，与其他拨出呼叫类似。 启用静音紧急呼叫后，呼叫方的音频将保持静音，以避免在通话过程中引起注意。 只有呼叫接收者可以结束静默紧急呼叫。

    静默紧急呼叫期间，9841 手机屏幕将冻结，9851、9861 和 9871 手机屏幕将关闭。 所有其他功能均无法访问。 接听者结束通话后，手机恢复正常运行。

  • 允许静默检索紧急呼叫 （可选）：如果您允许用户在保持紧急呼叫的同时按任意键恢复正常电话操作，请启用此功能。 除非用户使用音量键增加扬声器音量，否则通话音频将保持静音。

有关这些参数的更多详细信息，请参阅 操作按钮的参数。

5

选择下一步。

6

查看更改并选择 申请。

7

选择 关闭 关闭页面。

为自定义服务配置操作按钮

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

1

从客户角度来看 控制中心，前往 设备，然后选择您的手机。

2

选择 所有配置。

3

导航至 电话 部分并选择 操作按钮。

4

配置以下参数以将操作按钮与自定义服务关联。

  • 操作按钮功能： 选择 风俗。

  • 操作按钮服务目的地：输入自定义服务的URL。 URL 必须以 http:// 或者 https:// ， 例如， https://10.11.20.159/path/service.xml 。

  • 操作按钮服务名称 （可选）：指定与触发器关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕消息中，指示将触发哪个服务。 当未指定名称时， 定制服务 将用作显示名称。

  • 自定义内容字段 （可选）：如果您希望手机在按下操作按钮时能够发送 HTTP Post 请求，请输入方法、标头和 post 内容等 HTTP 数据，最大长度为 1024 个字符。

    有关 POST 脚本示例和语法，请参阅 操作按钮的 HTTP Post 请求。

  • 拨出延迟：设置手机检测到触发后发起事件的超时时间，以秒为单位。 默认值为 5 秒。 当设置为 0 时，在检测到触发后立即启动事件。

  • 服务触发器 从列表中选择一个触发器： 单击， 长按， 或者 按3次。

有关这些参数的更多详细信息，请参阅 操作按钮的参数。

5

选择下一步。

6

查看更改并选择 申请。

7

选择 关闭 关闭页面。

为多个事件配置单个触发器

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

1

从客户角度来看 控制中心，前往 设备，然后选择您的手机。

2

选择 所有配置。

3

导航到 “电话 ”部分并选择 作按钮。

4

配置以下参数以使作按钮一次触发多个事件。

  • 作按钮功能：选择 自定义。

  • 作按钮服务目标：输入要呼叫的电话号码和 XML 服务 URL，格式如下：

    tel：<phonenumber 或 SIP URI> + <serviceURL>

    URL 必须以 http:// 或 https:// 开头。

    例如： tel：1234 + https：//10.11.20.159/path/service.xml

  • 作按钮服务名称 （可选）：指定与作触发器关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。 如果未指定名称， 定制服务 将用作显示名称。

  • 自定义内容字段 （可选）：如果您希望电话在按下作按钮时发送 HTTP Post 请求，请输入 HTTP 数据，例如方法、标头和发布内容，最大长度为 1024 个字符。

    有关 POST 脚本示例和语法，请参阅 “作”按钮的 HTTP POST 请求。

  • 拨出延迟：设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。 默认值为 5 秒。 设置为 0 时，事件在检测到触发器后立即启动。

  • 服务触发器 从列表中选择触发器： 单按、 长按或 按 3 次。

  • 静默紧急呼叫 （可选）：如果您已在服务目标中包含电话号码或拨号 URI，启用此功能将使紧急呼叫无声。

    默认情况下，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。 当设置为启用时，主叫方的音频是静音的，以避免在通话期间引起注意。 只有呼叫接收方可以结束呼叫。

    在无提示紧急呼叫期间，电话 9841 上的屏幕将冻结，而电话 9851、9861 和 9871 上的屏幕将关闭。 所有其他功能都无法访问。 在接收者结束呼叫后，电话将恢复正常作。

  • 允许静默紧急呼叫取回 （可选）：如果您允许用户在保持紧急呼叫的同时按任意键来恢复电话的正常作，请启用此功能。 呼叫音频将保持静音，除非用户使用音量键提高扬声器音量。

有关这些参数的更多详细信息，请参阅 作按钮的参数。

5

选择下一步。

6

查看更改并选择 应用。

7

选择 关闭 以关闭页面。

配置多个触发器

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

1

从 Control Hub 中的客户视图，转至 设备，然后选择您的电话。

2

选择 “所有配置”。

3

导航到 “电话 ”部分并选择 作按钮。

4

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

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

  • 确保在选择“多重触发器 ”选项时 至少配置一个触发器。

5

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

6

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

  • 作按钮功能：选择电话用户可以通过触发器访问的服务。

  • 作按钮 服务目标：输入服务的电话号码或 URI。

  • 作按钮服务名称 （可选）：指定与作触发器关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。 如果未指定名称，则缺省名称将为“紧急呼叫”、“静默紧急呼叫”或“自定义作”（基于您在“作按钮功能” 字段中的选择 ）。

  • 自定义内容字段 （可选）：如果您希望电话在按下作按钮时发送 HTTP Post 请求，请输入 HTTP 数据，例如方法、标头和发布内容，最大长度为 1024 个字符。

    有关 POST 脚本示例和语法，请参阅 “作”按钮的 HTTP POST 请求。

  • 拨出延迟：设置电话在检测到触发器后启动事件的超时时间（以秒为单位）。 默认值为 5 秒。 设置为 0 时，事件在检测到触发器后立即启动。

  • 静默紧急呼叫（可选）：如果您已为紧急呼叫设置了作按钮，启用此功能将使紧急呼叫静音。

    默认情况下，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。 当设置为启用时，主叫方的音频是静音的，以避免在通话期间引起注意。 只有呼叫接收方可以结束呼叫。

    在无提示紧急呼叫期间，电话 9841 上的屏幕将冻结，而电话 9851、9861 和 9871 上的屏幕将关闭。 所有其他功能都无法访问。 在接收者结束呼叫后，电话将恢复正常作。

  • 允许静默紧急呼叫取回 （可选）：如果您允许用户在保持紧急呼叫的同时按任意键来恢复电话的正常作，请启用此功能。 呼叫音频将保持静音，除非用户使用音量键提高扬声器音量。

    此参数位于 作按钮 > 允许静默紧急呼叫检索。

有关这些参数的更多详细信息，请参阅 作按钮的参数。

7

重复步骤 5 到 6 以配置更多触发器。

8

选择下一步。

9

查看更改并选择 应用。

10

选择 关闭 以关闭页面。

参考资料

作按钮的参数

作按钮的参数可以在设备、位置和组织级别的配置中找到。

有关如何在位置和组织级别配置电话设置的更多信息，请参阅 在 Control Hub 上配置 Cisco Desk Phone 9800 系列。

表 1. 作按钮的参数
参数默认值和选项说明
作按钮功能

默认值：关

选项：关闭、紧急呼叫、自定义

您可以使用特定服务配置按钮。

  • 关闭：设置为关闭时，电话上单个服务的作按钮将不起作用。
  • 紧急呼叫：如果已配置，用户可以使用“作”按钮发起紧急呼叫。
  • 自定义：用户可以使用“作”按钮访问自定义服务（如果已配置）。

当您将该字段 设置为“紧急呼叫 ”或 “自定义”时，请确保在“ 作按钮服务目标 ”字段中输入服务目标。 或者，电话将显示配置错误。

作按钮服务目标

默认值：空

根据分配给“作”按钮的服务，以下列格式之一提供服务目标：

  • 对于紧急呼叫服务，输入电话号码或紧急服务的 URI。

  • 为自定义服务配置按钮时，输入服务 URL。 URL 必须以 http:// 或 https:// 开头。 例如， https：//10.11.20.159/path/service.xml。

  • 要将按钮配置为使用单个触发器启动多个事件，请输入 tel：<电话号码或 SIP URL> + <Service RUL>。 例如： tel：1234 + https：//10.11.20.159/path/service.xml.

    还支持呼叫 SIP URI。 以 tel： sip 4567@co.webex.com 格式输入 URI

    有关多个事件的单个触发器的详细信息，请参阅 为多个事件配置单个触发器。

如果在未设置有效服务目标的情况下启用作按钮，电话上的用户将看到一条提示进行配置的消息。 用户关闭此通知后，警告图标将始终保留在电话屏幕的标题中，直到正确配置或禁用该按钮。

电话号码不能用作自定义服务的目标。 如果您将作按钮 配置为自定义 并输入电话号码作为服务目标，电话上将显示一条警告消息，指示该按钮未配置。 相反，您可以按以下格式 添加电话号码 tel：<phone number>，例如 tel：1234。

作按钮服务名称

默认值：空

（可选）指定与作按钮关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。

如果您不指定名称，缺省名称将为紧急呼叫、静默紧急呼叫或自定义作（基于您在作按钮功能 字段中的选择 ）。

允许静默紧急呼叫取回

默认值：No

选项：Yes, No

控制用户是否可以在静默紧急呼叫期间检索电话功能。 缺省情况下，一旦发起静默紧急呼叫，电话将锁定所有功能，直到呼叫接收方结束呼叫。

当该参数设置为 是时，用户可以按任意键以恢复电话的正常作，同时保持紧急呼叫。 呼叫音频将保持静音，除非用户使用音量键提高音量。

自定义内容字段

默认值：空

仅当“ 作按钮功能 ”设置为 “自定义”时，此设置才有效。

输入 HTTP 数据，例如方法、标头和发布内容，最大长度为 1024 个字符。 配置后，电话会在按下作时发送 HTTP POST 请求。

您可以在 HTTP 数据中使用宏，例如 $MA、$SN。

有关 POST 脚本示例和语法，请参阅 “作”按钮的 HTTP POST 请求。

拨出延迟

默认值：5

选项： 0 - 30

设置电话在按下作按钮后发起紧急呼叫或自定义作的超时时间（秒）。

如果您希望电话在检测到触发器后立即发起呼叫或启动事件，请将其设置为 0，具体方法是按一下、长按或按三次按钮。

服务触发器

默认：单按

选项：单按、长按、按 3 次、 多触发器

选择用户如何使用电话的作按钮拨打紧急呼叫或启动自定义服务。

单按：按作按钮以触发关联的呼叫或服务。

长按：按住作按钮至少 2 秒钟以触发关联的呼叫或服务。

按 3 次：按 Action 按钮 3 次，每次按下之间的间隔为 1 秒，以触发关联的呼叫或服务。

多触发器：选择此选项可将多个触发器和事件关联到作按钮。 转到服务 触发器多触发器 部分以选择触发器并配置特定设置。

有关多个触发器的详细信息，请参阅 配置多个触发器。

服务触发器多触发器选项：单按、长按、按 3 次

仅当服务触发器 设置为 多触发器 时，此设置才有效。

从可用选项中选择一个触发器以打开和配置设置。

有关多个触发器的详细信息，请参阅 配置多个触发器。

有关多触发器参数的详细信息，请参阅 多触发器参数。

无声紧急呼叫

默认值：Disabled

选项：启用、禁用

静音紧急呼叫专为在危险情况下提供谨慎的帮助而设计。 它使用户能够在不发出任何噪音的情况下寻求帮助。

  • 启用后，用户可使用作按钮发起单向呼叫。

    发出静默紧急呼叫后，只有另一方可以结束呼叫。 为避免在正在进行的呼叫中引起注意，电话 9841 上的屏幕将冻结，而电话 9851、9861 和 9871 上的屏幕将关闭。 缺省情况下，电话会在静默紧急呼叫期间锁定所有功能。 要允许用户在保持静默紧急呼叫的同时恢复正常的电话作，请启用 允许静默紧急呼叫取回 功能。

  • 禁用后，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。

表 2. 多触发器的参数
参数默认值和选项说明
作按钮功能

默认值：关

选项：关闭、紧急呼叫、自定义

选择电话用户可通过服务触发器访问的服务。

  • 关：设置为关时，动作触发器将不起作用。
  • 紧急呼叫：用户可以通过作触发器呼叫指定的紧急号码。
  • 自定义：用户可以通过作触发器访问指定的服务。

    当您将该字段 设置为“紧急呼叫 ”或 “自定义”时，请确保在 “作按钮服务目标 ”字段中输入正确的服务目标。 或者，电话将显示配置错误。

作按钮服务目标

默认值：空

提供电话号码、紧急呼叫 URI 或自定义服务的 URL。

如果输入服务 URL，该 URL 必须以 http:// 或 https:// 开头。

例如： https://10.11.20.159/path/service.xml。

电话号码不能用作自定义服务的目标。 如果您将作按钮 配置为自定义 并输入电话号码作为服务目标，电话上将显示一条警告消息，指示该按钮未配置。 相反，您可以按以下格式 添加电话号码 tel：<phone number>，例如 tel：1234。

作按钮服务名称

默认值：空

（可选）指定与作触发器关联的服务的名称。 当用户按下按钮时，此名称将显示在屏幕上的消息中，指示将触发哪个服务。

如果您不指定名称，缺省名称将为紧急呼叫、静默紧急呼叫或自定义作（基于您在作按钮功能 字段中的选择 ）。

自定义内容字段

默认值：空

仅当“ 作按钮功能 ”设置为 “自定义”时，此设置才有效。

输入 HTTP 数据，例如方法、标头和发布内容，最大长度为 1024 个字符。 配置后，电话会在按下作时发送 HTTP POST 请求。

您可以在 HTTP 数据中使用宏，例如 $MA、$SN。

有关 POST 脚本示例和语法，请参阅 “作”按钮的 HTTP POST 请求。

拨出延迟

默认值：5

选项：0 - 30

设置电话在按下作按钮后发起紧急呼叫或自定义作的超时时间（秒）。

如果您希望电话在检测到触发器后立即发起呼叫或启动事件，请将其设置为 0，具体方法是按一下、长按或按三次按钮。

无声紧急呼叫

默认值：Disabled

选项：启用、禁用

静音紧急呼叫专为在危险情况下提供谨慎的帮助而设计。 它使用户能够在不发出任何噪音的情况下寻求帮助。

  • 启用后，用户可使用作按钮发起单向呼叫。

    发出静默紧急呼叫后，只有另一方可以结束呼叫。 为避免在正在进行的呼叫中引起注意，电话 9841 上的屏幕将冻结，而电话 9851、9861 和 9871 上的屏幕将关闭。

    缺省情况下，电话会在静默紧急呼叫期间锁定所有功能。 要允许用户在保持静默紧急呼叫的同时恢复正常的电话作，请启用 允许静默紧急呼叫取回 功能。

  • 禁用后，紧急呼叫充当双向呼叫，与其他呼出呼叫类似。

作按钮的 HTTP POST 请求

Cisco Desk Phone 9800 系列上的作按钮可配置为通过 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 --method POST --header 'Content-Type：application/json' --body '{“events”：[{“evtid”：“12345”，“parameters”：{“trigger”：true}，“Description”：“This is for HTTP POST JSON”}]}'

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

--method POST --header 'Content-Type：application/xml' --body '<MetaData><Trigger>True</Trigger><Description>这是针对 HTTP POST XML</Description></MetaData>'
表 3. 支持的宏
宏名称宏扩展
#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

表 4. 支持的宏
宏名称宏扩展
$$$ 扩展为单个 $ 字符。
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产品名称；例如，可视电话 8875、座机 9851。
PSN产品系列号；例如 8875、9841、9861
SN序列号字符串；例如，88012BA01234。
CCERTSSL 客户端证书状态，安装或未安装。
IP电话在其本地子网内的 IP 地址；例如，192.168.1.100。
EXTIP电话的外部 IP（在 Internet 上显示的 IP）；例如，66.43.16.52。

SWVER

软件版本字符串。 例如，

PHONEOS.3-2-1-0104-37

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”配置参数的内容。