自定义“作”按钮

Cisco Desk Phone 9800 系列上作按钮的自定义选项需要特定的 PhoneOS 固件支持。 有关详细信息,请参阅下表:

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

登录 Cisco Unified Communications Manager 管理。

2

根据需要执行以下作之一:

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

配置遵循分层结构:

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

3

根据您的使用案例,使用以下参数自定义作按钮设置。

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

  • 紧急呼叫

    配置以下参数:

    • 作按钮功能:选择 紧急呼叫

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

    • 作按钮服务名称 (可选):指定与作触发器关联的服务的名称。 当用户按下按钮时,此名称将显示在屏幕上的消息中,指示将启动哪个事件。 如果未指定名称, 将使用紧急呼叫 作为显示名称。

    • 拨出延迟:设置电话在检测到触发器后发起紧急呼叫的超时时间(秒)。 默认值为 5 秒。 如果设置为 0,则在检测到触发器后立即发起呼叫。

    • 服务触发器 从列表中选择触发器: 单按长按按 3 次

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

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

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

  • 定制服务

    配置以下参数:

    • 作按钮功能:选择 自定义

    • 作按钮服务目标:输入自定义服务的 URL。 URL 必须以 http:// 或 https:// 开头,例如 https://10.11.20.159/path/service.xml

    • 作按钮服务名称 (可选):指定与触发器关联的服务的名称。 当用户按下按钮时,此名称将显示在屏幕上的消息中,指示将触发哪个服务。 如果未指定名称, 将使用自定义服务 作为显示名称。

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

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

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

    • 服务触发器 从列表中选择触发器: 单按长按按 3 次

    • 服务机密 (可选):如果自定义服务需要身份验证才能访问,则输入身份验证密钥、令牌或密码。 输入的密钥显示为屏蔽字符串,可以使用自定义内容字段 作按钮服务目标 中的$SS引用。

  • 多个触发器

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

  • 多个事件的单个触发器

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

    • 作按钮功能:选择 自定义

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

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

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

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

    • 作按钮服务名称 (可选):指定与触发器关联的服务的名称。 当用户按下按钮时,此名称将显示在屏幕上的消息中,指示将触发哪个服务。 当未指定名称时,将使用 自定义服务 作为显示名称。

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

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

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

    • 服务触发器 从列表中选择一个触发器: 单击长按按 3 次

    • 服务机密 (可选):如果您的自定义服务需要身份验证才能访问,请输入身份验证机密、令牌或密码。 输入的机密显示为屏蔽字符串,可使用宏 $SS自定义内容字段操作按钮服务目标中进行引用。

    • 静默紧急呼叫 (可选):如果您在服务目的地中包含了电话号码或拨号 URI,启用此功能将使紧急呼叫保持静默。

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

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

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

有关这些参数的更多信息,请参阅 操作按钮的参数

4

选择保存

5

选择应用配置

参考资料

操作按钮的参数

这些参数在企业电话配置、通用电话配置文件和个人电话配置中可用。

表 1. 操作按钮的参数
参数默认和选项说明
动作按钮功能1~3

默认值:关

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

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

  • 关闭:设置为关闭时,手机上单项服务的操作按钮将不起作用。
  • 紧急呼叫:用户可以使用“操作”按钮拨打紧急呼叫(如果已配置)。
  • 自定义:如果已配置,用户可以使用操作按钮访问自定义服务。

当您将字段设置为 紧急呼叫自定义时,请确保在 操作按钮服务目的地 字段中输入服务目的地。 或者,手机将显示配置错误。

操作按钮服务名称1~3

默认值:空

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

如果您未指定名称,则默认名称将为“紧急呼叫”、“静默紧急呼叫”或“自定义操作”,具体取决于您在 操作按钮功能 字段中的选择。

操作按钮 服务目的地 1~3

默认值:空

根据分配给操作按钮的服务,以下列格式之一提供服务目的地:

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

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

  • 要将按钮配置为通过单个触发器启动多个事件,请输入 tel:<phonenumber or SIP URL> + <Service RUL>例如tel:1234 + https://10.11.20.159/path/service.xml

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

如果您启用“操作”按钮但没有设置有效的服务目的地,电话上的用户将看到一条提示配置的消息。 用户关闭此通知后,警告图标将一直保留在手机屏幕的标题栏中,直到按钮被正确配置或禁用。

电话号码不能用作定制服务的目的地。 如果您将操作按钮配置为 自定义 并输入电话号码作为服务目的地,则电话上将显示一条警告消息,表明该按钮未配置。 相反,您可以采用以下格式添加电话号码 tel:<电话号码> , 例如, tel:1234

如果不允许输入包含与号 (&) 的 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 数据,最大长度为 1024 个字符。 配置完成后,按下操作时手机会发送 HTTP Post 请求。

如果服务需要身份验证才能访问,请确保在 服务机密 场地。 在 HTTP 数据中,使用宏 $SS 作为服务秘密的参考。

有关示例和语法,请参阅 操作按钮的 HTTP Post 请求

服务秘密1~3

默认值:空

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

服务触发器1~3

默认:单击

选项:单击、长按、按3次

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

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

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

按 3 次:按 Action 按钮 3 次,每次按下之间的间隔少于 2 秒,以触发关联的呼叫或服务。

不要跨多个服务重复触发器,因为优先级较低的参数将不起作用。 优先级顺序(从最高到最低)如下:组 1、组 2、组 3。

拨出延迟 1~3

默认值:5

选项:0 - 30

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

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

无声紧急呼叫 1~3

默认值:Disabled

选项:启用、禁用

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

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

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

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

允许静默紧急呼叫取回

默认值: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 --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 Communications Manager(UCM)要求根据 RFC 3986 对保留字符进行百分比编码。

表 2. 保留字符的编码百分比
字符百分比编码
&amp;%26
'%27
&quot;%22
< %3c
> %3e

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

--method 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
表 3. 支持的宏
宏名称宏扩展
#DEVICENAME#呼叫系统中显示的设备名称。 例如,SEP845A3EC21288
$SS服务机密,在电话配置页面中显示屏蔽字符串,例如身份验证机密、令牌或密码。