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

访问电话管理网页。

2

选择 Voice > Phone

3

导航至 作按钮 部分并配置以下参数以将作按钮与紧急服务链接。

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

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

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

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

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

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

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

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

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

您也可以通过输入以下字符串在电话配置 XML 文件(cfg.xml)中配置这些参数:

<!-- 作按钮 --> <Action_Button_Function ua=“na”>紧急呼叫</Action_Button_Function> <!-- 有空选项:关闭|紧急呼叫|自定义 --> <Action_Button_Service_Name ua=“na”>911</Action_Button_Service_Name> <Action_Button_Service_Destination ua=“na”>911</Action_Button_Service_Destination> <Service_Trigger ua=“na”>长按</Service_Trigger> <!-- 有空选项:单按|长按|按 3 次|多触发器 --> <Dial_Out_Delay ua=“na”>5</Dial_Out_Delay> <Silent_Emergency_Call ua=“na”>禁用</Silent_Emergency_Call> <!-- 有空选项:启用|禁用 --> <Allow_Silent_Emergency_Call_Retrieval ua=“na”>否</Allow_Silent_Emergency_Call_Retrieval> <!-- 有空选项:是|否 -->

4

完成后,单击 提交所有更改

将“作”按钮与自定义服务关联

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

1

访问电话管理网页。

2

选择 Voice > Phone

3

导航至 作按钮 部分并配置以下参数以将作按钮与服务关联。

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

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

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

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

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

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

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

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

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

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

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

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

您也可以通过输入以下字符串在电话配置 XML 文件(cfg.xml)中配置这些参数:

<!--作按钮 --> <Action_Button_Function ua=“na”>自定义</Action_Button_Function> <!-- 有空选项:关闭|紧急呼叫|Custom --> <Action_Button_Service_Name ua=“na”>Services</Action_Button_Service_Name> <Action_Button_Service_Destination ua=“na”>https://12.23.13.21/path/service.xml</Action_Button_Service_Destination> <Custom_Content_Field ua=“na”/> <Service_Secret ua=“na”/> <Service_Trigger ua=“na”>Long Press</Service_Trigger> <!-- 有空选项:单压|长按|按 3 次|MultiTrigger --> <Dial_Out_Delay ua=“na”>5</Dial_Out_Delay> 

4

完成后,单击 提交所有更改

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

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

1

访问电话管理网页。

2

选择 Voice > Phone

3

导航至 作按钮 部分并配置以下参数以将作按钮与服务关联。

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

  • 作按钮 服务目标:输入要呼叫的电话号码和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 时,事件在检测到触发器后立即启动。

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

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

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

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

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

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

您也可以通过输入以下字符串在电话配置XML文件 (cfg.xml) 中配置这些参数:

<!--作按钮 --> <Action_Button_Function ua=“na”>自定义</Action_Button_Function> <!-- 有空选项:关闭|紧急呼叫|Custom --> <Action_Button_Service_Name ua=“na”>Alert</Action_Button_Service_Name> <Action_Button_Service_Destination ua=“na”>tel:1234 + https://10.11.20.159/path/service.xml</Action_Button_Service_Destination> <Custom_Content_Field ua=“na”/> <!-- <Service_Secret ua=“na”/> --> <Dial_Out_Delay ua=“na”>5</Dial_Out_Delay> <Silent_Emergency_Call ua=“na”>Disabled</Silent_Emergency_Call> <!-- 有空选项:启用|禁用 --> <Allow_Silent_Emergency_Call_Retrieval ua=“na”>否</Allow_Silent_Emergency_Call_Retrieval> <Service_Trigger ua=“na”>按 3 次</Service_Trigger> <!-- 有空选项:单按|长按|按 3 次|多触发器 -->

4

完成后,单击 提交所有更改

配置多个触发器

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

1

访问电话管理网页。

2

选择 Voice > Phone

3

导航到 “作按钮” 部分,然后在“ 服务触发器 ”字段中选择 “多重触发 ”。

4

根据您的使用案例,在所需的触发器部分中配置参数。

以下参数在这些部分中有空 - 多触发器 - 单按多触发器 - 长按 和多触发器 - 按三次
  • 作按钮功能:选择电话用户可以通过触发器访问的服务。

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

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

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

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

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

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

  • 静默紧急呼叫(可选):如果您已为紧急呼叫设置了作按钮,启用此功能将使紧急呼叫静音。

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

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

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

    此参数位于 作按钮 部分。

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

您也可以通过输入以下字符串在电话配置XML文件 (cfg.xml) 中配置这些参数:

<!-- 多触发器 - 单按 --> <Action_Button_Function_1 ua=“na”>自定义</Action_Button_Function_1> <!-- 有空选项:关闭|紧急呼叫|Custom --> <Action_Button_Service_Name_1 ua=“na”>Notification</Action_Button_Service_Name_1> <Action_Button_Service_Destination_1 ua=“na”/>https://10.11.20.159/path/Messages.xml</Action_Button_Service_Destination_1>> <Custom_Content_Field_1 ua=“na”/> <Service_Secret_1 ua=“na”/> <Dial_Out_Delay_1 ua=“na”>5</Dial_Out_Delay_1> <Silent_Emergency_Call_1 ua=“na”>禁用</Silent_Emergency_Call_1> <!-- 有空选项:启用|禁用 --> <!-- 多重触发器 - 按三次 --> <Action_Button_Function_2 ua=“na”>自定义</Action_Button_Function_2> <!-- 有空选项:关闭|紧急呼叫|Custom --> <Action_Button_Service_Name_2 ua=“na”>IT Support</Action_Button_Service_Name_2> <Action_Button_Service_Destination_2 ua=“na”>https://10.11.20.159/path/support.xml</Action_Button_Service_Destination_2> <Custom_Content_Field_2 ua=“na”/> <Service_Secret_2 ua=“na”/> <Dial_Out_Delay_2 ua=“na”>5</Dial_Out_Delay_2> <Silent_Emergency_Call_2 ua=“na”>禁用</Silent_Emergency_Call_2> <!-- 有空选项:启用|禁用 --> <!-- 多触发器 - 长按 --> <Action_Button_Function_3 ua=“na”>紧急呼叫</Action_Button_Function_3> <!-- 有空选项:关闭|紧急呼叫|自定义 --> <Action_Button_Service_Name_3 ua=“na”>911</Action_Button_Service_Name_3> <Action_Button_Service_Destination_3 ua=“na”>911</Action_Button_Service_Destination_3> <Custom_Content_Field_3 ua=“na”/> <Service_Secret_3 ua=“na”/> <Dial_Out_Delay_3 ua=“na”>5</Dial_Out_Delay_3> <Silent_Emergency_Call_3 ua=“na”>禁用</Silent_Emergency_Call_3> <!--作按钮 --> <Allow_Silent_Emergency_Call_Retrieval ua=“na”>否</Allow_Silent_Emergency_Call_Retrieval> <!-- 有空选项:是|不

5

完成后,单击 提交所有更改

参考资料

作按钮的参数

以下参数位于 “语音 > 电话 ”标签页的作 按钮 部分。

表 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

自定义内容字段

默认值:空

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

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

您还可以使用其他宏,例如 $MA、$SN。

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

服务机密

默认值:空

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

服务触发器

默认:单按

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

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

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

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

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

多触发器:选择此选项可将多个触发器和事件关联到作按钮。 然后,转到 多触发器 - 单按多触发器 - 长按 和多触发器 - 按三次 部分以配置特定设置。

拨出延迟

默认值:5

选项: 0 - 30

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

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

无声紧急呼叫

默认值:Disabled

选项:启用、禁用

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

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

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

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

允许静默紧急呼叫取回

默认值:No

选项:Yes, No

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

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

下表中的参数在“语音>电话 ”选项卡上的多重触发 - 单次”、“ 多重触发 - 长按 ”和 “多重触发 - 按三次 ”部分中有空

表 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 请求。

服务机密

默认值:空

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

拨出延迟

默认值:5

选项: 0 - 30

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

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

无声紧急呼叫

默认值:Disabled

选项:启用、禁用

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

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

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

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

作按钮的 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”}]}' 

以下示例适用于 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。
$SS访问 XML 应用程序所需的服务机密。