設定「動作」按鈕 (Control Hub)

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

自訂「動作」按鈕

1	從 Control Hub 的客戶檢視轉至裝置，然後選擇您的電話。
2	選擇“ 所有配置”。
3	導覽至「電話」部分，然後選擇「動作按鈕」。
4	根據您的使用案例自定義「操作」按鈕參數。緊急通話客製服務多個事件的單個觸發器多個觸發器有關這些參數的更多詳細資訊，請參閱 Control Hub 上的 Cisco Wireless Phone 9821 設定參數。
5	選取下一步。
6	查看更改，然後選擇“ 應用”。
7	選擇「關閉」以關閉頁面。

緊急通話參數設定

緊急呼叫的操作按鈕可確保快速輕鬆地訪問工作空間中的關鍵説明。為緊急通話配置以下參數。

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

多個事件參數設定的單個觸發器

多個事件的單個觸發器允許操作按鈕上的一個操作同時啟動多個相關進程。此功能可增強回應能力、降低複雜性並確保跨應用程式的無縫工作流執行。

配置以下參數以將多個事件分配給觸發器。

表 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 次。
靜音緊急通話	（選用）緊急通話預設為雙向通話，類似於其他去電。啟用靜音緊急呼叫時，呼叫者端的音訊將靜音，以避免在呼叫過程中引起注意。只有受話方可以結束無聲的緊急通話。在靜音緊急通話期間，Cisco 無線電話 9821 螢幕將關閉。所有其他功能都無法訪問。受話方結束通話後，電話會恢復正常作業。
允許無聲緊急通話擷取	（選用）如果您允許使用者在保持緊急通話的同時按下任意鍵來恢復正常的電話操作，請啟用此功能。除非使用者使用音量鍵增大喇叭音量，否則通話音訊將保持靜音。

設定多個觸發器

可以將「操作」按鈕配置為連接到多個服務，併為每個服務分配自己的觸發器。例如，長按「動作」按鈕可撥話給指定的緊急代理;短按按鈕 POST 通知公司內的電話。

將服務觸發碼設定為多重觸發碼。

選取「多重觸發器」選項後，將僅套用「服務觸發器多重觸發器」區段中的設定，而忽略該區段外的「動作」按鈕相關設定。
確保在選取「多重觸發」選項時至少設定一個觸發器。

轉到服務觸發器多觸發器，然後從可用選項中選擇所需的觸發器 - 單按、長按和按 3 次。

為您選擇的觸發器配置以下參數：

表 4. 多個觸發參數設定
參數	設定
動作按鈕功能	選取電話使用者可透過觸發器存取的服務。
動作按鈕服務目的地	輸入服務的電話號碼或 URI。
動作按鈕服務名稱	（選用）指定與觸發器關聯的服務的名稱。當使用者按下按鈕時，此名稱將顯示在螢幕訊息中，指示將觸發哪項服務。如果未指定名稱，則將使用自定義服務作為顯示名稱。
自訂內容欄位	（選用）若要讓電話在按下「動作」按鈕時傳送 HTTP POST 請求，請輸入 HTTP 資料，例如方法、標頭及 POST 內容，最大長度為 1024 個字元。有關 POST 腳本示例和語法，請參閱 “操作”按鈕的 HTTP POST 請求。
撥出延遲	設定電話在偵測到觸發器後起始事件的逾時時間 (秒)。預設值為 5 秒。設置為 0 時，檢測到觸發器後會立即啟動事件。延遲螢幕顯示倒數計時器，允許使用者取消由操作按鈕觸發的操作。在緊急通話和自訂服務場景下，顯示延遲螢幕時，Cisco 無線電話 9821 會持續振動。但是，對於靜音緊急呼叫或信號，Cisco 無線電話 9821 不會振動。
靜音緊急通話	（選用）緊急通話預設為雙向通話，類似於其他去電。啟用靜音緊急呼叫時，呼叫者端的音訊將靜音，以避免在呼叫過程中引起注意。只有受話方可以結束無聲的緊急通話。在靜音緊急通話期間，Cisco 無線電話 9821 螢幕將關閉。所有其他功能都無法訪問。受話方結束通話後，電話會恢復正常作業。
允許無聲緊急通話擷取	（選用）如果您允許使用者在保持緊急通話的同時按下任意鍵來恢復正常的電話操作，請啟用此功能。除非使用者使用音量鍵增大喇叭音量，否則通話音訊將保持靜音。

繼續按照步驟 2 和 3 操作以配置更多觸發碼。

「動作」按鈕的 HTTP POST 請求

Cisco Wireless Phone 9821 上的“操作”按鈕可以配置為通過 HTTP POST 請求觸發 XML 應用程式。

在自定義內容欄位中，輸入請求腳本。可以指定 XML 或 JSON 內容類型，並在請求中包含宏。

以下範例位於 XML 和 JSON 中：

範例 #1：XML -- 方法 POST --header 'Content-Type：application/XML' --body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 示例 #2：JSON --method POST --header 'Content-Type：application/json' --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>This is for HTTP POST XML</Description></MetaData>'

表 5. 支援的巨集
巨集名稱	宏指令擴展
#DEVICENAME#	通話系統中顯示的裝置名稱;例如，SEP845A3EC21288
$MA	MAC 使用小寫十六進位數字的位址 (000e08aabbcc)。
$MCASTADDR	多點傳送呼叫應用程式的位址。
$PN $PSN	產品名稱;例如 DP-9851、DP-9871。
$SN	序列號字串;例如，FVH28022D0T。

XML URL 支援的巨集變數

您可以在 XML URL 中使用巨集變數。支援以下巨集變數：

使用者 ID—UID1、UID2 至 UIDn
顯示名稱 - DISPLAYNAME1，DISPLAYNAME2 到 DISPLAYNAMEn
授權 ID—AUTHID1，AUTHID2 至 AUTHIDn
Proxy—PROXY1、PROXY2 至 PROXYn
MAC 使用小寫十六進位數字的位址—MA
產品名稱—PN
產品序列號—PSN
序號 - SERIAL_NUMBER

表 6. 支援的巨集
巨集名稱	宏指令擴展
$	形式 $$ 擴展為單個 $ 字元。
A 至 P	替換為通用參數 GPP_A 到 GPP_P。
SA 至 SD	替換為專用參數 GPP_SA 至 GPP_SD。這些參數存有在佈建過程中使用的密鑰或密碼。 $SA 至 $SD 被認為是傳遞给可選重新同步 URL 限定符 — 密鑰 — 的參數。
MA	MAC 使用小寫十六進位數字的位址 (000e08aabbcc)。
MAU	MAC 使用大寫十六進位數字的位址 (000E08AABBCC)。
MAC	MAC 位址，使用小寫十六進位數位和冒號分隔十六進位數位對 (00：0e：08：AA：bb：cc)。
PN	產品名稱;例如，Cisco Wireless Phone 9821。
PSN	產品序列號;例如 9821。
SN	序列號字串;例如，FVH29513116。
CCERT	SSL 用戶端證書狀態，已安裝或未安裝。
IP	IP 電話本機子網路中的位址，例如 192.168.1.100。
EXTIP	電話的外部 IP，如網際網路所顯示;例如，66.43.16.52。
SWVER	軟體版本字串。例如，PHONEOS-9821.5-0-1-0004-19。
HWVER	硬體版本字串。例如 2.0.1
PRVST	佈建狀態 (數字字串)： -1 = 明顯重新同步請求 0 = 接通電源時重新同步 1 = 定期重新同步 2 = 重新同步失敗，重試
UPGST	升級狀態 (數字字串)： 1 = 第一次升級嘗試 2 = 升級失敗，重試
UPGERR	上次升級嘗試的結果訊息 (錯誤)；例如，http_get 失敗。
PRVTMR	距離上次重新同步嘗試的秒數。
UPGTMR	距離上次升級嘗試的秒數。
REGTMR1	線路 1 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。
REGTMR2	線路 2 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。
UPGCOND	原來的宏指令名稱。
SCHEME	檔案存取方案，TFTP、HTTP 或 HTTPS 之一，在剖析重新同步或升級 URL 後獲得。
SERV	請求目標伺服器主機名稱，在剖析重新同步或升級 URL 後獲得。
SERVIP	請求目標伺服器 IP 位址，在剖析重新同步或升級 URL 後獲得，可能在 DNS 查詢之後。
PORT	請求目標 UDP/TCP 連接埠，在剖析重新同步或升級 URL 後獲得。
PATH	請求目標檔案路徑，在剖析重新同步或升級 URL 後獲得。
ERR	重新同步或升級嘗試的結果訊息。只有助於生成結果系統記錄訊息。嘗試升級時，值將保留在 UPGERR 變數中。
UIDn	線路 n UserID 組態參數的內容。
伊斯庫斯特	如果單位是自定義的，則值 = 1，否則為 0。自訂狀態可在 Web UI 資訊頁面上查看。
傳入名稱	與第一通接通、響鈴或傳入通話相關聯的名稱。
遠端號碼	第一個接通、響鈴或傳入通話的電話號碼。如果有多個通話，則會提供與找到的第一個通話關聯的資料。
顯示名稱 n	第 N 行顯示名稱配置參數的內容。
授權	行 N 身份驗證 ID 配置參數的內容。

Cisco AI Assistant

感謝您的意見回饋。