設定「動作」按鈕 (Unified CM)

“操作”按鈕是位於 Cisco Wireless Phone 9821 右側的紅色按鈕。它允許使用者快速訪問指定的服務，例如緊急或自定義服務。您可以自訂該按鈕以啟動適合您特定用例的事件。

自訂「動作」按鈕

1	在 Cisco Unified Communications Manager Administration 中，根據需要執行以下操作之一：若要設定所有部署的電話，請移至系統 > 企業電話組態。若要設定共用相同電話設定檔的電話，請移至「裝置 > 裝置設定」> 「常用電話設定檔」。若要設定單個電話，請移至「裝置 > 電話」。然後找到您的電話並打開電話配置頁面。設定遵循階層結構：單個裝置設定優先於常用電話設定檔和企業級中的設定常用電話設定檔設定將覆蓋企業級設定
2	根據您的使用案例自定義「操作」按鈕參數。 “操作”按鈕有三組參數，每組參數對應於具有唯一觸發器的服務。如果在多個群組中指定了服務觸發程式，則群組 1 中的設定將優先於群組 2 和 3 中的設定，而群組 2 中的設定將優先於群組 3。緊急通話客製服務多個觸發器多個事件的單個觸發器有關這些參數的詳細資訊，請參閱產品特定配置參數。
3	選取儲存。
4	選取套用組態。

緊急通話參數設定

為緊急通話配置以下參數。

表 1. 緊急通話參數設定
參數	設定
動作按鈕功能	選取緊急通話。
動作按鈕服務目的地	輸入緊急服務的電話號碼或 URI。
動作按鈕服務名稱	（選用）指定與觸發器關聯的服務的名稱。當使用者按下按鈕時，此名稱將顯示在螢幕訊息中，指示將觸發哪項服務。若未指定名稱， `則以緊急通話` 或 `無聲緊急通話` 作為顯示名稱。
撥出延遲	設定電話在偵測到觸發器後起始事件的逾時時間 (秒)。預設值為 5 秒。設置為 0 時，檢測到觸發器後會立即啟動事件。延遲螢幕顯示倒數計時器，允許使用者取消由操作按鈕觸發的操作。在緊急通話期間，顯示延遲螢幕時，Cisco Wireless Phone 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	服務密碼，在電話配置頁面中顯示遮罩的字串，例如驗證密碼、令牌或密碼。

Cisco AI Assistant

感謝您的意見回饋。