在此文章中
dropdown icon
自定义“作”按钮
    紧急呼叫参数设置
    自定义服务参数设置
    多个触发器参数设置
    多个事件参数设置的单个触发器
对“作”按钮的 HTTP POST 请求
配置操作按钮 (Unified CM)
list-menu在此文章中
list-menu反馈?

本帮助文章适用于注册到 Cisco Unified Communications Manager (Unified CM) 的 Cisco 无线电话 9821。

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

自定义“作”按钮

1

在 Cisco Unified Communications Manager Administration 中,根据需要执行以下操作之一:

  • 要配置所有已部署的电话,请转至 系统 > 企业电话配置。
  • 要配置共享同一电话配置文件的电话,请转至 设备 > 设备设置 > 通用电话配置文件。
  • 要配置单个电话,请转至 设备 > 电话。 然后找到您的电话并打开“电话配置”页面。

配置遵循分层结构:

  • 单个设备设置优先于通用电话配置文件和企业级中的设置
  • 通用电话档案设置会覆盖企业级设置

2

根据您的使用案例自定义操作按钮参数。

“作”按钮有三组参数,每组参数对应于具有唯一触发器的服务。 如果在多个组中指定了服务触发器,则组 1 中的设置优先于组 2 和 3 中的设置,而组 2 中的设置优先于组 3。

有关这些参数的详细信息,请参阅 产品特定配置参数。

3

选择保存。

4

选择应用配置。

紧急呼叫参数设置

配置以下紧急呼叫参数。

表 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 次。

服务机密

设置机密字符串,可以是身份验证机密、令牌或密码。 输入的密钥显示为屏蔽字符串,可以使用自定义内容字段 和 作按钮服务目标 中的 宏 $SS引用。

多个触发器参数设置

分别设置每个组中的参数。 请参阅上面的紧急呼叫 和 自定义服务 部分。

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

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

表 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 次。

服务机密

设置机密字符串,可以是身份验证机密、令牌或密码。 输入的密钥显示为屏蔽字符串,可以使用自定义内容字段 和 作按钮服务目标 中的 宏 $SS引用。

无声紧急呼叫

(可选)默认情况下,紧急呼叫充当双向呼叫,与其他呼出呼叫类似。 启用静默紧急呼叫后,主叫方端的音频将保持静音,以免在通话期间引起注意。 只有呼叫接收方可以结束静默紧急呼叫。

在无声紧急呼叫期间,Cisco 无线电话 9821 屏幕将被关闭。 所有其他功能都无法访问。 在接收者结束呼叫后,电话将恢复正常作。

允许静默紧急呼叫取回

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

对“作”按钮的 HTTP POST 请求

Cisco Wireless Phone 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 '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

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服务机密,在电话配置页面中显示屏蔽字符串,例如身份验证机密、令牌或密码。
这篇文章对您有帮助吗?
这篇文章对您有帮助吗?