アクションボタンをカスタマイズする

Cisco Desk Phone 9800 シリーズのアクション ボタンのカスタム オプションには、特定の PhoneOS ファームウェア サポートが必要です。 詳細については、次の表を参照してください。

特長必要なファームウェアバージョン
緊急通話PhoneOS 3.0.1以降
カスタムサービスPhoneOS 3.2.1以降
複数のトリガーPhoneOS 3.3.1以降
HTTPポストPhoneOS 3.3.1以降
単一のトリガーで複数のイベントPhoneOS 3.4.1以降
1

Cisco Unified Communications Manager の管理 にログインします。

2

必要に応じて、次のいずれかのアクションを実行します。

  • 展開されたすべての電話を構成するには、 [システム] > [エンタープライズ電話の構成] に移動します。
  • 同じ電話プロファイルを共有する電話を設定するには、 [デバイス] > [デバイス設定] > [共通の電話プロファイル] に移動します。
  • 個々の電話を設定するには、 [デバイス] > [電話] に移動します。 次に、携帯電話を見つけて、「電話の設定」ページを開きます。

構成は階層構造に従います。

  • 個々のデバイス設定は、共通の電話プロファイルとエンタープライズレベルの設定よりも優先されます。
  • 共通の電話プロファイル設定はエンタープライズレベルの設定を上書きします

3

使用事例に応じて、次のパラメータを使用してアクション ボタンの設定をカスタマイズします。

アクション ボタンには 3 つのパラメータ グループがあり、それぞれが固有のトリガーを持つサービスに対応しています。 サービス トリガーが複数のグループに指定されている場合、グループ 1 の設定はグループ 2 と 3 の設定よりも優先され、グループ 2 はグループ 3 よりも優先されます。

  • 緊急コール

    以下のパラメータを設定します。

    • アクション ボタンの機能: 緊急通報を選択します。

    • アクション ボタン サービス宛先: 緊急サービスの電話番号または URI を入力します。

    • アクション ボタン サービス名 (オプション): アクション トリガーに関連付けられたサービスの名前を指定します。 この名前は、ユーザーがボタンを押したときに画面上のメッセージに表示され、どのイベントが開始されるかを示します。 名前が指定されていない場合は、 緊急通報 が表示名として使用されます。

    • ダイヤルアウト遅延: トリガーが検出された後、電話機が緊急通話を開始するまでのタイムアウト期間 (秒単位) を設定します。 デフォルト値は 5 秒です。 0 に設定すると、トリガーを検出するとすぐに通話が行われます。

    • サービス トリガー リストからトリガーを選択します: 1 回押す長押し、または 3 回押す

    • サイレント緊急通話 (オプション): デフォルトでは、緊急通話は他の発信通話と同様に双方向通話として機能します。 サイレント緊急通話を有効にすると、通話中に注意を引かないように、発信者側の音声は無音になります。 サイレント緊急通話を終了できるのは、通話の受信者のみです。

      サイレント緊急通話中は、電話機 9841 の画面はフリーズし、電話機 9851、9861、および 9871 の画面はオフになります。 その他の機能にはアクセスできません。 受信者が通話を終了すると、電話機は通常の動作に戻ります。

    • サイレント緊急通話の取得を許可する (オプション): 緊急通話を維持しながらユーザーが任意のキーを押して通常の電話操作を復元できるようにする場合は、この機能を有効にします。 ユーザーが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままになります。

  • カスタムサービス

    以下のパラメータを設定します。

    • アクション ボタンの機能 : [カスタム] を選択します。

    • アクション ボタンのサービス宛先: カスタム サービスの URL を入力します。 URL は http:// または https:// で始まる必要があります (例: https://10.11.20.159/path/service.xml)。

    • アクション ボタン サービス名 (オプション): トリガーに関連付けられたサービスの名前を指定します。 この名前は、ユーザーがボタンを押したときに画面上のメッセージに表示され、どのサービスがトリガーされるかを示します。 名前が指定されていない場合は、 カスタム サービス が表示名として使用されます。

    • カスタム コンテンツ フィールド (オプション): アクション ボタンが押されたときに電話機が HTTP POST 要求を送信できるようにする場合は、メソッド、ヘッダー、POST コンテンツなどの HTTP データを最大 1024 文字で入力します。

      POST スクリプトの例と構文については、 「アクション ボタンの HTTP POST 要求」 を参照してください。

    • ダイヤルアウト遅延: トリガーを検出した後、電話機がイベントを開始するまでのタイムアウト期間を秒単位で設定します。 デフォルト値は 5 秒です。 0 に設定すると、トリガーが検出されるとすぐにイベントが開始されます。

    • サービス トリガー リストからトリガーを選択します: 1 回押す長押し、または 3 回押す

    • サービス シークレット (オプション): カスタム サービスにアクセスするために認証が必要な場合は、認証シークレット、トークン、またはパスワードを入力します。 入力された秘密はマスクされた文字列として表示され、マクロを使用して参照できます。 $SSカスタムコンテンツフィールド そして アクションボタンのサービス宛先

  • 複数のトリガー

    各グループ内のパラメータをそれぞれ設定します。 上記の緊急通話とカスタム サービスのセクションを参照してください。

  • 複数のイベントに対する単一のトリガー

    トリガーに複数のイベントを割り当てるには、次のパラメータを設定します。

    • アクションボタンの機能: 選択 カスタム

    • アクションボタンのサービス宛先: 通話する電話番号と XML サービス URL を次の形式で入力します。

      tel:<電話番号またはSIP URI> + <サービスURL>

      URLは以下で始まる必要があります http:// または https://

      例: 電話:1234 + https://10.11.20.159/path/service.xml

    • アクションボタンサービス名 (オプション): トリガーに関連付けられたサービスの名前を指定します。 この名前は、ユーザーがボタンを押したときに画面上のメッセージに表示され、どのサービスがトリガーされるかを示します。 名前が指定されていない場合、 カスタムサービス 表示名として使用されます。

    • カスタム コンテンツ フィールド (オプション): アクション ボタンが押されたときに電話機が HTTP POST 要求を送信できるようにする場合は、メソッド、ヘッダー、POST コンテンツなどの HTTP データを最大 1024 文字で入力します。

      POST スクリプトの例と構文については、 「アクション ボタンの HTTP POST 要求」を参照してください

    • ダイヤルアウト遅延: トリガーを検出した後、電話機がイベントを開始するまでのタイムアウト期間を秒単位で設定します。 デフォルト値は 5 秒です。 0 に設定すると、トリガーが検出されるとすぐにイベントが開始されます。

    • サービス トリガー リストからトリガーを選択します: 1 回押す長押し、または 3 回押す

    • サービス シークレット (オプション): カスタム サービスにアクセスするために認証が必要な場合は、認証シークレット、トークン、またはパスワードを入力します。 入力されたシークレットはマスクされた文字列として表示され、 カスタム コンテンツ フィールド および アクション ボタン サービス デスティネーション 内のマクロ $SSを使用して参照できます。

    • サイレント緊急通話 (オプション): サービス宛先に電話番号または URI をダイヤルした場合、この機能を有効にすると緊急通話がサイレントになります。

      デフォルトでは、緊急通話は他の発信通話と同様に双方向通話として機能します。 有効に設定すると、通話中に注意を引かないように、発信者側の音声は無音になります。 通話を終了できるのは、通話の受信者のみです。

      サイレント緊急通話中は、電話機 9841 の画面はフリーズし、電話機 9851、9861、および 9871 の画面はオフになります。 その他の機能にはアクセスできません。 受信者が通話を終了すると、電話機は通常の動作に戻ります。

    • サイレント緊急通話の取得を許可する (オプション): 緊急通話を維持しながらユーザが任意のキーを押して通常の電話操作を復元できるようにする場合は、この機能を有効にします。 ユーザが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままになります。

これらのパラメータの詳細については、「 アクション ボタンのパラメータ」を参照してください。

4

保存を選択します。

5

[設定の適用(Apply Config)] を選択します。

参考資料

アクションボタンのパラメータ

パラメータは、エンタープライズ電話設定、共通電話プロファイル、および個々の電話設定で使用できます。

表 1. アクションボタンのパラメータ
パラメータデフォルトとオプション説明
アクションボタン機能 1~3

デフォルト:Off

オプション: オフ、緊急通報、カスタム

特定のサービスでボタンを設定できます。

  • オフ:オフに設定すると、電話機の単一サービスに対するアクション ボタンは機能しません。
  • 緊急通報: 設定されている場合は、ユーザはアクション ボタンを使用して緊急通報を行うことができます。
  • カスタム: 構成されている場合、ユーザはアクション ボタンを使用してカスタム サービスにアクセスできます。

フィールドを 緊急通報 または カスタム に設定する場合は、 アクション ボタンのサービス宛先 フィールドにサービスの宛先を入力してください。 または、電話に設定エラーが表示されます。

アクションボタンサービス名 1~3

デフォルト:空

必要に応じて、アクション ボタンに関連付けられたサービスの名前を指定します。 この名前は、ユーザがボタンを押したときに画面上のメッセージに表示され、どのサービスがトリガーされるかを示します。

名前を指定しない場合は、 [アクション ボタンの機能] フィールドでの選択内容に基づいて、デフォルト名は「緊急通話」、「サイレント緊急通話」、または「カスタム アクション」になります。

アクションボタンサービス宛先 1~3

デフォルト:空

アクション ボタンに割り当てられたサービスに基づいて、次のいずれかの形式でサービス宛先を指定します。

  • 緊急通報サービスの場合は、電話番号または緊急サービスの URI を入力してください。

  • カスタム サービスのボタンを構成する場合は、サービス URL を入力します。 URL は http:// または https:// で始まる必要があります。 たとえば、 https://10.11.20.159/path/service.xml です。

  • 1 回のトリガーで複数のイベントを開始するようにボタンを構成するには、 tel:<電話番号または SIP URL> + <サービス RUL> と入力します。 : tel:1234 + https://10.11.20.159/path/service.xml

    SIP URI の呼び出しもサポートされています。 URI を tel: sip 4567@co.webex.com の形式で入力してください。

有効なサービス宛先を設定せずにアクション ボタンを有効にすると、電話のユーザには設定を求めるメッセージが表示されます。 ユーザがこの通知を閉じると、ボタンが適切に設定されるか無効になるまで、警告アイコンが電話画面のヘッダーに表示されたままになります。

電話番号はカスタム サービスの宛先として使用できません。 アクション ボタンを カスタム として設定し、サービスの宛先として電話番号を入力すると、ボタンが未設定であることを示す警告メッセージが電話に表示されます。 代わりに、 tel:<電話番号> の形式で電話番号を追加できます。たとえば、 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

デフォルト: シングルプレス

オプション: 1 回押す、長押し、3 回押す

ユーザが電話のアクション ボタンを使用して緊急通報を行う方法やカスタム サービスを開始する方法を選択します。

シングルプレス: アクション ボタンを押して、関連付けられている通話またはサービスをトリガーします。

長押し: アクション ボタンを 2 秒以上押し続けると、関連付けられている通話またはサービスがトリガーされます。

3 回押す: アクション ボタンを 2 秒未満の間隔で 3 回押すと、関連付けられた通話またはサービスがトリガーされます。

優先順位の低いパラメータは機能しないため、複数のサービスにわたってトリガーを繰り返さないでください。 優先順位は、最高から最低の順に、グループ 1、グループ 2、グループ 3 となります。

ダイヤルアウト遅延 1~3

デフォルト:5

オプション: 0 - 30

アクション ボタンが押された後に電話機が緊急通話またはカスタム アクションを開始するまでのタイムアウト期間 (秒単位) を設定します。

ボタンを 1 回押す、長押しする、または 3 回押すことで指定されるトリガーを検出するとすぐに電話が通話を発信したりイベントを開始したりするようにしたい場合は、0 に設定します。

サイレント緊急通報 1~3

デフォルト:[無効(Disabled)]

オプション: 有効、無効

サイレント緊急通話は、危険な状況で目立たずに援助を提供するために設計されています。 ユーザは音を立てずに助けを求めることができます。

  • 有効にすると、ユーザはアクション ボタンを使用して一方向の通話を発信できるようになります。

    サイレント緊急通報が発信された後は、相手側だけが通話を終了できます。 通話中に注意を引かないように、電話機 9841 の画面はフリーズし、電話機 9851、9861、9871 の画面はオフになります。 デフォルトでは、サイレント緊急通話中は電話機のすべての機能がロックされます。 サイレント緊急通話を維持しながらユーザが通常の電話操作を復元できるようにするには、 サイレント緊急通話の取得を許可する 機能を有効にします。

  • 無効にすると、緊急通話は他の発信通話と同様に双方向通話として機能します。

サイレント緊急通話の取得を許可する

デフォルト:[いいえ(No)]

オプション:はい、いいえ

サイレント緊急通話中にユーザが電話機能を取得できるかどうかを制御します。 デフォルトでは、サイレント緊急通話が開始されると、通話の受信者が通話を終了するまで電話機のすべての機能がロックされます。

このパラメータを はい に設定すると、ユーザは任意のキーを押して緊急通話を維持しながら通常の電話操作を復元できます。 ユーザが音量キーを使用して音量を上げない限り、通話音声は無音のままになります。

アクションボタンの 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: Bearer username:$SS' --body 'Trueこれは HTTP POST 用です XML' サンプル #2: JSON --method POST --header 'Content-Type: application/json' --header 'Authorization: $SS' --body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"これは 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%3e これは HTTP POST 用です XML%3c/Description%3e%3c/MetaData%3e%27
表 3. サポートされているマクロ
マクロ名マクロ展開
#デバイス名#発信システムに表示されるデバイス名。 例えば、SEP845A3EC21288
$SS認証シークレット、トークン、パスワードなど、電話の設定ページにマスクされた文字列を表示するサービス シークレット。