自訂「動作」按鈕

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

登入 Cisco Unified Communications Manager 管理。

2

根據需要執行下列一項操作：

  • 若要設定所有部署的電話，請移至 系統 > 企業電話組態。
  • 若要設定共用相同電話設定檔的電話，請移至 「裝置 > 裝置設定 」> 「常用電話設定檔」。
  • 若要設定單個電話，請移至 「裝置 > 電話」。 然後找到您的電話並打開電話配置頁面。

設定遵循階層結構：

  • 單個裝置設定優先於常用電話設定檔和企業級中的設定
  • 常用電話設定檔設定將覆蓋企業級設定

3

根據您的使用案例使用以下參數自定義「操作」按鈕設置。

“操作”按鈕有三組參數，每組參數對應於具有唯一觸發器的服務。 如果在多個群組中指定了服務觸發程式，則群組 1 中的設定將優先於群組 2 和 3 中的設定，而群組 2 中的設定將優先於群組 3。

  • 緊急通話

    設定下列參數：

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

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

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

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

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

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

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

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

  • 客製服務

    設定下列參數：

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

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

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

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

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

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

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

    • 服務機密 （可選）：如果自定義服務需要身份驗證才能訪問它，請輸入身份驗證機密、令牌或密碼。 輸入的金鑰顯示為遮罩字串，可以使用自定義內容欄位 和 操作按鈕服務目標 中的 巨集 $SS進行引用。

  • 多個觸發器

    分別設置每個組中的參數。 請參閱上面的緊急通話和自訂服務部分。

  • 多個事件的單個觸發器

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

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

    • 動作按鈕 服務目的地： 輸入要撥打的電話號碼，並以此格式輸入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 次。

    • 服務機密 （可選）：如果自定義服務需要身份驗證才能訪問它，請輸入身份驗證機密、令牌或密碼。 輸入的金鑰顯示為遮罩字串，可以使用自定義內容欄位 和 操作按鈕服務目標 中的 巨集 $SS進行引用。

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

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

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

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

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

4

選取儲存。

5

選取套用組態。

參考資料

“操作”按鈕的參數

這些參數在企業電話組態、常用電話設定檔和個人電話組態中可用。

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

預設值：關閉

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

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

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

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

動作按鈕 服務名稱 1~3

預設值：空

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

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

動作按鈕 服務目的地 1~3

預設值：空

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

  • 對於緊急通話服務，請輸入電話號碼或緊急服務的 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。

如果不允許輸入包含與號 （&） 的 URL，請使用 %26 作為替代。 例如，輸入 http://1.2.3.4/phone?a=1%26b=2%26c=3 而不 輸入 http://1.2.3.4/phone?a=1&b=2&c=3。

自訂內容欄位 1~3

預設值：空

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

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

如果服務需要身份驗證才能訪問，請確保在「服務機密 」欄位中 輸入身份驗證機密。 在 HTTP 資料中，使用巨集 $SS 作為對服務機密的引用。

有關範例和語法，請參閱 「操作」按鈕的 HTTP Post 請求。

服務機密 1~3

預設值：空

服務機密可以是身份驗證機密、令牌或密碼。 輸入的金鑰顯示為遮罩字串，可以使用自定義內容欄位 和 操作按鈕服務目標 中的 巨集 $SS進行引用。

服務觸發器 1~3

預設值：單按

選項：單按，長按，按3次

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

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

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

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

不要跨多個服務重複觸發器，因為優先順序較低的參數將不起作用。 優先順序順序（從高到低）如下：群組 1、群組 2、群組 3。

撥出延遲 1~3

預設︰5

選項：0 - 30

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

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

無聲緊急呼叫 1~3

預設：已停用

選項：啟用、禁用

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

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

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

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

允許無聲緊急通話擷取

預設值：否

選項：是、否

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

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

「動作」按鈕的 HTTP Post 請求

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

在自訂內容欄位中 ，輸入您的自訂請求腳本。 您可以指定 XML 或 JSON 內容類型，並在請求中包含宏。 例如， 可以將$SS添加到腳本中，以檢索“服務機密 ”字段中 提供的身份驗證機密、令牌或密碼。

以下範例採用 XML 和 JSON：

示例 #1：XML --method POST --header 'Content-Type： application/xml' --header 'Authorization： Holder username：$SS' --body '<MetaData><Trigger>True</Trigger><Description>This is for 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”}]}'

Cisco Unified Communications Manager （UCM） 要求按照 RFC 3986 對保留字元進行百分比編碼。

表 2. 保留字元的百分比編碼
字元百分比編碼
&%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
表 3. 支援的巨集
巨集名稱宏指令擴展
#DEVICENAME#顯示在通話系統中的裝置名稱。 例如，SEP845A3EC21288
$SS服務密碼，在電話配置頁面中顯示遮罩的字串，例如驗證密碼、令牌或密碼。