概要

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

https://admin.webex.com の顧客ビューから [組織の設定] に移動します。

2

[アラート] セクションまでスクロールします。

3

[Webhook コールバック URL] の下に使用する URL を追加します。

Webhook 用にセキュアなトークンを追加する選択もできます。安全なトークンの詳細については、このブログ を参照してください。

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

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

ルールで 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 URL（http URL）https://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タイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transport タイプ文字列UDP
report_intervalMetadata_server 地域文字列United States
report_audioMainReport_rxE2eLostPercentパーセント16%

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

フィールドデータ タイプ例
CONFERENCE_IDロング111222333444555666
エラー_の理由文字列しきい値を超える合計_時間_分_
リンクHTTP URL（http URL）https://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タイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transport タイプ文字列UDP
report_intervalMetadata_server 地域文字列United States

アラートが有効になっているすべての参加者を監視するターゲットとしてのユーザー

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

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

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

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

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

Cisco デバイス Webhook フィールドの参照

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