Cisco Desk Phone 9800 系列上「動作」按鈕的自訂選項需要特定的 PhoneOS 韌體支援。 有關詳細資訊，請參閱下表：

功能所需韌體版本
緊急通話PhoneOS 3.0.1 及更高版本
客製服務PhoneOS 3.2.1 及更高版本
多個觸發器PhoneOS 3.3.1 及更新版本
HTTP PostPhoneOS 3.3.1 及更新版本
單個觸發器上的多個事件PhoneOS 3.4.1 及更新版本

配置緊急通話的「動作」按鈕

緊急呼叫的操作按鈕可確保快速輕鬆地訪問工作空間中的關鍵説明。

1

從 Control Hub 的客戶檢視轉至 裝置，然後選擇您的電話。

2

選擇“ 所有配置”。

3

導覽至「 電話 」部分，然後選擇 「動作按鈕」。

4

設定下列參數：

  • 操作按鈕功能：選擇 緊急呼叫。

  • 操作按鈕 服務目的地：輸入緊急服務的電話號碼或URI。

  • 操作按鈕服務名稱 （可選）：指定與操作觸發器關聯的服務的名稱。 當使用者按下按鈕時，此名稱將顯示在螢幕消息中，指示將啟動哪個事件。 如果未指定名稱， 則以緊急呼叫 作為顯示名稱。

  • 撥出延遲..設定電話在檢測到觸發程式後發起緊急通話的逾時時間（以秒為單位）。 預設值為 5 秒。 若設定為 0，則在檢測到觸發碼後立即撥話。

  • 服務觸發器 從清單中選擇一個觸發器： 單按、 長按或 按 3 次。

  • 靜音緊急通話 （可選）：緊急通話預設為雙向通話，類似於其他去電。 啟用靜音緊急呼叫時，呼叫者端的音訊將靜音，以避免在呼叫過程中引起注意。 只有受話方可以結束無聲的緊急通話。

    在靜音緊急通話期間，電話 9841 的螢幕將凍結，同時電話 9851、9861 和 9871 的螢幕將關閉。 所有其他功能都無法訪問。 受話方結束通話後，電話會恢復正常作業。

  • 允許無聲緊急呼叫檢索 （可選）：如果允許使用者在保持緊急呼叫的同時按下任意鍵恢復正常的電話操作，則啟用此功能。 除非使用者使用音量鍵增大喇叭音量，否則通話音訊將保持靜音。

有關這些參數的更多詳細資訊，請參閱 “操作”按鈕的參數。

5

選取下一步。

6

查看更改，然後選擇“ 應用”。

7

選擇「 關閉 」以關閉頁面。

為自訂服務設定「操作」按鈕

當您將「動作」按鈕與自訂服務關聯時，電話使用者可透過指定的觸發器存取該服務，例如在按鈕上按一下、按長按或三次。

1

從 Control Hub 的客戶檢視轉至 裝置，然後選擇您的電話。

2

選擇“ 所有配置”。

3

導覽至「 電話 」部分，然後選擇 「動作按鈕」。

4

配置以下參數以將「操作」按鈕與自訂服務相關聯。

  • 操作按鈕功能：選擇 自定義。

  • 操作按鈕 服務目的地：輸入自訂服務的 URL。 URL 必須以 http:// 或 https:// 開頭，例如 https：//10.11.20.159/path/service.xml 。

  • 操作按鈕服務名稱 （可選）：指定與觸發器關聯的服務的名稱。 當使用者按下按鈕時，此名稱將顯示在螢幕訊息中，指示將觸發哪項服務。 如果未指定名稱， 則將使用自定義服務 作為顯示名稱。

  • 自訂內容欄位 （選填）：若要讓電話在按下「動作」按鈕時傳送 HTTP Post 請求，請輸入 HTTP 資料，例如方法、標頭、文章內容等，最大長度為 1024 個字元。

    有關 POST 腳本示例和語法，請參閱 操作按鈕的 HTTP Post 請求。

  • 撥出延遲..設定電話在偵測到觸發器後，起始事件的逾時時間（秒）。 預設值為 5 秒。 設置為 0 時，檢測到觸發器後會立即啟動事件。

  • 服務觸發器 從清單中選擇一個觸發器： 單按、 長按或 按 3 次。

有關這些參數的更多詳細資訊，請參閱 “操作”按鈕的參數。

5

選取下一步。

6

查看更改，然後選擇“ 應用”。

7

選擇「 關閉 」以關閉頁面。

為多個事件設定單個觸發器

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

1

從 Control Hub 的客戶檢視轉至 裝置，然後選擇您的電話。

2

選擇“ 所有配置”。

3

導覽至「 電話 」部分，然後選擇 「動作按鈕」。

4

配置以下參數以使「操作」按鈕能夠一次觸發多個事件。

  • 操作按鈕功能：選擇 自定義。

  • 動作按鈕 服務目的地： 輸入要撥打的電話號碼，並以此格式輸入XML服務 URL：

    tel：<phonenumber or 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 時，檢測到觸發器後會立即啟動事件。

  • 服務觸發器 從清單中選擇一個觸發器： 單按、 長按或 按 3 次。

  • 無聲緊急呼叫 （可選）：如果您在服務目標中包含電話號碼或撥號URI，啟用此功能將靜音緊急呼叫。

    緊急通話預設為雙向通話，類似於其他去電。 當設置為啟用時，音訊在呼叫者端靜音，以避免在呼叫期間引起注意。 只有受話方可以結束通話。

    在靜音緊急通話期間，電話 9841 的螢幕將凍結，同時電話 9851、9861 和 9871 的螢幕將關閉。 所有其他功能都無法訪問。 受話方結束通話後，電話會恢復正常作業。

  • 允許無聲緊急呼叫檢索 （可選）：如果允許使用者在保持緊急呼叫的同時按下任意鍵恢復正常的電話操作，則啟用此功能。 除非使用者使用音量鍵增大喇叭音量，否則通話音訊將保持靜音。

有關這些參數的更多詳細資訊，請參閱 “操作”按鈕的參數。

5

選取下一步。

6

查看更改，然後選擇“ 應用”。

7

選擇「 關閉 」以關閉頁面。

設定多個觸發器

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

1

從 Control Hub 的客戶檢視轉至 裝置，然後選擇您的電話。

2

選擇“ 所有配置”。

3

導覽至「 電話 」部分，然後選擇 「動作按鈕」。

4

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

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

  • 確保在選取「多重觸發」 選項時 至少設定一個觸發器。

5

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

6

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

  • 動作按鈕功能：選擇電話使用者可透過觸發器存取的服務。

  • 操作按鈕 服務目的地：輸入電話號碼或服務URI。

  • 操作按鈕服務名稱 （可選）：指定與操作觸發器關聯的服務的名稱。 當使用者按下按鈕時，此名稱將顯示在螢幕訊息中，指示將觸發哪項服務。 如果未指定名稱，則預設名稱將為“緊急呼叫”、“靜默緊急呼叫”或“自定義操作”（基於您在“操作按鈕功能 ”字段中的 選擇）。

  • 自訂內容欄位 （選填）：若要讓電話在按下「動作」按鈕時傳送 HTTP Post 請求，請輸入 HTTP 資料，例如方法、標頭、文章內容等，最大長度為 1024 個字元。

    有關 POST 腳本示例和語法，請參閱 操作按鈕的 HTTP Post 請求。

  • 撥出延遲..設定電話在偵測到觸發器後，起始事件的逾時時間（秒）。 預設值為 5 秒。 設置為 0 時，檢測到觸發器後會立即啟動事件。

  • 靜音緊急呼叫（可選）：如果您為緊急呼叫設置了“操作”按鈕，則啟用此功能會使緊急呼叫靜音。

    緊急通話預設為雙向通話，類似於其他去電。 當設置為啟用時，音訊在呼叫者端靜音，以避免在呼叫期間引起注意。 只有受話方可以結束通話。

    在靜音緊急通話期間，電話 9841 的螢幕將凍結，同時電話 9851、9861 和 9871 的螢幕將關閉。 所有其他功能都無法訪問。 受話方結束通話後，電話會恢復正常作業。

  • 允許無聲緊急呼叫檢索 （可選）：如果允許使用者在保持緊急呼叫的同時按下任意鍵恢復正常的電話操作，則啟用此功能。 除非使用者使用音量鍵增大喇叭音量，否則通話音訊將保持靜音。

    此參數位於 「動作按鈕 > 允許靜音緊急通話擷取」。

有關這些參數的更多詳細資訊，請參閱 “操作”按鈕的參數。

7

重複步驟 5 至 6 以配置更多觸發碼。

8

選取下一步。

9

查看更改，然後選擇“ 應用”。

10

選擇「 關閉 」以關閉頁面。

參考資料

“操作”按鈕的參數

可以在設備、位置和組織級別的配置中找到「操作」按鈕的參數。

有關如何在位置和組織等級配置電話設定的詳細資訊，請參閱 在 Control Hub 上配置 Cisco Desk Phone 9800 系列。

表 1. “操作”按鈕的參數
參數預設值與選項描述
動作按鈕功能

預設值：關閉

選項：關閉、緊急通話、自訂

您可以使用特定的服務來設定該按鈕。

  • 關閉..設定為關閉時，電話上單一服務的「動作」按鈕將不起作用。
  • 緊急呼叫：使用者可以使用「操作」按鈕撥打緊急呼叫（如果已配置）。
  • 自定義：使用者可以使用「操作」按鈕訪問自定義服務（如果已配置）。

當您將欄位設定為 「緊急通話 」或 「自訂」時，請務必在「動作按鈕服務目的地 」欄位中 輸入服務目的地。 或者，電話將顯示組態錯誤。

動作按鈕服務目的地

預設值：空

根據分配給「操作」按鈕的服務，以下列格式之一提供服務目標：

  • 對於緊急通話服務，請輸入電話號碼或緊急服務URI。

  • 為自訂服務配置按鈕時，請輸入服務 URL。 URL 必須以 http:// 或 https:// 開頭。 例如， https：//10.11.20.159/path/service.xml。

  • 若要設定此按鈕使用單一觸發器起始多個事件，請輸入 tel：<phonenumber 或 SIP URL> + <Service RUL>。 範例： tel：1234 + https：//10.11.20.159/path/service.xml.

    亦支援通話 SIP URI。 請使用下列 格式輸入URI：SIP 4567@co.webex.com

    有關多個事件的單個觸發器的詳細資訊，請參閱 為多個事件配置單個觸發器。

如果您啟用「操作」按鈕而未設置有效的服務目標，則電話上的使用者將看到一條提示進行配置的訊息。 使用者關閉此通知後，警告圖示將保留在電話螢幕的標題中，直到正確設定或停用該按鈕為止。

電話號碼不能用作自訂服務的目的地。 如果您將「動作按鈕」設定為 「自訂 」，並輸入電話號碼作為服務目的地，則電話上將顯示警示訊息，指示未設定該按鈕。 相反，您可以使用此格式 新增電話號碼 tel：<phone number>例如， tel：1234。

動作按鈕服務名稱

預設值：空

（可選）指定與「操作」按鈕關聯的服務的名稱。 當使用者按下按鈕時，此名稱將顯示在螢幕訊息中，指示將觸發哪項服務。

如果未指定名稱，預設名稱將為“緊急呼叫”、“靜默緊急呼叫”或“自定義操作”，具體取決於您在“操作按鈕功能 ”字段中的 選擇。

允許無聲緊急通話擷取

預設值：否

選項：是、否

控制使用者是否可以在靜音緊急通話期間擷取電話功能。 依預設，一旦發起靜音緊急通話，電話就會鎖定所有功能，直到受話方結束通話為止。

當此參數設為 「是」時，使用者可以按任意鍵恢復正常的電話作業，同時保持緊急通話。 除非使用者使用音量鍵增加音量，否則通話音訊將保持靜音。

自訂內容欄位

預設值：空

僅當「操作按鈕功能 」設置為 「自定義 」時，此設置才有效。

輸入 HTTP 資料，例如方法、標頭和帖子內容，最大長度為 1024 個字元。 設定後，電話會在按下動作時傳送 HTTP Post 請求。

您可以在 HTTP 資料中使用巨集，例如 $MA、$SN。

有關 POST 腳本示例和語法，請參閱 操作按鈕的 HTTP Post 請求。

撥出延遲

預設︰5

選項：0 - 30

設定在按下「動作」按鈕後，電話起始緊急通話或自訂動作的逾時時間（秒）。

如果您希望電話在偵測到觸發時立即撥話或起始事件（如按一下、長按或三次按鈕所指定），請將其設定為 0。

服務觸發器

預設值：單按

選項：單按，長按，按3次， 多重觸發

選擇使用者如何使用電話的「動作」按鈕撥打緊急電話或起始自訂服務。

單按：按「動作」按鈕可觸發相關的通話或服務。

長按：向下按住「動作」按鈕至少 2 秒鐘，以觸發相關的通話或服務。

按 3 次：按三次「動作」按鈕，每次按鍵間隔一秒鐘，以觸發相關的通話或服務。

多重觸發：選擇此選項可將多個觸發器和事件關聯到「操作」按鈕。 轉到 服務觸發器多觸發 器部分，選擇觸發器並配置特定設置。

有關多個觸發器的詳細資訊，請參閱 配置多個觸發器。

服務觸發器多重觸發器選項：單按，長按，按3次

僅當「服務觸發碼 」設定為「多重觸發器 」 時，此設定才有效。

從可用選項中選擇一個觸發器以打開和配置設置。

有關多個觸發器的詳細資訊，請參閱 配置多個觸發器。

有關多觸發參數的詳細資訊，請參閱 多觸發的參數。

靜音緊急通話

預設：已停用

選項：啟用、禁用

靜音緊急通話專為在危險情況下提供謹慎的協助而設計。 它使用戶能夠在不發出任何噪音的情況下尋求説明。

  • 啟用后，用戶能夠使用「操作」按鈕進行單向呼叫。

    在撥打無聲的緊急通話後，只有另一方可以結束通話。 為避免在通話期間引起注意，電話 9841 的螢幕將凍結，同時電話 9851、9861 和 9871 的螢幕將關閉。 依預設，電話在靜音緊急通話期間會鎖定所有功能。 要允許使用者在保持無聲緊急呼叫的同時恢復正常的電話操作，請啟用 允許無聲緊急呼叫檢索 功能。

  • 當停用時，緊急通話將像其他去電一樣充當雙向通話。

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

撥出延遲

預設︰5

選項：0 - 30

設定在按下「動作」按鈕後，電話起始緊急通話或自訂動作的逾時時間 (秒)。

如果您希望電話在偵測到觸發時立即撥話或起始事件 (如按一下、長按或三次按鈕所指定)，請將其設定為 0。

靜音緊急通話

預設：已停用

選項：啟用、禁用

靜音緊急通話專為在危險情況下提供謹慎的協助而設計。 它使用戶能夠在不發出任何噪音的情況下尋求説明。

  • 啟用后，用戶能夠使用「操作」按鈕進行單向呼叫。

    在撥打無聲的緊急通話後，只有另一方可以結束通話。 為避免在通話期間引起注意，電話 9841 的螢幕將凍結，同時電話 9851、9861 和 9871 的螢幕將關閉。

    依預設，電話在靜音緊急通話期間會鎖定所有功能。 要允許使用者在保持無聲緊急呼叫的同時恢復正常的電話操作，請啟用 允許無聲緊急呼叫檢索 功能。

  • 當停用時，緊急通話將像其他去電一樣充當雙向通話。

「動作」按鈕的 HTTP Post 請求

Cisco Desk Phone 9800 系列上的「動作」按鈕可設定為透過 HTTP Post 請求觸發 XML 應用程式。

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

以下範例採用 XML 和 JSON：

示例 #1：XML --method 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>'
表 3. 支援的巨集
巨集名稱宏指令擴展
#DEVICENAME#通話系統中顯示的裝置名稱;例如，SEP845A3EC21288
$MAMAC 使用小寫十六進位數字的位址 (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

表 4. 支援的巨集
宏名稱宏擴展
$形式 $$ 擴展為單個 $ 字元。
A 至 P替換為通用參數 GPP_A 到 GPP_P。
SA 至 SD替換為專用參數 GPP_SA 至 GPP_SD。 這些參數存有在佈建過程中使用的密鑰或密碼。

$SA 至 $SD 被認為是傳遞给可選重新同步 URL 限定符 — 密鑰 — 的參數。

MAMAC 使用小寫十六進位數字的位址 (000e08aabbcc)。
MAUMAC 使用大寫十六進位數字的位址 (000E08AABBCC)。
MACMAC 位址使用小寫十六進位數位和冒號分隔十六進位數位對 (00：0e：08：aa：bb：cc)。
PN產品名稱;例如視訊電話 8875、桌上型電話 9851。
PSN產品序列號;例如 8875、9841、9861
SN序列號字串;例如，88012BA01234。
CCERTSSL 客戶端證書狀態，已安裝或未安裝。
IPIP 電話本機子網路中的位址，例如 192.168.1.100。
EXTIP電話的外部 IP，如網際網路所顯示;例如，66.43.16.52。

SWVER

軟體版本字串。 例如：

電話.3-2-1-0104-37

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 配置參數的內容。