- Página inicial
- /
- Artigo
Habilitar webhooks para alertas no Control Hub
Neste artigoVocê pode configurar uma URL de retorno de chamada webhook para que os alertas mostrem-se em aplicativos de terceiros.
Visão geral
O Control Hub oferece um Centro de alertas que permite a você criar, gerenciar e receber alertas sobre vários eventos em sua implantação Webex através de vários canais de entrega. Os canais de entrega que o Alert Center suporta atualmente são por e-mail, espaços do aplicativo Webex e no Control Hub.
Agora, webhooks está sendo adicionado como outro canal de entrega. Os Webhooks permitem que os administradores consumem alertas gerados em diferentes aplicativos de colaboração, sistemas de ticket nas ferramentas de gerenciamento de serviço de INFORMAÇÃO (ITSM), painéis personalizados ou quaisquer outros aplicativos que suportam webhooks.
O administrador pode especificar uma URL de retorno de chamada webhook no Control Hub. Depois de fornecer uma URL de retorno de chamada, você pode selecionar a opção webhook como um canal de entrega adicional nas regras para alertas novos ou existentes. Veja abaixo as etapas sobre como configurar webhooks.
Aqui está um exemplo de como o elemento JSON para um webhook de alerta se parece:
{
"orgId": "1ab23cde-4567-890f-1234-gh ijk54l891",
"título": "título",
"resumo": "notificação para um alerta de teste",
"actionUrl": "www.actionURL.com",
"severidade": "ALTA",
"eventType": "criado",
"resourceType": "ControlHubAlerts",
"type": "Meeting",
"subtipo": "monitoramento de reunião ao vivo",
}
Configurar uma URL de retorno de chamada webhook
Você deve primeiro adicionar uma URL de retorno de chamada webhook antes de permitir que as regras usem webhoooks.
| 1 |
Na exibição do cliente em https://admin.webex.com, vá para Configurações da organização. |
| 2 |
Role até a seção de Alertas . |
| 3 |
Em URLde retorno de chamada do Webhook, adicione a URL que você deseja usar. Você também pode optar por adicionar um token seguro para o webhook. Visualize este blog para saber mais sobre tokens seguros.  |
| 4 |
Clique em Salvar. |
Habilitar webhook em uma regra
Depois de configurar uma URL de webhook, você pode configurar regras para usar webhooks como um canal de entrega.
| 1 |
Na exibição do cliente em https://admin.webex.com, vá para a Central de alertase clique em Gerenciar. |
| 2 |
Na guia Todas as regras , selecione uma regra. |
| 3 |
Na seção Método de entrega , marque a caixa de seleção Webhook .  |
| 4 |
Clique em Salvar. |
Referência do campo de webhook do Webex Meetings
O conteúdo de alerta depende de como você optou por receber os alertas. Nas tabelas deste artigo, cobrimos o conteúdo em cada alerta.
Dispositivo como destino para o alerta
| Nome do campo | Tipo de dados | Exemplo |
|---|---|---|
| _ID DA CONFERÊNCIA | Longo | 111222333444555666 |
| DISPOSITIVO _ URL | Emparelhamento de URL HTTP |
|
| MOTIVO DO ERRO _ | sequência | TANTO O LIMITE DE _ OVER _ |
| LINK | URL HTTP | https://admin.webex.com/diagnostic/loadingDetail/123456789012345678 |
| NOME DA _ ORGANIZAÇÃO | sequência | Exemplo de organização |
| REFERÊNCIA _ ID | sequência | SGDAC _ 05-Meeting Pod 19 |
| participant_deviceURL | Emparelhamento de URL HTTP |
|
| report_audio MainR eport_rx E2eLostP ercent__threshold | Porcento | 8% |
| report_audio MainR eport_rx E2eLostP ercent__timestamp 1 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_rx E2eLostP ercent__timestamp 2 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_transport Tipo | sequência | UDP |
| report_interval M etadata_server Região | sequência | Estados Unidos |
| report_audio MainR eport_rx E2eLostPercent | Porcento | 16% |
Usuário como alvo para o alerta
| Campo | Tipo de dados | Exemplo |
|---|---|---|
| _ID DA CONFERÊNCIA | Longo | 111222333444555666 |
| MOTIVO DO ERRO _ | sequência | TOTAL _ MINUTES _ OVER _ LIMITE |
| LINK | URL HTTP | https://admin.webex.com/diagnostic/loadingDetail/123456785259637816 |
| NOME DA _ ORGANIZAÇÃO | sequência | Exemplo de organização |
| participant_email_hash ( campo somente interno ) | sequência | e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef81159 |
| reference_id_hash ( campo somente interno ) | sequência | e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef81159 |
| report_audio MainR eport_rx E2eLostPercent | Porcento | 7% |
| report_audio MainR eport_rx E2eLostP ercent__threshold | Porcento | 5% |
| report_audio MainR eport_rx E2eLostP ercent__timestamp 1 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_rx E2eLostP ercent__timestamp 2 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_transport Tipo | sequência | UDP |
| report_interval M etadata_server Região | sequência | Estados Unidos |
Usuário como destino monitorando todos os participantes habilitados para o alerta
| Campo | Tipo de dados | Exemplo |
|---|---|---|
| CONERFERÊNCIA _ ID | Longo | 111222333444555666 |
| MOTIVO DO ERRO _ | sequência | TOTAL _ MINUTES _ OVER _ LIMITE |
| LINK | URL HTTP | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
| NOME DA _ ORGANIZAÇÃO | sequência | Exemplo de organização |
| report_audio MainR eport_mean RoundTripTime | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_mean RoundTripT ime__threshold | Inteiro | 800 |
| report_audio MainR eport_mean RoundTripT ime__timestamp 1 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_mean RoundTripT ime__timestamp 2 _utc | Carimbo de data/hora ISO | Ter, 18 de junho de 2024 08:07:50 UTC |
| report_audio MainR eport_transport Tipo | sequência | UDP |
| report_interval M etadata_server Região | sequência | Estados Unidos |
Alerta de monitoramento de qualidade da reunião histórica
| Campo | Tipo de dados | Exemplo |
|---|---|---|
| ALERTA _ ID | UUID | 47c89fe6-2944-4552-9576-02c571a9555e |
| DATA DE TÉRMINO _ | Data | 2024-07-16 |
| MOTIVO DO ERRO _ | sequência | CHAMADAS _ OVER _ LIMITE |
| VALOR DE ERRO _ | Porcento | 10.9% |
| LINK | URL HTTP | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
| NOME DA _ ORGANIZAÇÃO | sequência | Exemplo de organização |
| NOME DO SITE _ | sequência | example.webex.com |
| DATA DE INÍCIO _ | Data | 2024-06-16 |
Tendência da qualidade de reunião histórica
| Campo | Tipo de dados | Exemplo |
|---|---|---|
| ALERTA _ ID | UUID | 47c89fe6-2944-4552-9576-02c571a9555e |
| DATA DE TÉRMINO _ | Data | 2024-07-16 |
| MOTIVO DO ERRO _ | sequência | CHAMADAS _ OVER _ LIMITE |
| VALOR DE ERRO _ | Porcento | 10.9% |
| LINK | URL HTTP | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
| LIMITE DE _ DE _ CHAMADAS _ | Inteiro | 10 |
| NOME DA _ ORGANIZAÇÃO | sequência | Exemplo de organização |
| PACOTE _ LOSS _ LAST _ DAY _ MINS | Número | 5 |
| PACOTE _ LOSS _ LAST _ DAY _ PET | Porcento | 20% |
| PACOTE _ LOSS _ LAST _ WEEK _ MINS | Número | 5 |
| PACOTE _ LOSS _ LAST _ WEEK _ PCT | Porcento | 20% |
| NOME DO SITE _ | sequência | example.webex.com |
| DATA DE INÍCIO _ | Data | 2024-06-16 |
| PERCENTUAL DE LIMITE _ | Porcento | 15% |
Referência do campo de webhook de dispositivos Cisco
Para obter informações sobre as referências do campo de webhook para dispositivos Cisco, consulte este artigo .
