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

"title": "title",

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

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

"gravedad": "ALTA",

"eventType": "creado",

"resourceType": "ControlHubAlerts",

"type": "Reunión",

"subtipo": "Monitoreo de reuniones en vivo",

}

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. Vea 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 la alerta depende de cómo haya elegido recibir las alertas. En las tablas de este artículo, cubrimos el contenido de cada alerta.

Dispositivo como destino de la alerta

Nombre del campoTipo de datosEjemplo
ID DE_CONFERENCIALargo111222333444555666
URL_DEL DISPOSITIVOPar 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
MOTIVO_DEL ERRORCadenaAMBOS_POR ENCIMA DEL_UMBRAL
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
NOMBRE_DE LA ORGANIZACIÓNCadenaEjemplo de organización
ID_DE REFERENCIACadenaSGDAC_05-Pod 19 de reuniones
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_audioPrincipalReport_rxE2eLostPercent__thresholdPorcentaje8%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
Tipo report_audioPrincipaleport_transportCadenaUDP
Región de report_intervalMetadata_serverCadenaEstados Unidos
report_audioPrincipalReport_rxE2eLostPercentPorcentaje16%

El usuario como destino de la alerta

CampoTipo de datosEjemplo
ID DE_CONFERENCIALargo111222333444555666
MOTIVO_DEL ERRORCadenaTOTAL DE_MINUTOS_POR ENCIMA DEL_UMBRAL
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
NOMBRE_DE LA ORGANIZACIÓNCadenaEjemplo de organización
participant_email_hash (campo solo interno)Cadenae400357589e00fae729b089aede2a06e1c bb200b6028d8cdb8eaef811ed59
reference_id_hash (campo solo interno)Cadenae400357589e00fae729b089aede2a06e1c bb200b6028d8cdb8eaef811ed59
report_audioPrincipalReport_rxE2eLostPercentPorcentaje7%
report_audioPrincipalReport_rxE2eLostPercent__thresholdPorcentaje5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
Tipo report_audioPrincipaleport_transportCadenaUDP
Región de report_intervalMetadata_serverCadenaEstados Unidos

Usuario como destino con la supervisión de todos los participantes habilitada para la alerta

CampoTipo de datosEjemplo
ID_DE CONERFERENCIALargo111222333444555666
MOTIVO_DEL ERRORCadenaTOTAL DE_MINUTOS_POR ENCIMA DEL_UMBRAL
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOMBRE_DE LA ORGANIZACIÓNCadenaEjemplo de organización
Tiempo de ida y vuelta report_audioprincipaleport_meanMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
report_audioRecorridoeport_meande ida y vuelta principalime__thresholdEntero800
report_audioRecorridoeport_meande ida y vuelta principalime__timestamp1_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
report_audioRecorridoeport_meande ida y vuelta principalime__timestamp2_utcMarca de tiempo ISOMar, 18 Jun 2024 08:07:50 UTC
Tipo report_audioPrincipaleport_transportCadenaUDP
Región de report_intervalMetadata_serverCadenaEstados Unidos

Alerta histórica de monitoreo de calidad de la reunión

CampoTipo de datosEjemplo
ID_DE ALERTAUUID47c89fe6-2944-4552-9576-02c571a9555e
FECHA DE FINALIZACIÓN_Fecha2024-07-16
MOTIVO_DEL ERRORCadenaLLAMADAS_POR ENCIMA_DEL UMBRAL
VALOR DE_ERRORPorcentaje10.9%
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOMBRE_DE LA ORGANIZACIÓNCadenaEjemplo de organización
NOMBRE_DEL SITIOCadenaexample.webex.com
FECHA DE INICIO_Fecha2024-06-16

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

CampoTipo de datosEjemplo
ID_DE ALERTAUUID47c89fe6-2944-4552-9576-02c571a9555e
FECHA DE FINALIZACIÓN_Fecha2024-07-16
MOTIVO_DEL ERRORCadenaLLAMADAS_POR ENCIMA_DEL UMBRAL
VALOR DE_ERRORPorcentaje10.9%
ENLACEURL HTTPhttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
CANTIDAD DE UMBRAL_DE_LLAMADAS_Entero10
NOMBRE_DE LA ORGANIZACIÓNCadenaEjemplo de organización
PÉRDIDA_DE PAQUETES_ÚLTIMO_DÍA_MINUTOSNúmero5
PÉRDIDA DE PAQUETES_ÚLTIMO_DÍA__MASCOTAPorcentaje20%
PÉRDIDA_DE PAQUETES_ÚLTIMA_SEMANA_MINUTOSNúmero5
PÉRDIDA_DE PAQUETES_ÚLTIMA_SEMANA_PCTPorcentaje20%
NOMBRE_DEL SITIOCadenaexample.webex.com
FECHA DE INICIO_Fecha2024-06-16
PORCENTAJE_UMBRALPorcentaje15%

Referencia del campo webhook de los dispositivos Cisco

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