配置操作按鈕（統一設定管理）

操作按鈕是位於 Cisco 無線電話 9821 右側的紅色按鈕。它使用戶能夠快速存取指定的服務，例如緊急服務或客製化服務。您可以自訂按鈕，以觸發適合您特定使用場景的事件。

自訂操作按鈕

1	在 Cisco Unified Communications Manager 管理介面中，根據需要執行下列其中一項操作：若要設定所有已部署的電話，請前往系統 > 企業電話配置。若要設定共用相同手機設定檔的手機，請前往裝置 > 設備設定 > 通用手機設定檔。若要配置單一手機，請前往裝置 > 電話。然後找到你的手機並打開手機配置頁面。此配置遵循層級結構：設備個人設定優先於通用手機設定檔和企業級設定。通用電話設定檔設定會覆蓋企業級設定。
2	根據您的使用場景自訂操作按鈕參數。「操作」按鈕有三組參數，每組參數對應一個具有唯一觸發器的服務。如果在多個組中指定了服務觸發器，則第 1 組的設定優先於第 2 組和第 3 組的設置，而第 2 組的設定優先於第 3 組。緊急通話客製化服務多重觸發單一觸發器觸發多個事件有關這些參數的更多信息，請參閱產品特定配置參數。
3	選取儲存。
4	選擇應用程式配置。

緊急呼叫參數設定

請配置以下緊急呼叫參數。

表 1. 緊急呼叫參數設定
參數	設定
操作按鈕功能	選擇緊急呼叫。
操作按鈕服務目標	請輸入緊急服務的電話號碼或URI。
操作按鈕服務名稱	（可選）指定與觸發器關聯的服務的名稱。當使用者按下按鈕時，螢幕上將顯示此名稱，指示將觸發哪個服務。如果沒有指定名稱，則使用 `Emergency call` 或 `Silent emergency call` 作為顯示名稱。
撥接延遲	設定手機在偵測到觸發訊號後發動事件的逾時時間（以秒為單位）。預設值為 5 秒。設定為 0 時，事件會在偵測到觸發後立即啟動。延遲螢幕會顯示倒數計時器，讓使用者取消由操作按鈕觸發的操作。在緊急呼叫情況下，思科無線電話 9821 會持續震動，同時顯示延遲畫面。但是，對於無聲緊急呼叫或訊號，思科無線電話 9821 不會震動。
服務觸發器	從清單中選擇一個觸發器：單次按下，長按，或三次按下。
無聲緊急呼叫	（可選）預設情況下，緊急呼叫功能為雙向呼叫，類似於其他撥出電話。啟用靜音緊急呼叫後，呼叫方的聲音將保持靜音，以避免在通話過程中引起注意。只有通話接收者才能結束靜音緊急呼叫。在進行靜默緊急呼叫時，思科無線電話 9821 的螢幕將關閉。其他所有功能均無法使用。通話結束後，手機恢復正常運作。
允許靜默緊急呼叫檢索	（可選）如果您允許使用者在保持緊急呼叫的同時按任意鍵恢復正常電話操作，請啟用此功能。除非使用者使用音量鍵調高揚聲器音量，否則通話音訊將保持靜音。

自訂服務參數設定

為自訂服務配置以下參數。

表2。自訂服務參數設定
參數	設定
操作按鈕功能	選擇自訂。
操作按鈕服務目標	請輸入自訂服務的網址。URL 必須以 `http://` 或 `https://`開頭，例如 `https://10.11.20.159/path/service.xml`。
操作按鈕服務名稱	（可選）指定與觸發器關聯的服務的名稱。當使用者按下按鈕時，螢幕上將顯示此名稱，指示將觸發哪個服務。如果沒有指定名稱，則使用自訂服務作為顯示名稱。
自訂內容字段	（可選）如果您希望手機在按下操作按鈕時發送 HTTP Post 請求，請輸入 HTTP 數據，例如方法、標頭和 POST 內容，最大長度為 1024 個字元。有關 POST 腳本範例和語法，請參閱操作按鈕的 HTTP Post 請求。
撥接延遲	設定手機在偵測到觸發訊號後發動事件的逾時時間（以秒為單位）。預設值為 5 秒。設定為 0 時，事件會在偵測到觸發後立即啟動。延遲螢幕會顯示倒數計時器，讓使用者取消由操作按鈕觸發的操作。在自訂服務場景中，思科無線電話 9821 會持續震動，同時顯示延遲畫面。
服務觸發器	從清單中選擇一個觸發器：單次按下，長按，或三次按下。
機密	設定一個金鑰字串，它可以是身份驗證金鑰、令牌或密碼。輸入的金鑰顯示為掩碼字串，可以使用巨集 `$SS` 在自訂內容欄位和操作按鈕服務目標中引用。

多重觸發器參數設定

分別設定各組的參數。請參閱上方的 緊急呼叫 和 定制服務 部分。

單一觸發器用於多個事件參數設定

配置以下參數，將多個事件指派給一個觸發器。

表3。單一觸發器用於多個事件參數設定
參數	設定
操作按鈕功能	選擇自訂。
操作按鈕服務目標	請按以下格式輸入要撥打的電話號碼和 XML 服務 URL： `tel: +` URL 必須以 `http://` 或 `https://`開頭。範例： `tel:1234 + https://10.11.20.159/path/service.xml`
操作按鈕服務名稱	（可選）指定與觸發器關聯的服務的名稱。當使用者按下按鈕時，螢幕上將顯示此名稱，指示將觸發哪個服務。如果沒有指定名稱，則使用自訂服務作為顯示名稱。
自訂內容字段	（可選）如果您希望手機在按下操作按鈕時發送 HTTP Post 請求，請輸入 HTTP 數據，例如方法、標頭和 POST 內容，最大長度為 1024 個字元。有關 POST 腳本範例和語法，請參閱操作按鈕的 HTTP Post 請求。
撥接延遲	設定手機在偵測到觸發訊號後發動事件的逾時時間（以秒為單位）。預設值為 5 秒。設定為 0 時，事件會在偵測到觸發後立即啟動。延遲螢幕會顯示倒數計時器，讓使用者取消由操作按鈕觸發的操作。在緊急通話和自訂服務場景中，思科無線電話 9821 會持續震動，同時顯示延遲畫面。但是，對於無聲緊急呼叫或訊號，思科無線電話 9821 不會震動。
服務觸發器	從清單中選擇一個觸發器：單次按下，長按，或三次按下。
機密	設定一個金鑰字串，它可以是身份驗證金鑰、令牌或密碼。輸入的金鑰顯示為掩碼字串，可以使用巨集 `$SS` 在自訂內容欄位和操作按鈕服務目標中引用。
無聲緊急呼叫	（可選）預設情況下，緊急呼叫功能為雙向呼叫，類似於其他撥出電話。啟用靜音緊急呼叫後，呼叫方的聲音將保持靜音，以避免在通話過程中引起注意。只有通話接收者才能結束靜音緊急呼叫。在進行靜默緊急呼叫時，思科無線電話 9821 的螢幕將關閉。其他所有功能均無法使用。通話結束後，手機恢復正常運作。
允許靜默緊急呼叫檢索	（可選）如果您允許使用者在保持緊急呼叫的同時按任意鍵恢復正常電話操作，請啟用此功能。除非使用者使用音量鍵調高揚聲器音量，否則通話音訊將保持靜音。

操作按鈕的 HTTP POST 請求

Cisco 無線電話 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 '' 

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

感謝您的意見回饋。