アクションボタン（統合CM）を設定する

アクションボタンは、Cisco Wireless Phone 9821の右側にある赤いボタンです。これにより、ユーザーは緊急サービスやカスタムサービスなどの指定されたサービスに迅速にアクセスできるようになります。ボタンをカスタマイズして、特定の用途に合ったイベントを開始させることができます。

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

1	Cisco Unified Communications Manager Administrationで、必要に応じて以下のいずれかの操作を実行します。展開済みのすべての電話機を設定するには、システムに移動します。 > エンタープライズ電話の設定。同じ電話プロファイルを共有する電話を設定するには、デバイスに移動します。 > デバイス設定 > 共通電話プロファイル。個々の電話機を設定するには、デバイスに移動してください。 > 電話。次に、お使いのスマートフォンを見つけて、「電話設定」ページを開きます。構成は階層構造に従います。個々のデバイス設定は、共通の電話プロファイルおよび企業レベルの設定よりも優先されます。共通の電話プロファイル設定は、企業レベルの設定を上書きします。
2	使用状況に応じて、アクションボタンのパラメータをカスタマイズしてください。アクションボタンには3つのパラメータグループがあり、それぞれが固有のトリガーを持つサービスに対応しています。サービストリガーが複数のグループで指定されている場合、グループ1の設定がグループ2およびグループ3の設定よりも優先され、グループ2の設定がグループ3よりも優先されます。緊急通話カスタムサービス複数のトリガー複数のイベントに対する単一のトリガーこれらのパラメータの詳細については、製品固有の構成パラメータを参照してください。
3	[保存] を選択します。
4	設定を適用を選択します。

緊急通報パラメータ設定

緊急通報に関する以下のパラメータを設定してください。

表1. 緊急通報パラメータ設定
パラメーター	設定
アクションボタンの機能	緊急通報を選択してください。
アクションボタンサービス宛先	緊急サービスの電話番号またはURIを入力してください。
アクションボタンサービス名	（オプション）トリガーに関連付けられたサービスの名前を指定します。ユーザーがボタンを押した際に画面に表示されるメッセージにこの名前が表示され、どのサービスが起動されるかを示します。名前が指定されていない場合は、 `Emergency call` または `Silent emergency call` が表示名として使用されます。
発信遅延	トリガーを検出してから電話機がイベントを開始するまでのタイムアウト期間を秒単位で設定します。デフォルト値は5秒です。0に設定すると、トリガーが検出されるとすぐにイベントが開始されます。遅延画面にはカウントダウンタイマーが表示され、ユーザーはアクションボタンによって開始されたアクションをキャンセルすることができます。緊急通報時には、Cisco Wireless Phone 9821は遅延画面が表示されている間、継続的に振動します。ただし、無音の緊急通報や信号の場合、Cisco Wireless Phone 9821は振動しません。
サービストリガー	リストからトリガーを選択してください。1回押す、長押し、または 3回押す。
サイレント緊急通報	（オプション）デフォルトでは、緊急通報は他の発信通話と同様に双方向通話として機能します。サイレント緊急通報が有効になっている場合、通話中に周囲の注意を引かないように、発信者側の音声は無音になります。サイレント緊急通報を終了できるのは、通話の受信者のみです。サイレント緊急通話中は、Cisco Wireless Phone 9821の画面はオフになります。その他の機能はすべて利用できません。相手が通話を終了すると、電話機は通常の動作に戻ります。
サイレント緊急通報の取得を許可する	（オプション）緊急通報を維持しながら、ユーザーが任意のキーを押して通常の電話操作を復元できるようにする場合は、この機能を有効にしてください。ユーザーが音量キーを使ってスピーカーの音量を上げない限り、通話音声は無音のままです。

カスタムサービスパラメータ設定

カスタムサービスの場合は、以下のパラメータを設定してください。

表2 カスタムサービスパラメータ設定
パラメーター	設定
アクションボタンの機能	カスタムを選択してください。
アクションボタンサービス宛先	カスタムサービスのURLを入力してください。URLは `http://` または `https://`で始まる必要があります。たとえば、 `https://10.11.20.159/path/service.xml`です。
アクションボタンサービス名	（オプション）トリガーに関連付けられたサービスの名前を指定します。ユーザーがボタンを押した際に画面に表示されるメッセージにこの名前が表示され、どのサービスが起動されるかを示します。名前が指定されていない場合は、カスタムサービスが表示名として使用されます。
カスタムコンテンツフィールド	（オプション）アクションボタンが押されたときに電話機がHTTP POSTリクエストを送信するようにするには、メソッド、ヘッダー、POSTコンテンツなどのHTTPデータを入力します。最大長は1024文字です。 POST スクリプトの例と構文については、アクションボタンのHTTP POSTリクエストを参照してください。
発信遅延	トリガーを検出してから電話機がイベントを開始するまでのタイムアウト期間を秒単位で設定します。デフォルト値は5秒です。0に設定すると、トリガーが検出されるとすぐにイベントが開始されます。遅延画面にはカウントダウンタイマーが表示され、ユーザーはアクションボタンによって開始されたアクションをキャンセルすることができます。カスタムサービスシナリオでは、Cisco Wireless Phone 9821は遅延画面が表示されている間、継続的に振動します。
サービストリガー	リストからトリガーを選択してください。1回押す、長押し、または 3回押す。
サービスシークレット	認証シークレット、トークン、またはパスワードなどの秘密文字列を設定します。入力されたシークレットはマスクされた文字列として表示され、カスタムコンテンツフィールドおよびアクションボタンサービス宛先でマクロ `$SS` ]を使用して参照できます。

複数のトリガーのパラメータ設定

各グループのパラメータをそれぞれ設定してください。上記の 「緊急通報 」および 「顧客サービス 」のセクションをご覧ください。

複数のイベントのパラメータ設定を単一のトリガーで制御する

複数のイベントをトリガーに割り当てるには、以下のパラメータを設定してください。

表3。複数のイベントのパラメータ設定を単一のトリガーで制御する
パラメーター	設定
アクションボタンの機能	カスタムを選択してください。
アクションボタンサービス宛先	発信する電話番号とXMLサービスURLを以下の形式で入力してください。 `tel: +` URLは `http://` または `https://`で始まる必要があります。例: `tel:1234 + https://10.11.20.159/path/service.xml`
アクションボタンサービス名	（オプション）トリガーに関連付けられたサービスの名前を指定します。ユーザーがボタンを押した際に画面に表示されるメッセージにこの名前が表示され、どのサービスが起動されるかを示します。名前が指定されていない場合は、カスタムサービスが表示名として使用されます。
カスタムコンテンツフィールド	（オプション）アクションボタンが押されたときに電話機がHTTP POSTリクエストを送信するようにするには、メソッド、ヘッダー、POSTコンテンツなどのHTTPデータを入力します。最大長は1024文字です。 POST スクリプトの例と構文については、アクションボタンのHTTP POSTリクエストを参照してください。
発信遅延	トリガーを検出してから電話機がイベントを開始するまでのタイムアウト期間を秒単位で設定します。デフォルト値は5秒です。0に設定すると、トリガーが検出されるとすぐにイベントが開始されます。遅延画面にはカウントダウンタイマーが表示され、ユーザーはアクションボタンによって開始されたアクションをキャンセルすることができます。緊急通報や顧客サービス対応の際、Cisco Wireless Phone 9821は遅延画面が表示されている間、継続的に振動します。ただし、無音の緊急通報や信号の場合、Cisco Wireless Phone 9821は振動しません。
サービストリガー	リストからトリガーを選択してください。1回押す、長押し、または 3回押す。
サービスシークレット	認証シークレット、トークン、またはパスワードなどの秘密文字列を設定します。入力されたシークレットはマスクされた文字列として表示され、カスタムコンテンツフィールドおよびアクションボタンサービス宛先でマクロ `$SS` ]を使用して参照できます。
サイレント緊急通報	（オプション）デフォルトでは、緊急通報は他の発信通話と同様に双方向通話として機能します。サイレント緊急通報が有効になっている場合、通話中に周囲の注意を引かないように、発信者側の音声は無音になります。サイレント緊急通報を終了できるのは、通話の受信者のみです。サイレント緊急通話中は、Cisco Wireless Phone 9821の画面はオフになります。その他の機能はすべて利用できません。相手が通話を終了すると、電話機は通常の動作に戻ります。
サイレント緊急通報の取得を許可する	（オプション）緊急通報を維持しながら、ユーザーが任意のキーを押して通常の電話操作を復元できるようにする場合は、この機能を有効にしてください。ユーザーが音量キーを使ってスピーカーの音量を上げない限り、通話音声は無音のままです。

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

Cisco Wireless Phone 9821のアクションボタンは、HTTP POSTリクエストを介してXMLアプリケーションを起動するように設定できます。

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

以下の例はXMLとJSON形式です。

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '' 

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 CMでは、RFC 3986に従って、予約文字にパーセントエンコーディングを使用する必要があります。

表 4. 予約文字のパーセントエンコーディング
キャラクター	パーセントエンコーディング
&	`%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

表 5. サポートされているマクロ
マクロ名	マクロ展開
#DEVICENAME#	発信システムに表示されるデバイス名。例えば、SEP845A3EC21288
$SS	電話の設定ページにマスクされた文字列として表示されるサービスシークレット。認証シークレット、トークン、パスワードなど。

Cisco AI Assistant

コメントありがとうございます。

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

緊急通報パラメータ設定

カスタムサービスパラメータ設定

複数のトリガーのパラメータ設定

複数のイベントのパラメータ設定を単一のトリガーで制御する

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

小規模企業

エンタープライズ

デバイス

次のためのソリューション:

リソース

会社