Aperçu

Control Hub offre un Centre d’alertes qui vous permet de créer, gérer et recevoir des alertes sur différents événements de votre déploiement de Webex via plusieurs canaux de diffusion. Les canaux de distribution actuellement pris en charge par Alert Center sont le courrier électronique, les espaces d’applications Webex et dans Control Hub.

Maintenant, les webhooks sont ajoutés en tant que canal de distribution. Les Webhooks permettent aux administrateurs de consommer les alertes générées dans différentes applications de collaboration, les systèmes de ticketing dans les outils de gestion des services informatiques (ITSM), les tableaux de bord personnalisés, ou toute autre application qui supporte les webhooks.

L’administrateur peut spécifier une URL de rappel du webhook dans Control Hub. Après avoir fourni une URL de rappel, vous pouvez sélectionner l’option webhook comme canal de distribution supplémentaire dans les règles pour les alertes nouvelles ou existantes. Voir ci-dessous pour les étapes sur la façon de configurer les webhooks.

Voici un exemple de ce à quoi ressemble l’élément JSON pour un webhook d’alerte :

{

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

"title" : "title",

"résumé" : "notification pour alerte test",

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

"gravité" : "ÉLEVÉE",

"eventType" : "created",

"resourceType" : "ControlHubAlerts",

"type" : "Réunion",

"sous-type" : "Surveillance des réunions en direct",

}

Configurer l’URL de rappel d’un webhook

Vous devez tout d’abord ajouter une URL de rappel webhook avant de pouvoir activer les règles pour utiliser les weboks.

1

À partir de l’affichage du client https://admin.webex.comdans , allez à Paramètres de l’organisation.

2

Faites défiler jusqu’à la section Alertes .

3

Sous URL de rappel Webhook, ajoutez l’URL que vous souhaitez utiliser.

Vous pouvez également choisir d’ajouter un jeton sécurisé pour le webhook. Consultez ce blog pour en savoir plus sur les jetons sécurisés.

Une option d’alerte pour les URL de rappeler un webhook
4

Cliquez sur Enregistrer.

Activer le webhook dans une règle

Après avoir installé l’URL d’un webhook, vous pouvez configurer des règles pour utiliser les webhooks comme chaine de distribution.

1

À partir de l’affichage du https://admin.webex.comclient dans , allez à Alertes center, puis cliquez sur Gérer.

2

Dans l’onglet Toutes les règles , sélectionnez une règle.

3

Dans la section Méthode de livraison, cochez la case Webhook .

4

Cliquez sur Enregistrer.

Référence du champ Webhook de Webex Meetings

Le contenu de l'alerte dépend de la manière dont vous avez choisi de recevoir les alertes. Dans les tableaux de cet article, nous couvrons le contenu de chaque alerte.

Périphérique comme cible de l’alerte

Nom du champType de donnéesExemple
ID_DE CONFÉRENCELongue111222333444555666
PÉRIPHÉRIQUE_URLPaire d'URL HTTP
  • 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
ERREUR_RAISONChaîne de caractèresÀ LA FOIS_AU-DELÀ_DU SEUIL
LIENURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
NOM DE L'ORGANISATION_Chaîne de caractèresExemple d’organisation
RÉFÉRENCE_IDChaîne de caractèresSGDAC_05-Meeting Pod 19
participant_deviceUrlPaire d'URL HTTP
  • 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__thresholdPour cent8%
report_audioMainReport_rxE2eLostPercent__timestamp1_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioPrincipalReport_transportTypeChaîne de caractèresUDP
report_intervalMetadata_serverRégionChaîne de caractèresÉtats-Unis
report_audioMainReport_rxE2eLostPercentPour cent16%

L’utilisateur comme cible de l’alerte

ChampType de donnéesExemple
ID_DE CONFÉRENCELongue111222333444555666
ERREUR_RAISONChaîne de caractèresTOTAL_MINUTES_DE DÉPASSEMENT_DU SEUIL
LIENURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
NOM DE L'ORGANISATION_Chaîne de caractèresExemple d’organisation
participant_email_hash (champ interne uniquement)Chaîne de caractèrese400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
reference_id_hash (champ interne uniquement)Chaîne de caractèrese400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
report_audioMainReport_rxE2eLostPercentPour cent7%
report_audioMainReport_rxE2eLostPercent__thresholdPour cent5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioPrincipalReport_transportTypeChaîne de caractèresUDP
report_intervalMetadata_serverRégionChaîne de caractèresÉtats-Unis

Utilisateur comme cible avec surveillance de tous les participants activée pour l'alerte

ChampType de donnéesExemple
CONERFERENCE_IDLongue111222333444555666
ERREUR_RAISONChaîne de caractèresTOTAL_MINUTES_DE DÉPASSEMENT_DU SEUIL
LIENURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOM DE L'ORGANISATION_Chaîne de caractèresExemple d’organisation
report_audioMainReport_meanDuréeAllerRetourhorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__thresholdEntier800
report_audioMainReport_meanRoundTripTime__timestamp1_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__timestamp2_utchorodatage ISOMar, 18 juin 2024 08:07:50 UTC
report_audioPrincipalReport_transportTypeChaîne de caractèresUDP
report_intervalMetadata_serverRégionChaîne de caractèresÉtats-Unis

Alerte historique de suivi de la qualité des réunions

ChampType de donnéesExemple
ID_D'ALERTEUUID47c89fe6-2944-4552-9576-02c571a9555e
DATE DE FIN_Date2024-07-16
ERREUR_RAISONChaîne de caractèresAPPELS_AU-DELÀ_DU SEUIL
VALEUR D'ERREUR_Pour cent10.9%
LIENURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOM DE L'ORGANISATION_Chaîne de caractèresExemple d’organisation
NOM DU SITE_Chaîne de caractèresexample.webex.com
DATE DE DÉBUT_Date2024-06-16

Tendance de la qualité de l’historique des réunions

ChampType de donnéesExemple
ID_D'ALERTEUUID47c89fe6-2944-4552-9576-02c571a9555e
DATE DE FIN_Date2024-07-16
ERREUR_RAISONChaîne de caractèresAPPELS_AU-DELÀ_DU SEUIL
VALEUR D'ERREUR_Pour cent10.9%
LIENURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
SEUIL DE NOMBRE_D'_APPELS_Entier10
NOM DE L'ORGANISATION_Chaîne de caractèresExemple d’organisation
PERTE DE PAQUETS__DERNIER_JOUR_MINNuméro5
PERTE_DE PAQUETS_DERNIER_JOUR_ANIMAL DOMESTIQUEPour cent20%
PERTE DE_PAQUETS_DE LA_SEMAINE_DERNIÈRENuméro5
PERTE DE PAQUETS__DERNIÈRE_SEMAINE_PCTPour cent20%
NOM DU SITE_Chaîne de caractèresexample.webex.com
DATE DE DÉBUT_Date2024-06-16
SEUIL_POURCENTAGEPour cent15%

Référence du champ Webhook des périphériques Cisco

Pour plus d'informations sur les références des champs webhook pour les périphériques Cisco, reportez-vous à cet article.