この記事の内容
アクションボタンをカスタマイズする
dropdown icon
参考資料
    アクションボタンのパラメータ
    アクションボタンの HTTP POST リクエスト

9800 のアクション ボタンを設定します (Unified CM)

list-menuこの記事の内容
list-menuフィードバックがある場合

アクション ボタンは、携帯電話の右上にある赤いボタンです。 これにより、ユーザは緊急サービスやカスタム サービスなどの指定されたサービスに迅速にアクセスできるようになります。 特定のユースケースに適したイベントを開始するようにボタンをカスタマイズできます。 このページの情報は、Cisco Unified Communications Manager (Unified CM) に登録されている Cisco デスクフォン 9800 シリーズに適用されます。

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

Cisco デスクフォン 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

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

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

  • 緊急コール

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

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

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

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

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

    • サービストリガー リストからトリガーを選択します: シングルプレス長押し、または 3 回押す

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

      サイレント緊急通話中は、電話機 9811 と 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:// で始まる必要があります。

      例: tel:1234 + https://10.11.20.159/path/service.xml

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

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

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

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

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

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

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

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

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

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

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

4

保存を選択します。

5

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

参考資料

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

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

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

デフォルト: オフ

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

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

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

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

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

デフォルト:空

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

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

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

デフォルト:空

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

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

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

  • 1 回のトリガーで複数のイベントを開始するようにボタンを構成するには、 tel:<phonenumber or SIP URL> + <Service 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&b=2&c=3 ではなく、 http://1.2.3.4/phone?a=1%26b=2%26c=3 と入力します。

カスタムコンテンツフィールド 1~3

デフォルト:空

この設定は、 アクション ボタンの機能カスタムに設定されている場合にのみ機能します。

メソッド、ヘッダー、POST コンテンツなどの HTTP データ (最大 1024 文字) を入力します。 設定すると、アクションが押されたときに電話機は HTTP POST 要求を送信します。

サービスにアクセスするために認証が必要な場合は、 [サービス シークレット] フィールドに認証シークレットを入力してください。 HTTP データでは、マクロ $SS をサービス シークレットへの参照として使用します。

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

サービスシークレット 1~3

デフォルト:空

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

サービストリガー 1~3

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

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

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

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

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

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

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

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

デフォルト:5

オプション: 0 - 30

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

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

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

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

オプション: 有効、無効

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

  • 有効にすると、ユーザはアクション ボタンを使用して一方向通話を行うことができます。

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

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

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

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

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

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

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

アクションボタンの HTTP POST リクエスト

Cisco デスクフォン 9800 シリーズのアクション ボタンは、HTTP POST 要求を通じて XML アプリケーションをトリガーするように設定できます。

カスタムコンテンツフィールド、カスタマイズしたリクエスト スクリプトを入力します。 XML または JSON コンテンツ タイプのいずれかを指定して、リクエストにマクロを含めることができます。 例えば、 $SSスクリプトに追加して、認証シークレット、トークン、またはパスワードを取得できます。 サービスシークレット 分野。

次の例は、XML と JSON にあります。

サンプル #1: XML --method POST --header 'Content-Type: application/XML' --header 'Authorization: Bearer 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%3e これは HTTP 用です POST XML%3c/Description%3e%3c/MetaData%3e%27
表 3. サポートされているマクロ
マクロ名マクロ展開
#デバイス名#発信システムに表示されるデバイス名。 例えば、SEP845A3EC21288
$SS認証シークレット、トークン、パスワードなど、電話の設定ページにマスクされた文字列を表示するサービス シークレット。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?