概要

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",

"重大度" : "高",

"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-ミーティングPod 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_audio主な使用条件eport_rxE2eLostPercent__threshold割引率 (パーセント)8%
report_audio主な製品eport_rxE2eLostPercent__timestamp1_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audio主な製品eport_rxE2eLostPercent__timestamp2_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportタイプ文字列UDP
report_intervalMetadata_serverリージョン文字列米国
report_audio主な製品eport_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_audio主な製品eport_rxE2eLostPercent割引率 (パーセント)7%
report_audio主な使用条件eport_rxE2eLostPercent__threshold割引率 (パーセント)5%
report_audio主な製品eport_rxE2eLostPercent__timestamp1_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audio主な製品eport_rxE2eLostPercent__timestamp2_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportタイプ文字列UDP
report_intervalMetadata_serverリージョン文字列米国

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

フィールドデータ タイプこの例を参考にしてください。
CONERFERENCE_IDロング111222333444555666
エラー_理由文字列しきい値の合計_分__
リンクHTTP URL（http URL）https://admin.webex.com/diagnostic/loadingDetail/296152875259637816
組織_名文字列組織の例
report_audio主要なeport_mean往復時間ISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_meanラウンドトリップime__threshold整数800
report_audioMainReport_meanラウンドトリップime__timestamp1_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_meanラウンドトリップime__timestamp2_utcISOタイムスタンプ火曜日, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportタイプ文字列UDP
report_intervalMetadata_serverリージョン文字列米国

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

フィールドデータ タイプこの例を参考にしてください。
アラート_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
パケット_損失_LAST _WEEK_PCT割引率 (パーセント)20%
サイト_名文字列example.webex.com
開始_日日付2024-06-16
しきい値_パーセント割引率 (パーセント)15%

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

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