Огляд

Control Hub пропонує Центр сповіщень, який дозволяє створювати, керувати та отримувати сповіщення про різні події під час розгортання Webex через кілька каналів доставки. Канали доставки, які зараз підтримує Центр оповіщення, проходять через електронну пошту, простори webex app і в Control Hub.

Тепер веб-хуки додаються як ще один канал доставки. Webhooks дозволяє адміністраторам споживати згенеровані сповіщення в різних програмах для співпраці, системах продажу квитків в інструментах управління ІТ-послугами (ITSM), користувацьких інформаційних панелях або будь-яких інших програмах, які підтримують веб-хуки.

Адміністратор може вказати URL-адресу зворотного виклику веб-хука в Центрі керування. Після надання URL-адреси зворотного виклику ви можете вибрати опцію webhook як додатковий канал доставки в правилах для нових або існуючих оповіщень. Нижче наведено кроки щодо налаштування веб-хуків.

Ось приклад того, як виглядає елемент JSON для веб-хука оповіщення:

{

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

"title": "title",

"summary" : "notification for a test alert",

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

"severity" : "HIGH",

"eventType" : "created",

"resourceType": "ControlHubAlerts",

"type": "Meeting",

"subtype": "Live Meeting Monitoring",

}

Настроювання URL-адреси зворотного виклику веб-хука

Спочатку потрібно додати URL-адресу зворотного виклику веб-хука, перш ніж ви зможете ввімкнути правила для використання веб-хуоків.

1

У поданні клієнта в https://admin.webex.com, перейдіть до налаштуваньорганізації.

2

Прокрутіть до розділу Оповіщення .

3

У розділі URL-адресазворотного виклику Webhook додайте потрібну URL-адресу.

Ви також можете додати безпечний токен для веб-хука. View this blog to learn more about secure tokens.

Опція оповіщення для URL-адрес для зворотних викликів у webhook
4

Клацніть Зберегти.

Увімкнення веб-хука в правилі

Після налаштування URL-адреси веб-хука ви можете налаштувати правила для використання веб-хуків як каналу доставки.

1

У поданні клієнта перейдіть https://admin.webex.comдо центруоповіщень і натисніть Керувати .

2

На вкладці Усі правила виберіть правило.

3

У розділі Спосіб доставки встановіть прапорець Webhook .

4

Клацніть Зберегти.

Webex Meetings webhook field reference

The alert content depends on how you have chosen to receive the alerts. In the tables in this article, we cover the contents in each alert.

Device as a target for the alert

Field nameТип данихПриклад
ІДЕНТИФІКАТОР КОНФЕРЕНЦІЇ_Long111222333444555666
DEVICE_URLHTTP URL pair
  • 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
ERROR_REASONРядокBOTH_OVER_THRESHOLD
LINKHTTP URLhttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
ORGANIZATION_NAMEРядокExample Org
REFERENCE_IDРядокSGDAC_05-Meeting Pod 19
participant_deviceURLHTTP URL pair
  • 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 timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportTypeРядокUDP
report_intervalMetadata_serverRegionРядокСША
report_audioMainReport_rxE2eLostPercentВідсоток16%

User as a target for the alert

ПолеТип данихПриклад
ІДЕНТИФІКАТОР КОНФЕРЕНЦІЇ_Long111222333444555666
ERROR_REASONРядокTOTAL_MINUTES_OVER_THRESHOLD
LINKHTTP URLhttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
ORGANIZATION_NAMEРядокExample Org
participant_email_hash (internal-only field)Рядокe400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
reference_id_hash (internal-only field)Рядокe400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
report_audioMainReport_rxE2eLostPercentВідсоток7%
report_audioMainReport_rxE2eLostPercent__thresholdВідсоток5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportTypeРядокUDP
report_intervalMetadata_serverRegionРядокСША

User as a target with monitoring all participants enabled for the alert

ПолеТип данихПриклад
CONERFERENCE_IDLong111222333444555666
ERROR_REASONРядокTOTAL_MINUTES_OVER_THRESHOLD
LINKHTTP URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
ORGANIZATION_NAMEРядокExample Org
report_audioMainReport_meanRoundTripTimeISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__thresholdЦіле число800
report_audioMainReport_meanRoundTripTime__timestamp1_utcISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__timestamp2_utcISO timestampTue, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_transportTypeРядокUDP
report_intervalMetadata_serverRegionРядокСША

Historical meeting quality monitoring alert

ПолеТип данихПриклад
ALERT_IDUUID47c89fe6-2944-4552-9576-02c571a9555e
END_DATEДата2024-07-16
ERROR_REASONРядокCALLS_OVER_THRESHOLD
ERROR_VALUEВідсоток10.9%
LINKHTTP URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
ORGANIZATION_NAMEРядокExample Org
SITE_NAMEРядокexample.webex.com
START_DATEДата2024-06-16

Тенденція якості історичних зустрічей

ПолеТип данихПриклад
ALERT_IDUUID47c89fe6-2944-4552-9576-02c571a9555e
END_DATEДата2024-07-16
ERROR_REASONРядокCALLS_OVER_THRESHOLD
ERROR_VALUEВідсоток10.9%
LINKHTTP URLhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NO_OF_CALLS_THRESHOLDЦіле число10
ORGANIZATION_NAMEРядокExample Org
PACKET_LOSS_LAST_DAY_MINSНомер5
PACKET_LOSS_LAST_DAY_PETВідсоток20%
PACKET_LOSS_LAST_WEEK_MINSНомер5
PACKET_LOSS_LAST_WEEK_PCTВідсоток20%
SITE_NAMEРядокexample.webex.com
START_DATEДата2024-06-16
THRESHOLD_PERCENTAGEВідсоток15%

Cisco devices webhook field reference

For information on webhook field references for Cisco devices, see this article.