Descripción general

Control Hub ofrece un Centro de alertas que le permite crear, administrar y recibir alertas en diversos eventos en toda su implementación de Webex a través de varios canales de entrega. Los canales de entrega que admite actualmente el Centro de alertas se encuentran a través del correo electrónico, los espacios de la aplicación de Webex y en control Hub.

Ahora, se están agregando webhooks como otro canal de entrega. Las Webhooks permiten a los administradores consumir alertas generadas en diferentes aplicaciones de colaboración, sistemas de tickets en las herramientas de administración de servicios de TI (ITSM), escritorios personalizados o cualquier otra aplicación que admita webhooks.

El administrador puede especificar una URL de devolución de llamada de webhook en el Concentrador de control. Después de proporcionar una URL de devolución de llamada, puede seleccionar la opción de la Webhook como un canal de entrega adicional en las reglas para alertas nuevas o existentes. Consulte a continuación los pasos sobre cómo configurar webhooks.

A continuación, se muestra un ejemplo de cómo es el elemento JSON para una Webhook de alerta:

{

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

"título": "título",

"resumen" : "notificación para una alerta de prueba",

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

"gravedad" : "ALTO",

"eventType" : "creado",

"resourceType": "ControlHubAlerts",

"tipo": "Reunión",

"subtipo": "Supervisión de reuniones en directo",

}

Configurar una URL de devolución de llamada para una Webhook

Primero debe agregar una URL de devolución de llamada de webhook antes de habilitar las reglas para usar webhoooks.

1

Desde la vista del cliente en https://admin.webex.com, vaya a Configuración de la organización.

2

Desplácese hasta la sección Alertas.

3

En URL de devolución de llamada deWebhook, agregue la URL que desea utilizar.

También puede optar por agregar un token seguro para la Webhook. Consulte este blog para obtener más información sobre los tokens seguros.

Una opción de alertapara las URL de detrás de llamada de webhook
4

Haga clic en Guardar.

Habilitar webhook en una regla

Después de configurar una URL de webhook, puede configurar reglas para usar webhooks como canal de entrega.

1

Desde la vista del cliente en https://admin.webex.com, vaya al centro Alertasy haga clic en Administrar.

2

En la ficha Todas las reglas, seleccione una regla.

3

En la sección Método de entrega, marque la casilla de verificación Webhook .

4

Haga clic en Guardar.

Referencia del campo webhook de Webex Meetings

El contenido de las alertas depende de cómo hayas elegido recibirlas. En las tablas de este artículo, cubrimos el contenido de cada alerta.

Dispositivo como objetivo de la alerta

Nombre del campoTipo de datosEjemplo
ID DE_CONFERENCIAlargo111222333444555666
DISPOSITIVO_URLPar de 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
ERROR_RAZÓNcadenaAMBOS_POR ENCIMA DEL UMBRAL_
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
ORGANIZACIÓN_NOMBREcadenaEjemplo Org
REFERENCIA_IDcadenaSGDAC_05-Sala de reuniones 19
participant_deviceURLPar de 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__thresholdPorcentaje8%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_transportTipocadenaUDP
report_intervalMetadata_serverRegióncadenaEstados Unidos
report_audioMainReport_rxE2eLostPercentPorcentaje16%

Usuario como objetivo de la alerta

CampoTipo de datosEjemplo
ID DE_CONFERENCIAlargo111222333444555666
ERROR_RAZÓNcadenaTOTAL_MINUTOS_MÁS DE_UMBRAL
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
ORGANIZACIÓN_NOMBREcadenaEjemplo Org
participant_email_hash (campo sólo interno)cadenae400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
reference_id_hash (campo sólo interno)cadenae400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59
report_audioMainReport_rxE2eLostPercentPorcentaje7%
report_audioMainReport_rxE2eLostPercent__thresholdPorcentaje5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_transportTipocadenaUDP
report_intervalMetadata_serverRegióncadenaEstados Unidos

Usuario como objetivo con la supervisión de todos los participantes activada para la alerta

CampoTipo de datosEjemplo
CONFERENCIA_IDlargo111222333444555666
ERROR_RAZÓNcadenaTOTAL_MINUTOS_MÁS DE_UMBRAL
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
ORGANIZACIÓN_NOMBREcadenaEjemplo Org
report_audioPrincipalReport_meanRoundTripTimeSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioPrincipalReport_meanRoundTripTime__thresholdEntero800
report_audioMainReport_meanRoundTripTime__timestamp1_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_meanRoundTripTime__timestamp2_utcSello de tiempo ISOmar, 18 jun 2024 08:07:50 UTC
report_audioMainReport_transportTipocadenaUDP
report_intervalMetadata_serverRegióncadenaEstados Unidos

Alerta histórica de seguimiento de la calidad de las reuniones

CampoTipo de datosEjemplo
ALERTA_IDUUID47c89fe6-2944-4552-9576-02c571a9555e
FIN_FECHAFecha2024-07-16
ERROR_RAZÓNcadenaLLAMADAS_POR ENCIMA DEL UMBRAL_
ERROR_VALORPorcentaje10.9%
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
ORGANIZACIÓN_NOMBREcadenaEjemplo Org
SITIO_NOMBREcadenaexample.webex.com
INICIO_FECHAFecha2024-06-16

Tendencia histórica de la calidad de la reunión

CampoTipo de datosEjemplo
ALERTA_IDUUID47c89fe6-2944-4552-9576-02c571a9555e
FIN_FECHAFecha2024-07-16
ERROR_RAZÓNcadenaLLAMADAS_POR ENCIMA DEL UMBRAL_
ERROR_VALORPorcentaje10.9%
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NO_DE_LLAMA_UMBRALEntero10
ORGANIZACIÓN_NOMBREcadenaEjemplo Org
PAQUETE_PÉRDIDA_ÚLTIMO_DÍA_MINUTOSNúmero5
PAQUETE_PÉRDIDA_ÚLTIMO_DÍA_MASCOTAPorcentaje20%
PAQUETE_PÉRDIDA_ÚLTIMA_SEMANA_MINUTOSNúmero5
PAQUETE_PÉRDIDA_ÚLTIMA_SEMANA_PCTPorcentaje20%
SITIO_NOMBREcadenaexample.webex.com
INICIO_FECHAFecha2024-06-16
UMBRAL_PORCENTAJEPorcentaje15%

Referencia de campos webhook de dispositivos Cisco

Para obtener información sobre las referencias de campos webhook para dispositivos Cisco, consulte este artículo.