この記事の内容
アクションボタンをカスタマイズしてください
dropdown icon
参考文献
    アクションボタンのパラメーター
    アクションボタンのHTTP POSTリクエスト
9800のアクションボタンを設定してください(Unified CM)
list-menuこの記事の内容
list-menuフィードバックがある場合

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

アクションボタンをカスタマイズしてください

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

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

Cisco Unified Communications Manager Administrationにログインします。

2

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

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

設定は階層構造になっています。

  • 個々のデバイス設定は、 共通の電話プロファイルや企業レベルの設定よりも優先されます
  • 一般的な電話プロファイル設定は、企業レベルの設定よりも優先されます

3

ユースケースに応じて、次のパラメータでアクションボタンの設定をカスタマイズしてください。

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

  • 緊急通報

    次のパラメータを設定してください。

    • アクションボタン機能: 緊急通報を選択してください。

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

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

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

    • サービストリガーリストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

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

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

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

  • カスタムサービス

    次のパラメータを設定してください。

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

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

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

    • カスタムコンテンツフィールド(オプション): アクションボタンが押されたときに電話がHTTP Postリクエストを送信できるようにするには、メソッド、ヘッダー、 投稿コンテンツなどのHTTPデータを最大1024文字で入力してください。

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

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

    • サービストリガーリストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

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

  • 複数のトリガー

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

  • 1つのトリガーで複数のイベントに対応

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

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

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

      tel:<phonenumber or SIP URI> + <serviceURL>

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

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

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

    • カスタムコンテンツフィールド(オプション): アクションボタンが押されたときに電話がHTTP Postリクエストを送信できるようにするには、メソッド、ヘッダー、 投稿コンテンツなどのHTTPデータを最大1024文字で入力してください。

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

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

    • サービストリガーリストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

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

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

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

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

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

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

4

[保存] を選択します。

5

「設定を適用」を選択します。

参考文献

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

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

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

デフォルト:オフ

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

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

  • オフ:オフに設定すると、 電話のシングルサービスのアクションボタンは機能しません。
  • 緊急通報:ユーザーは「アクション」 ボタンを使用して緊急電話をかけることができます(設定されている場合)。
  • カスタム:ユーザーは、設定されていれば、 アクションボタンを使用してカスタムサービスにアクセスできます。

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

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

デフォルト:空です

オプションで、アクションボタンに関連するサービスの名前を指定してください。 この名前は、ユーザーがボタンを押すと画面上のメッセージに表示され、 どのサービスが起動されるかを示します。

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

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

デフォルト:空です

アクションボタンに割り当てられたサービスに基づいて、 サービスの宛先を次のいずれかの形式で提供してください。

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

  • カスタムサービスのボタンを設定するときは、サービスのURLを入力してください。 http://URLはまたはで始まる必要があります 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:1234。 たとえばtel:<phone number>、

アンパサンド(&)を含む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

デフォルト:空です

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

メソッド、ヘッダー、 投稿内容などのHTTPデータを最大1024文字で入力してください。 設定すると、 アクションが押されると、電話はHTTP Postリクエストを送信します。

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

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

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

デフォルト:空です

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

サービストリガー 1~3

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

オプション:シングルプレス、ロングプレス、3回プレス

電話のアクションボタンを使用して 、ユーザーが緊急電話をかける方法やカスタムサービスを開始する方法を選択してください。

シングルプレス:アクションボタンを押して、 関連する通話またはサービスを開始します。

長押し: アクションボタンを2秒以上押して、関連する通話またはサービスを開始します。

3回押す: アクションボタンを2秒以内の間隔で3回押すと、 関連する通話またはサービスが開始されます。

優先度の低いパラメータは機能しませんので、複数のサービスでトリガーを繰り返さないでください。 優先順位は、高いものから低いものの順です 。グループ1、グループ2、グループ3。

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

デフォルト:5

オプション:0-30

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

ボタンを1回押す、 長押し、または3回押すことで指定されるように、 トリガーを検知したらすぐに電話をかけたり、イベントを開始させたりしたい場合は、0に設定してください。

サイレント・エマージェンシー・コール 1~3

デフォルト:無効

オプション:有効、無効

サイレント・エマージェンシー・コールは、 危険な状況での目立たない支援を目的としています。 これにより、ユーザーは音を立てずに助けを求めることができます。

  • 有効にすると、ユーザーはアクションボタンで片道電話をかけることができます。

    サイレント・エマージェンシー・コールがかけられた後は、 相手だけが通話を終了できます。 通話中に注目されないように、 電話9811と9841の画面はフリーズし、電話9851、9861、9871の画面はオフになります。 サイレント・エマージェンシー・コール中は、 デフォルトではすべての機能がロックされます。 緊急通報をサイレントモードに保ちながら、 ユーザーが通常の電話操作に戻れるようにするには、 サイレント緊急電話の取得機能を有効にします。

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

サイレント・エマージェンシー・コール検索を許可します

デフォルト:いいえ

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

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

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

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

Cisco Desk Phone 9800シリーズのアクションボタンは、HTTP Postリクエストを介してXMLアプリケーションをトリガーするように設定できます。

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

次の例はXMLとJSON形式です。

Sample #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>' 

Sample #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サービスシークレットは、認証シークレット、トークン、 パスワードなどのマスクされた文字列を電話の設定ページに表示します。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?