この記事の内容
dropdown icon
アクションボタンをカスタマイズする
    緊急通話パラメータ設定
    カスタムサービスパラメータ設定
    複数のイベントパラメータ設定のための単一のトリガー
    複数のトリガーを設定する
アクションボタンの HTTP POST リクエスト
XML URL でサポートされているマクロ変数
アクションボタンの設定(コントロールハブ)
list-menuこの記事の内容
list-menuフィードバックがある場合

このヘルプ記事は、Cisco ワイヤレスフォン 9821(Webex Calling に登録されている)に関するものです。

アクションボタンは、Cisco ワイヤレス電話 9821 の右側にある赤いボタンです。これにより、緊急サービスやカスタムサービスなど、指定されたサービスに迅速にアクセスできます。 特定のユースケースに適したイベントを開始するようにボタンをカスタマイズできます。

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

1

顧客視点から コントロールハブ、へ デバイスをタップして、お使いの携帯電話を選択します。

2

選択 すべての構成

3

電話 セクションに移動し、 アクション ボタンを選択します

4

アクションボタンのパラメータは、あなたのユースケースに合わせてカスタマイズしてください。

これらのパラメータの詳細については、Control Hub の Cisco Wireless Phone 9821 設定のパラメータ をご覧ください

5

[次へ(Next)] を選択します。

6

変更内容を確認して選択 適用する

7

選択 近い ページを閉じます。

緊急通話パラメータ設定

緊急通話用のアクション ボタンを使用すると、ワークスペースで重要なサポートに迅速かつ簡単にアクセスできます。 緊急通報用のパラメータを以下設定してください。

表 1. 緊急通話パラメータ設定

パラメータ

設定 

アクションボタンの機能

緊急通報 選択

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

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

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

(任意)トリガーに関連付けられたサービス名を指定します。 この名前は、ユーザがボタンを押したときに画面上のメッセージに表示され、どのサービスがトリガーされるかを示します。 名前が指定されていない場合は、表示名として 緊急呼び出し または 無言緊急呼び出し が使用されます。

発信遅延

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

ディレイ画面にはカウントダウンタイマーが表示され、ユーザはアクションボタンでトリガーされたアクションをキャンセルできます。 緊急通話時には、Cisco ワイヤレス電話 9821 が遅延画面が表示されながら連続して振動します。 しかし、サイレントの緊急通話や信号の場合、Cisco Wireless Phone 9821 は振動しません。

サービストリガー

リストからトリガーを選択してください: 単発押, 長押し、または 3 回押

サイレント緊急通報

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

サイレント緊急通話中、Cisco ワイヤレス電話 9821 の画面が消灯します。 その他の機能にはアクセスできません。 受信者が通話を終了すると、電話機は通常の動作に戻ります。

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

(任意)緊急通話を維持しながら、ユーザが任意のキーを押して通常の電話機能に戻せるようにすれば、この機能を有効にしてください。 ユーザが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままになります。

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

アクション ボタンをカスタム サービスに関連付けると、電話ユーザは、ボタンを 1 回押す、長押しする、3 回押すなどの指定されたトリガーによってサービスにアクセスできるようになります。

カスタムサービスのために以下のパラメータを設定してください。

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

パラメータ

設定 

アクションボタンの機能

Select Custom

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

カスタムサービスの URL を入力してください。 URL は http:// または https:// で始まる必要があります (例: https://10.11.20.159/path/service.xml)。

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

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

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

(任意)アクションボタンが押されたときに HTTP POST リクエストを送信できるようにしたい場合は、メソッド、ヘッダー、POST 内容などの HTTP データを最大 1024 文字で入力してください。

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

発信遅延

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

ディレイ画面にはカウントダウンタイマーが表示され、ユーザはアクションボタンでトリガーされたアクションをキャンセルできます。 カスタムサービス中、Cisco ワイヤレス電話 9821 は遅延画面が表示されながら連続して振動します。

サービストリガー

リストからトリガーを選択してください: 単発押, 長押し、または 3 回押

複数のイベントパラメータ設定のための単一のトリガー

複数のイベントに対する単一のトリガーにより、アクション ボタンの 1 つのアクションで複数の関連するプロセスを同時に開始できます。 この機能により、応答性が向上し、複雑さが軽減され、アプリケーション間でシームレスなワークフロー実行が保証されます。

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

表 3. 複数のイベントパラメータ設定のための単一のトリガー

パラメータ

設定 

アクションボタンの機能

Select Custom

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

電話番号と XML サービス URL をこの形式で入力してください:

tel:<電話番号または SIP URI> + <サービス URL>

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

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

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

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

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

(任意)Action ボタンを押したときに HTTP POST リクエストを送信できるようにしたい場合は、メソッド、ヘッダー、POST コンテンツなどの HTTP データを最大 1024 文字で入力してください。

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

発信遅延

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

ディレイ画面にはカウントダウンタイマーが表示され、ユーザはアクションボタンでトリガーされたアクションをキャンセルできます。 緊急呼び出しやカスタムサービスの際、Cisco ワイヤレス電話 9821 は遅延画面が表示されながら連続して振動します。 しかし、サイレントの緊急通話や信号の場合、Cisco Wireless Phone 9821 は振動しません。

サービストリガー

リストからトリガーを選択してください: 単発押, 長押し、または 3 回押

サイレント緊急通報

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

サイレント緊急通話中は、Cisco ワイヤレス電話 9821 画面が消灯します。 その他の機能にはアクセスできません。 受信者が通話を終了すると、電話機は通常の動作に戻ります。

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

(任意)緊急通話を維持しながら、ユーザが任意のキーを押して通常の電話機能に戻せるようにすれば、この機能を有効にしてください。 ユーザが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままになります。

複数のトリガーを設定する

アクション ボタンを構成して複数のサービスに接続し、各サービスに独自のトリガーを割り当てることができます。 たとえば、アクション ボタンを長押しすると、指定された緊急エージェントに電話がかかり、ボタンを 1 回短く押すと、企業内の電話に通知が送信されます。

1

サービストリガーマルチトリガーに設定します。

  • MultiTrigger オプションを選択すると、 Service Trigger MultiTrigger セクションの設定のみが適用され、そのセクション外のアクションボタンに関連する設定は無視されます。

  • MultiTrigger オプションが選択されている場合は、少なくとも 1 つのトリガーを構成してください。

2

Service Trigger MultiTrigger にアクセスし、利用可能なオプションから希望のトリガーを選択します - Single Press Long Press

3

選択したトリガーに対して次のパラメータを構成します。

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

パラメータ

設定 

アクションボタンの機能

トリガーを通じて電話ユーザがアクセスできるサービスを選択します。

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

電話番号またはサービスの URI を入力します。

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

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

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

(任意)アクションボタンを押したときに HTTP POST リクエストを送信できるようにしたい場合は、メソッド、ヘッダー、POST 内容などの HTTP データを最大 1024 文字で入力してください。

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

発信遅延

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

ディレイ画面にはカウントダウンタイマーが表示され、ユーザはアクションボタンでトリガーされたアクションをキャンセルできます。 緊急呼び出しやカスタムサービスのシナリオでは、Cisco ワイヤレス電話 9821 が遅延画面が表示されながら連続して振動します。 しかし、無音の緊急通話や信号の場合、Cisco Wireless Phone 9821 は振動しません。

サイレント緊急通報

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

サイレント緊急通話中、Cisco ワイヤレス電話 9821 の画面が消灯します。 その他の機能にはアクセスできません。 受信者が通話を終了すると、電話機は通常の動作に戻ります。

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

(任意)緊急通話を維持しながら、ユーザが任意のキーを押して通常の電話機能に戻せるようにすれば、この機能を有効にしてください。 ユーザが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままになります。

4

ステップ 2 と 3 を続けて、さらにトリガーを設定してください。

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

Cisco ワイヤレス電話 9821 のアクションボタンは、HTTP POST リクエストを通じて XML アプリケーションをトリガーするように設定できます。

カスタム コンテンツ フィールドに、リクエスト スクリプトを入力します。 XML または JSON コンテンツ タイプのいずれかを指定して、リクエストにマクロを含めることができます。

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

サンプル #1: XML --method POST --header 'Content-Type: application/XML' --body '<MetaData><Trigger>True</Trigger><Description>これは HTTP 用です POST XML</Description></MetaData>' サンプル #2: JSON --method POST --header 'Content-Type: application/json' --body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"これは HTTP 用です POST JSON"}]}' 

次の例は、HTTP POST リクエストです。

--method POST --header 'Content-Type: application/XML' --body '<MetaData><Trigger>True</Trigger><Description>これは HTTP POST XML</Description></MetaData> 用です'
表 5. サポートされているマクロ
マクロ名マクロ展開
#デバイス名#発信システムに表示されるデバイス名(例:SEP845A3EC21288)
$MA小文字の 16 進数を使用した MAC アドレス(000e08aabbcc)。
$MCASTADDRマルチキャスト ページング アプリケーションのアドレス。

$PN

$PSN

製品名(例:DP-9851、DP-9871)。
$SNシリアル番号文字列。例: FVH28022D0T。

XML URL でサポートされているマクロ変数

XML URL でマクロ変数を使用することができます。 次のマクロ変数がサポートされています。

  • ユーザー ID:UID1、UID2 ~ UIDn

  • 表示名:DISPLAYNAME1、DISPLAYNAME2 ~ DISPLAYNAMEn

  • 認証 ID:AUTHID1、AUTHID2 ~ AUTHIDn

  • プロキシ:PROXY1、PROXY2 ~ PROXYn

  • 小文字の 16 進数を使用した MAC アドレス:MA

  • 製品名:PN

  • 製品シリアル番号:PSN

  • シリアル番号:SERIAL_NUMBER

表 6. サポートされているマクロ
マクロ名マクロ展開
$$$ 形式は、単一の $ 文字に展開されます。
A ~ P汎用パラメータ GPP_A ~ GPP_P で置き換えられます。
SA ~ SD特殊用途のパラメータ GPP_SA ~ GPP_SD で置き換えられます。 これらのパラメータには、プロビジョニングで使用されるキーまたはパスワードが保持されます。

$SA ~ $SD は、オプションの resync URL 修飾子 --key を引数として認識されます。

MA小文字の 16 進数を使用した MAC アドレス(000e08aabbcc)。
MAU大文字の 16 進数を使用した MAC アドレス(000E08AABBCC)。
MAC小文字の 16 進数を使用し、16 進数ペアがコロンで区切られた MAC アドレス(00:0e:08:aa:bb:cc)。
PN製品名;例えば、Cisco ワイヤレス電話 9821。
PSN製品シリーズ番号;例えば、9821。
SNシリアルナンバー文字列;例えば、FVH29513116。
CCERTSSL クライアント証明書のステータス(インストール済みまたは未インストール)。
IPローカル サブネット内の電話機の IP アドレス。192.168.1.100 など。
EXTIPインターネットで表示される、電話機の外部 IP。66.43.16.52 など。

SWVER

ソフトウェア バージョン文字列。 例えば、PHONEOS-9821.5-0-1-0004-19。

HWVER

ハードウェアのバージョン文字列 例えば、2.0.1

PRVST

プロビジョニングの状態(数値文字列)

-1 = 明示的な再同期要求

0 = 電源投入再同期

1 = 定期的な再同期

2 = 再同期の失敗、再試行

UPGST

アップグレードの状態(数値文字列)

1 = 最初のアップグレード試行

2 = アップグレードの失敗、再試行

UPGERR

前回のアップグレード試行の結果メッセージ(ERR)。例:http_get が失敗しました。

PRVTMR

最後の再同期から経過した秒数。

UPGTMR

最後のアップグレード試行から経過した秒数。

REGTMR1

SIP サーバで回線 1 が登録解除されてから経過した秒数。

REGTMR2

SIP サーバーで回線 2 が登録解除されてから経過した秒数。

UPGCOND

レガシーのマクロ名。

SCHEME

再同期またはアップグレード URL の解析後に取得される TFTP、HTTP、または HTTPS のいずれかのファイル アクセス スキーム。

SERV

再同期またはアップグレード URL の解析後に取得される、要求ターゲット サーバーのホスト名。

SERVIP

おそらく DNS ルックアップの後、再同期またはアップグレード URL の解析後に取得される、要求ターゲット サーバーの IP アドレス。

PORT

再同期またはアップグレード URL の解析後に取得される、要求ターゲット UDP/TCP ポート。

パス

再同期またはアップグレード URL の解析後に取得される、要求ターゲット ファイル パス。

ERR

再同期またはアップグレード試行の結果のメッセージ。 結果の syslog メッセージを生成するときにのみ役立ちます。 アップグレード試行の場合、UPGERR 変数の値は保持されます。

UIDn

回線 n の UserID 設定パラメータの内容。

ISCUST

ユニットがカスタマイズされている場合、値は 1。それ以外の場合は 0。

カスタマイズのステータスは、Web UI 情報ページで確認できます。

INCOMINGNAME最初の接続、呼び出し、または着信コールに関連付けられた名前。
REMOTENUMBER

最初の接続、呼び出し、または着信コールの電話番号。 複数のコールがある場合は、最初に見つかったコールに関連付けられているデータが渡されます。

DISPLAYNAMEn回線 N の表示名設定パラメータの内容。
AUTHIDn回線 N の認証 ID 設定パラメータの内容。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?