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

このヘルプ記事は Webex Calling に登録されているシスコワイヤレスフォン 9821を対象としています。

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

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

1

Control Hubのカスタマービューから、[デバイス] に移動し、電話を選択します。

2

すべての構成を選択してください。

3

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

4

ユースケースに基づいてアクションボタンのパラメータをカスタマイズしてください。

5

次を選択してください。

6

変更内容を確認して [適用] を選択してください。

7

「閉じる」を選択してページを閉じます。

緊急通報のパラメータ設定

緊急通報用のアクションボタンを使用すると、 ワークスペースの重要な支援にすばやく簡単にアクセスできます。 緊急通報用に次のパラメータを設定してください。

テーブル 1.緊急通報パラメータ設定

パラメーター

設定

アクションボタン機能

緊急通報を選択してください。

アクションボタンサービスの送信先

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

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

(オプション) トリガーに関連するサービスの名前を指定してください。 この名前は、ユーザーがボタンを押すと画面上のメッセージに表示され、 どのサービスが起動されるかを示します。 名前が指定されていない場合は、 緊急通報またはサイレント・エマージェンシー・コールが表示名として使用されます。

ダイヤルアウト遅延

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

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 緊急通報のシナリオでは、遅延画面が表示されている間、シスコワイヤレス電話9821は継続的に振動します。 ただし、 無音の緊急電話や信号の場合、Ciscoワイヤレス電話9821は振動しません。

サービストリガー

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

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

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

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

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

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

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

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

カスタムサービスには次のパラメータを設定してください。

テーブル 2.カスタムサービスパラメータ設定

パラメーター

設定

アクションボタン機能

「カスタム」を選択します。

アクションボタンサービスの送信先

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

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

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

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

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

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

ダイヤルアウト遅延

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

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 カスタムサービスのシナリオでは、遅延画面が表示されている間、Ciscoワイヤレス電話9821は継続的に振動します。

サービストリガー

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

1つのトリガーで複数のイベントのパラメーター設定が可能

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

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

テーブル 3.1つのトリガーで複数のイベントのパラメーター設定が可能

パラメーター

設定

アクションボタン機能

「カスタム」を選択します。

アクションボタンサービスの送信先

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

電話:+ <phonenumber or SIP URI><serviceURL>

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

例: 電話:1234 + https://10.11.20.159/path/service.xml

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

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

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

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

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

ダイヤルアウト遅延

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

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 緊急通報やカスタムサービスのシナリオでは、遅延画面が表示されている間、Ciscoワイヤレス電話9821は継続的に振動します。 ただし、 無音の緊急電話や信号の場合、Ciscoワイヤレス電話9821は振動しません。

サービストリガー

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

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

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

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

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

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

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

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

1

サービストリガーをマルチトリガーに設定してください。

  • マルチトリガーオプションを選択すると、 サービストリガーマルチトリガーセクションの設定のみが適用され、 そのセクション外のアクションボタンに関する設定は無視されます。

  • MultiTriggerオプションを選択するときは、必ず少なくとも1つのトリガーを設定してください。

2

サービストリガーマルチトリガーに行き、利用可能なオプション( シングルプレス、ロングプレス、 3回プレス)から希望のトリガーを選択します。

3

選択したトリガーに次のパラメータを設定します。

テーブル 4.複数のトリガーパラメーター設定

パラメーター

設定

アクションボタン機能

電話ユーザーがトリガーを介してアクセスできるサービスを選択してください。

アクションボタンサービスの送信先

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

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

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

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

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

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

ダイヤルアウト遅延

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

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 緊急通報やカスタムサービスのシナリオでは、遅延画面が表示されている間、Ciscoワイヤレス電話9821は継続的に振動します。 ただし、 無音の緊急電話や信号の場合、Ciscoワイヤレス電話9821は振動しません。

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

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

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

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

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

4

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

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

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

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

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

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

次の例は、HTTP Postリクエストの場合です。

--method POST
--header 'Content-Type: application/xml'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>'
テーブル 5.サポートされているマクロ
マクロ名マクロ拡張
#DEVICENAME#通話システムに表示されるデバイス名。 たとえば、SEPE8BCE4956A29です。
$MA小文字の16進数字 (000e08aabbcc)を使用したMACアドレス。
$MCASTADDRマルチキャストページングアプリケーションのアドレス。

$PN

$PSN

製品名。たとえば、WP-9821などです。
$SNシリアル番号の文字列。たとえば、FVH29513116などです。

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

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

  • ユーザーID — UID1、UID2からUIDNへ

  • 表示名—表示名1、表示名2から表示名へ

  • 認証ID—認証ID1、認証番号2から認証IDN

  • プロキシ — プロキシ1、プロキシ2からプロキシNへ

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

  • 商品名—PN

  • 製品シリーズ番号—PSN

  • シリアル番号—シリアル番号

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

$SAから$SDは、 オプションの再同期URL修飾子--keyの引数として認識されます。

MA小文字の16進数字 (000e08aabbcc)を使用したMACアドレス。
MAU大文字の16進数を使用したMACアドレス(000E08AABBCC)。
MAC小文字の16進数でコロンを使用して16進数のペアを区切るMACアドレス(00:0 e: 08: aa: bb: cc)。
PN製品名。たとえば、シスコワイヤレスフォン 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

ライン1がSIPサーバーへの登録を失ってからの秒数。

REGTMR2

2行目がSIPサーバーへの登録を失ってからの秒数。

UPGCOND

レガシーマクロ名。

SCHEME

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

SERV

再同期またはアップグレードURLを解析した後に取得された、ターゲットサーバーのホスト名をリクエストしてください。

SERVIP

再同期またはアップグレードURLを解析した後、場合によってはDNSルックアップ後に取得された、ターゲットサーバーのIPアドレスをリクエストしてください。

PORT

再同期またはアップグレードURLを解析した後に取得した、ターゲットのUDP/TCPポートをリクエストしてください。

PATH

再同期またはアップグレードURLを解析した後に取得された、ターゲットファイルのパスをリクエストしてください。

ERR

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

UIDN

Line n userId設定パラメータの内容。

ISCUST

ユニットがカスタマイズされている場合はvalue=1、そうでない場合は0です。

カスタマイズのステータスは、Web UIの情報ページで見ることができます。

INCOMINGNAME初めて接続した通話、呼び出し中の通話、または着信時の名前。
REMOTENUMBER

最初に接続したときの電話番号、呼び出し中の電話番号、または着信時の電話番号。 複数の通話がある場合は、最初に見つかった通話に関連するデータが提供されます。

ディスプレイネームN行目の表示名設定パラメータの内容。
認証情報Line Nの認証ID設定パラメータの内容。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?