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