概要

Control Hub では、複数の配信チャネルを通じて Webex 展開全体のさまざまなイベントに関するアラートを作成、管理、受信するためのアラート センターを用意しています。現在アラート センターでサポートされている配信チャネルは、メール、Webex アプリ スペース、および Control Hub です。

今回、Webhook がその他の配信チャネルとして追加されました。Webhook を利用することで、管理者は、異なるコラボレーション アプリ、IT サービス管理 (ITSM) ツール内のチケット システム、カスタム ダッシュボード、または、その他 Webhook をサポートするアプリケーションで生成されたアラートを使用できるようになります。

管理者は Control Hub 内で Webhook コールバック URL を指定できます。コールバック URL を指定すると、新規または既存のアラートに対するルール内で、Webhook オプションを追加配信チャネルとして選択できます。Webhook を設定する手順については、以下を参照してください。

アラート Webhook の JSON 要素は、次の例のようになります。

{

"orgId": "1ab23cde-4567-890f-1234-gh56ijk07l891",

"title": "title",

"summary" : "テストアラートの通知",

"actionUrl": "www.actionURL.com",

"severity": "high",

"eventType": "created",

"resourceType": "ControlHubAlerts",

"type": "ミーティング",

"subtype": "ライブ ミーティングの監視",

}

Webhook コールバック URL を設定する

Webhook を使用するためのルールを有効にするには、まず Webhook コールバック URL を追加する必要があります。

1

Control Hub にサインインし、[組織設定] に移動します。

2

[Webhook 構成] セクションまでスクロールします。

3

[Webhook URL の設定] スイッチをオンに切り替えます。ポップアップ ウィンドウが表示されます。

4

使用する Webhook の URL を入力します。

Webhook の秘密トークンを追加することもできます。このブログを参照 して、秘密トークンの詳細を確認してください。

アラートのWebhook コールバック URL オプション
5

[検証] を選択します。検証に失敗した場合は、Webhook の URL と秘密トークンが正しいことを確認します。確認が完了したら、[再試行] をクリックします。

6

[保存] を選択します。

ルールで Webhook を有効にする

Webhook URL の設定後、Webhook を配信チャネルとして使用するためのルールを設定できます。

1

https://admin.webex.com の顧客ビューから [アラート センター] に移動し、[管理] をクリックします。

2

[すべてのルール] タブでルールを選択します。

3

[配信メソッド] セクションで [Webhook] チェックボックスをオンにします。

4

[保存] をクリックします。

Webex Meetings Webhook フィールドリファレンス

アラート コンテンツは、アラートの受信方法によって異なります。この記事の表では、各アラートの内容について説明します。

アラートのターゲットとなるデバイス

フィールド名データ タイプ例
CONFERENCE_IDロング111222333444555666
デバイス_URLHTTP URL ペア
  • https://csdm-a.wbx2.com/csdm/api/v1/organization/12ab345c-a800-4c83-96b1-5c3d72bcecdf/devices/a123b456-f0dc-56fb-a7c1-a368ebc37f17
  • https:///wdm-a.wbx2.com/wdm/api/v1/devices/1234c841
エラー_の理由文字列しきい値以上_の_両方
リンクhttp URLhttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
組織_名文字列組織例
リファレンス_ID文字列SGDAC_05-ミーティング ポッド 19
participant_deviceURLHTTP URL ペア
  • https://csdm-a.wbx2.com/csdm/api/v1/organization/12ab345c-a800-4c83-96b1-5c3d72bcecdf/devices/a123b456-f0dc-56fb-a7c1-a368ebc37f17
  • https:///wdm-a.wbx2.com/wdm/api/v1/devices/1234c841
report_audioMainReport_rxE2eLostPercent__thresholdパーセント8%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_transport タイプ文字列UDP
report_intervalMetadata_server 地域文字列United States
report_audioMainReport_rxE2eLostPercentパーセント16%

アラートのターゲットとしてのユーザー

フィールドデータ タイプ例
CONFERENCE_IDロング111222333444555666
エラー_の理由文字列しきい値を超える合計_時間_分_
リンクhttp URLhttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
組織_名文字列組織例
participant_email_hash (内部専用フィールド)文字列e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
reference_id_hash (内部専用フィールド)文字列e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
report_audioMainReport_rxE2eLostPercentパーセント7%
report_audioMainReport_rxE2eLostPercent__thresholdパーセント5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_transport タイプ文字列UDP
report_intervalMetadata_server 地域文字列United States

アラートに対してすべての参加者を監視するターゲットとしてのユーザー

フィールドデータ タイプ例
CONERFERENCE_IDロング111222333444555666
エラー_の理由文字列しきい値を超える合計_時間_分_
リンクhttp URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
組織_名文字列組織例
report_audioMainReport_meanラウンドトリップ時間ISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainR eport_meanRoundTripTime__threshold整数800
report_audioMainReport_meanラウンドトリップTime__timestamp1_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__timestamp2_utcISO タイムスタンプ2024 年 6 月 18 日火曜日 08:07:50 UTC
report_audioMainReport_transport タイプ文字列UDP
report_intervalMetadata_server 地域文字列United States

過去のミーティング品質監視アラート

フィールドデータ タイプ例
アラート _IDUUID47c89fe6-2944-4552-9576-02c571a9555e
終了_日日付2024-07-16
エラー_の理由文字列しきい値を_超える_コール
エラー_値パーセント10.9%
リンクhttp URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
組織_名文字列組織例
サイト_名文字列example.webex.com
開始_日日付2024-06-16

ミーティングの品質履歴の傾向

フィールドデータ タイプ例
アラート _IDUUID47c89fe6-2944-4552-9576-02c571a9555e
終了_日日付2024-07-16
エラー_の理由文字列しきい値を_超える_コール
エラー_値パーセント10.9%
リンクhttp URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
しきい値の__通話数_整数10
組織_名文字列組織例
過去_日間_のパケット損失_分_番号5
パケット損失_過去__日_ペットパーセント20%
過去_週_のパケット損失_分_番号5
過去_週_のパケット損失_PCT_パーセント20%
サイト_名文字列example.webex.com
開始_日日付2024-06-16
しきい値_パーセンテージパーセント15%

Cisco デバイス Webhook フィールドのリファレンス

Cisco デバイスの Webhook フィールドの参照については、この記事を参照してください。