Panoramica

Control Hub offre un centro avvisi che consente di creare, gestire e ricevere avvisi su diversi eventi nella distribuzione Webex attraverso diversi canali di consegna. I canali di consegna attualmente supportati da Alert Center sono e-mail, spazi app Webex e in Control Hub.

Ora, i webhook vengono aggiunti come un altro canale di consegna. I webhook consentono agli amministratori di consumare avvisi generati in diverse app di collaborazione, sistemi di ticket in strumenti di gestione dei servizi IT (ITSM), dashboard personalizzati o qualsiasi altra applicazione che supporti i webhook.

L'amministratore può specificare un URL di richiamata webhook in Control Hub. Dopo aver fornito un URL di richiamata, è possibile selezionare l'opzione webhook come canale di consegna aggiuntivo nelle regole per gli avvisi nuovi o esistenti. Vedere di seguito per la procedura di configurazione dei webhook.

Di seguito è riportato un esempio dell'aspetto dell'elemento JSON per un webhook di avviso:

{

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

"title": "title",

"riepilogo" : "notifica per un avviso di test",

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

"gravità" : "ALTA",

"TipoEvento" : "creato",

"resourceType": "ControlHubAlerts",

"tipo": "Riunione",

"sottotipo": "Monitoraggio riunione in diretta",

}

Imposta un URL di richiamata webhook

Devi prima aggiungere un URL di richiamata webhook prima di abilitare le regole per l'uso delle webhook.

1

Accedi a Control Hub e vai a Impostazioni organizzazione.

2

Scorrere fino alla sezione Configurazione webhook .

3

Attiva lo switch Configura URL webhook . Viene visualizzata una finestra popup.

4

Inserisci l'URL webhook che desideri utilizzare.

Puoi anche scegliere di aggiungere un token segreto per il webhook. Visualizza questo blog per ulteriori informazioni sui token segreti.

Un'opzione di avviso per URL di richiamare webhook
5

Selezionare Convalida. Se la convalida non riesce, controlla che l'URL webhook e il token segreto siano corretti. Fai clic su Riprova al termine del controllo.

6

Selezionare Salva.

Abilita webhook in una regola

Una volta impostato un URL webhook, è possibile impostare le regole per l'uso dei webhook come canale di consegna.

1

Dalla vista del cliente in https://admin.webex.com, andare al centro avvisie fare clic su Gestisci.

2

Nella scheda Tutte le regole, selezionare una regola.

3

Nella sezione Metodo di consegna , selezionare la casella di controllo Webhook .

4

Fai clic su Salva.

Riferimento campo webhook Webex Meetings

Il contenuto dell'avviso dipende da come si è scelto di ricevere gli avvisi. Nelle tabelle di questo articolo, vengono descritti i contenuti in ogni avviso.

Dispositivo come destinazione per l'avviso

Nome campoTipo di datiEsempio
_ID CONFERENZALungo111222333444555666
URL DISPOSITIVO_Associazione 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_ERROREstringaENTRAMBI_SOPRA_LA SOGLIA
COLLEGAMENTOURL httphttps://admin.webex.com/diagnostic/loadingDetail/123456789012345678
NOME_ORGANIZZAZIONEstringaOrganizzazione di esempio
ID_RIFERIMENTOstringaSGDAC_05-Pod riunione 19
participant_deviceURLAssociazione 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__thresholdPercentuale8%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
Tipo report_audioMainReport_transportstringaUDP
Regione report_intervalmetadata_serverstringaStati Uniti
report_audioMainReport_rxE2eLostPercentPercentuale16%

Utente come destinazione per l'avviso

CampoTipo di datiEsempio
_ID CONFERENZALungo111222333444555666
MOTIVO_ERROREstringaTOTALE_MINUTI_OLTRE_LA SOGLIA
COLLEGAMENTOURL httphttps://admin.webex.com/diagnostic/loadingDetail/123456785259637816
NOME_ORGANIZZAZIONEstringaOrganizzazione di esempio
participant_email_hash (campo solo interno)stringae400357589e00fae729b089aede2a06e1c bb200b6028d8cdb8eaef811ed59
reference_id_hash (campo solo interno)stringae400357589e00fae729b089aede2a06e1c bb200b6028d8cdb8eaef811ed59
report_audioMainReport_rxE2eLostPercentPercentuale7%
report_audioMainReport_rxE2eLostPercent__thresholdPercentuale5%
report_audioMainReport_rxE2eLostPercent__timestamp1_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
report_audioMainReport_rxE2eLostPercent__timestamp2_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
Tipo report_audioMainReport_transportstringaUDP
Regione report_intervalmetadata_serverstringaStati Uniti

Utente come destinazione con il monitoraggio di tutti i partecipanti abilitato per l'avviso

CampoTipo di datiEsempio
ID_CONNESSIONELungo111222333444555666
MOTIVO_ERROREstringaTOTALE_MINUTI_OLTRE_LA SOGLIA
COLLEGAMENTOURL httphttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOME_ORGANIZZAZIONEstringaOrganizzazione di esempio
Tempo report_audiodieport_meanround tripIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
report_audioR principaleeport_meanViaggio di andata e ritornoime__thresholdIntero800
report_audioReport_meanAndata e ritornoTime__timestamp1_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
report_audioReport_meanViaggio di andata e ritornoTime__timestamp2_utcIndicazione di data e ora ISOMar, 18 giu 2024 08:07:50 UTC
Tipo report_audioMainReport_transportstringaUDP
Regione report_intervalmetadata_serverstringaStati Uniti

Avviso di monitoraggio qualità riunione cronologico

CampoTipo di datiEsempio
ID_AVVISOUUID47c89fe6-2944-4552-9576-02c571a9555e
DATA_DI FINEData2024-07-16
MOTIVO_ERROREstringaCHIAMATE_OLTRE_LA SOGLIA
VALORE_ERROREPercentuale10.9%
COLLEGAMENTOURL httphttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
NOME_ORGANIZZAZIONEstringaOrganizzazione di esempio
NOME_SITOstringaexample.webex.com
DATA_DI INIZIOData2024-06-16

Tendenza di qualità delle riunioni storiche

CampoTipo di datiEsempio
ID_AVVISOUUID47c89fe6-2944-4552-9576-02c571a9555e
DATA_DI FINEData2024-07-16
MOTIVO_ERROREstringaCHIAMATE_OLTRE_LA SOGLIA
VALORE_ERROREPercentuale10.9%
COLLEGAMENTOURL httphttps://admin.webex.com/diagnostic/loadingDetail/296152875259637816
SOGLIA NESSUNA_DI_CHIAMATE_Intero10
NOME_ORGANIZZAZIONEstringaOrganizzazione di esempio
PERDITA DI PACCHETTI_LAST__DAY_MINSNumero5
ANIMALE DOMESTICO_PERDITA DI PACCHETTI_ULTIMO_GIORNO_Percentuale20%
MINUTI_PERDITA DI PACCHETTI_ULTIMA_SETTIMANA_Numero5
PERDITA DI PACCHETTI_ULTIMA__SETTIMANA_PCTPercentuale20%
NOME_SITOstringaexample.webex.com
DATA_DI INIZIOData2024-06-16
PERCENTUALE SOGLIA_Percentuale15%

Riferimento campo webhook dispositivi Cisco

Per informazioni sui riferimenti dei campi di webhook per i dispositivi Cisco, vedi questo articolo.