- ホーム
- /
- 投稿記事
9800 のアクション ボタンを設定します (Unified CM)
アクション ボタンは、携帯電話の右上にある赤いボタンです。 これにより、ユーザは緊急サービスやカスタム サービスなどの指定されたサービスに迅速にアクセスできるようになります。 特定のユースケースに適したイベントを開始するようにボタンをカスタマイズできます。 このページの情報は、Cisco Unified Communications Manager (Unified CM) に登録されている Cisco デスクフォン 9800 シリーズに適用されます。
アクションボタンをカスタマイズする
Cisco デスクフォン 9800 シリーズのアクション ボタンのカスタム オプションには、特定の PhoneOS ファームウェア サポートが必要です。 詳細については、次の表を参照してください。
| 特長 | 必要なファームウェアバージョン |
|---|---|
| 緊急通話 | PhoneOS 3.0.1 以降 |
| カスタムサービス | PhoneOS 3.2.1 以降 |
| 複数のトリガー | PhoneOS 3.3.1 以降 |
| HTTP POST | PhoneOS 3.3.1 以降 |
| 単一のトリガーで複数のイベント | PhoneOS 3.4.1 以降 |
| 1 |
Cisco Unified Communications Manager の管理 にログインします。 |
| 2 |
必要に応じて、次のいずれかのアクションを実行します。
構成は階層構造に従います。
|
| 3 |
使用事例に応じて、次のパラメータを使用してアクション ボタンの設定をカスタマイズします。 アクション ボタンには 3 つのパラメータ グループがあり、それぞれが固有のトリガーを持つサービスに対応しています。 サービス トリガーが複数のグループで指定されている場合、グループ 1 の設定はグループ 2 と 3 の設定よりも優先され、グループ 2 はグループ 3 よりも優先されます。
これらのパラメータの詳細については、「 アクション ボタンのパラメータ」を参照してください。 |
| 4 |
保存を選択します。 |
| 5 |
[設定の適用(Apply Config)] を選択します。 |
参考資料
アクションボタンのパラメータ
パラメータは、エンタープライズ電話設定、共通電話プロファイル、および個々の電話設定で使用できます。
| パラメータ | デフォルトとオプション | Description |
|---|---|---|
| アクションボタン機能 1~3 |
デフォルト: オフ オプション: オフ、緊急通話、カスタム |
特定のサービスでボタンを設定できます。
フィールドを 緊急通報 または カスタムサービスの宛先を必ず入力してください。 アクションボタンのサービス宛先 分野。 または、電話に設定エラーが表示されます。 |
| アクションボタンサービス名 1~3 |
デフォルト:空 |
必要に応じて、アクション ボタンに関連付けられたサービスの名前を指定します。 この名前は、ユーザがボタンを押したときに画面上のメッセージに表示され、どのサービスがトリガーされるかを示します。 名前を指定しない場合は、[ アクション ボタンの機能 ] フィールドでの選択内容に基づいて、デフォルト名は [緊急通話]、[サイレント緊急通話]、または [カスタム アクション] になります。 |
| アクションボタンサービス宛先 1~3 |
デフォルト:空 |
アクション ボタンに割り当てられたサービスに基づいて、次のいずれかの形式でサービス宛先を指定します。
有効なサービス宛先を設定せずにアクション ボタンを有効にすると、電話のユーザには設定を求めるメッセージが表示されます。 ユーザがこの通知を閉じると、ボタンが適切に設定されるか無効になるまで、警告アイコンが電話画面のヘッダーに表示されたままになります。 電話番号はカスタムサービスの宛先として使用できません。 アクション ボタンを カスタム として設定し、サービスの宛先として電話番号を入力すると、ボタンが未設定であることを示す警告メッセージが電話に表示されます。 代わりに、 アンパサンド (&) を含む 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 データでは、マクロ 例と構文については、 「アクション ボタンの HTTP POST リクエスト」 を参照してください。 |
| サービスシークレット 1~3 |
デフォルト:空 |
サービス シークレットは、認証シークレット、トークン、またはパスワードになります。 入力されたシークレットはマスクされた文字列として表示され、カスタム コンテンツ フィールド |
| サービストリガー 1~3 |
デフォルト: シングルプレス オプション: 1 回押す、長押し、3 回押す |
ユーザが電話のアクション ボタンを使用して緊急通報を行う方法やカスタム サービスを開始する方法を選択します。 1 回押す : アクション ボタンを押すと、関連付けられている通話またはサービスがトリガーされます。 長押し: アクション ボタンを 2 秒以上押し続けると、関連する通話またはサービスがトリガーされます。 3 回押す: アクション ボタンを 2 秒未満の間隔で 3 回押すと、関連付けられている通話またはサービスがトリガーされます。 優先順位の低いパラメータは機能しないため、複数のサービスにわたってトリガーを繰り返さないでください。 優先順位は、最高から最低の順に、グループ 1、グループ 2、グループ 3 となります。 |
| ダイヤルアウト遅延 1~3 |
デフォルト:5 オプション: 0 - 30 |
アクション ボタンが押された後、電話機が緊急通話またはカスタム アクションを開始するまでのタイムアウト期間 (秒) を設定します。 ボタンを 1 回押す、長押しする、または 3 回押すことで指定されるトリガーを検出するとすぐに電話機で通話を発信したりイベントを開始したりする場合は、0 に設定します。 |
| サイレント緊急通報 1~3 |
デフォルト:[無効(Disabled)] オプション: 有効、無効 |
サイレント緊急通話は、危険な状況で目立たずに援助を提供するために設計されています。 ユーザは音を立てずに助けを求めることができます。
|
| サイレント緊急通話の取得を許可する |
デフォルト:[いいえ(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 に従って予約文字のパーセントエンコードが必要です。
| 文字 | パーセントエンコーディング |
|---|---|
| および | %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
| マクロ名 | マクロ展開 |
|---|---|
| #デバイス名# | 発信システムに表示されるデバイス名。 例えば、SEP845A3EC21288 |
| $SS | 認証シークレット、トークン、パスワードなど、電話の設定ページにマスクされた文字列を表示するサービス シークレット。 |