Configurare le notifiche di Microsoft Teams

I dashboard di intelligenza artificiale/BI supportano l'invio di snapshot pianificati ai canali di Microsoft Teams. Ciò consente ai team di ricevere gli aggiornamenti del dashboard direttamente nell'area di lavoro di Teams. Questa pagina illustra come creare un'app di Microsoft Teams e configurare un canale di Teams come destinazione di notifica. Gli editor di dashboard possono quindi aggiungere questa destinazione di notifica come sottoscrittore ai dashboard pianificati. Per informazioni sull'aggiunta di un canale di Teams come sottoscrittore, vedere Sottoscrivere un canale Slack o Microsoft Teams.

Le sottoscrizioni di Teams forniscono snapshot del dashboard che includono:

• Un'istantanea dell'immagine PNG del cruscotto visibile direttamente nel canale
• Collegamento diretto per aprire il dashboard in Azure Databricks
• Allegato di istantanea PDF nel thread del messaggio

Requisiti

È necessario disporre delle autorizzazioni seguenti:

• Per configurare le destinazioni di notifica, è necessario essere un amministratore dell'area di lavoro di Azure Databricks.
• Devi avere i permessi appropriati per registrare le app e concedere il consenso dell'amministratore in Microsoft Entra ID. Devi anche essere in grado di creare una risorsa Azure Bot nell'portale di Azure, aggiungere un'app Teams e creare flussi di lavoro Power Automate in Microsoft Teams.

Durante il processo di installazione, si raccolgono le credenziali di autenticazione da Microsoft per configurare la destinazione di notifica di Azure Databricks.

Dopo aver configurato la destinazione delle notifiche, qualsiasi utente con autorizzazioni CAN EDIT in un dashboard può aggiungere la destinazione di Teams come sottoscrittore nei programmi che gestiscono.

Passaggio 1: Creare e configurare un'app di Microsoft Teams

Registra un'app Microsoft Entra ID, crea un bot Azure associato a quell'app e aggiungi un'app Teams per il bot al tuo canale.

Registra un'app Microsoft Entra ID

1. Vai all'interfaccia di amministrazione di Microsoft Entra.
2. Clicca su Applicazioni > Registrazioni app > Nuova registrazione.
3. Inserisci un nome per l'app e clicca su Registra.
4. Nella pagina Panoramica dell'app, copia l'ID applicazione (client). Ti serve questo valore per creare l'Azure Bot e configurare la destinazione delle notifiche di Azure Databricks.

Configurare le autorizzazioni dell'app in Microsoft Entra ID

1. Nel Interfaccia di amministrazione di Microsoft Entra, con la registrazione dell'app selezionata, clicca su permessi API nella barra laterale sinistra.
2. Fare clic su Aggiungi un'autorizzazione.
3. Nelle API Microsoft fare clic su Autorizzazioni dell'applicazione Microsoft Graph>.
4. Aggiungere le autorizzazioni seguenti:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Fare clic su Aggiungi autorizzazioni.
6. Fare clic su Concedi consenso amministratore per concedere le autorizzazioni per l'organizzazione.

Creare un segreto di autenticazione

1. Nel centro Interfaccia di amministrazione di Microsoft Entra, con la registrazione dell'app selezionata, clicca su Certificati & segreti.
2. Fare clic su Segreti client > Nuovo segreto client.
3. Immettere una descrizione e selezionare un periodo di scadenza.
4. Fare clic su Aggiungi.
5. Copiare il valore del segreto appena creato. Questo valore viene visualizzato una sola volta ed è necessario configurare la destinazione di notifica di Azure Databricks.

Ottenere l'ID del tenant

1. Nell'interfaccia di amministrazione di Microsoft Entra, con la registrazione dell'app selezionata, passare a Panoramica.
2. Copiare l'ID (tenant) della directory. Questo valore è necessario per configurare la destinazione di notifica di Azure Databricks.

Crea un bot Azure per l'app

Crea una risorsa Azure Bot che utilizzi l'app Microsoft Entra ID che hai registrato.

1. Vai su portale di Azure e clicca su Crea una risorsa.
2. Cerca Azure Bot, seleziona la carta Azure Bot e clicca su Crea.
3. Sotto Microsoft App ID, seleziona Usa registrazione dell'app esistente e inserisci l'ID Application (client) dell'app che hai registrato.
4. Compila i campi rimanenti richiesti, poi clicca su Revisa + crea > Creato.
5. Quando il deployment è completato, clicca su Vai alla risorsa.

Collega il bot a Microsoft Teams

Aggiungi il canale Microsoft Teams al bot, poi crea un'app Teams per il bot e aggiungila al tuo canale. Per la procedura completa, vedi Collega un bot a Microsoft Teams nella documentazione Azure servizio Bot.

1. Nella risorsa Azure Bot, apri i Canali delle Impostazioni > e clicca su Microsoft Teams.
2. Accettare le condizioni per il servizio. Nella scheda Messaggistica, seleziona l'ambiente cloud per il tuo bot, poi clicca su Applica.
3. Crea un'app Teams per il bot, impacchettala, caricala su Microsoft Teams. Per le istruzioni, vedi Pubblica il tuo bot in Teams.
4. Aggiungi l'app Teams al canale dove vuoi ricevere le notifiche dalla dashboard.

Ottenere l'URL del canale di Teams

1. In Microsoft Teams passare al canale di destinazione.
2. Fare clic sul menu hamburger ••• accanto al nome del canale.
3. Fare clic su Copia collegamento. Assicurarsi di copiare l'URL del canale e non l'URL di Teams. Questo URL è necessario per configurare la destinazione di notifica di Azure Databricks.

Crea un webhook in ingresso per il canale

1. Segui i passaggi Microsoft per creare un webhook in arrivo con Workflows for Microsoft Teams, utilizzando Invia avvisi webhook a un modello di canale e selezionando il canale di destinazione.
2. Copiare e salvare l'URL del webhook generato. Questo URL è necessario per configurare la destinazione di notifica di Azure Databricks.

Passaggio 2: Configurare la destinazione di notifica in Azure Databricks

Creare una destinazione di notifica nell'area di lavoro di Azure Databricks che punta al canale di Microsoft Teams.

1. Accedere all'area di lavoro di Azure Databricks.

2. Fare clic sul nome utente nell'angolo in alto a destra dell'area di lavoro.

3. Selezionare Impostazioni nell'elenco a discesa.

4. Nella sezione Amministratore dell'area di lavoro fare clic sulla scheda Notifiche.

5. Fare clic su Gestisci nella sezione Destinazioni di notifica .

6. Fare clic su Aggiungi destinazione.

7. Selezionare Microsoft Teams dal tipo destinazione nel menu a discesa.

8. Immettere le informazioni seguenti:

   • Nome: nome descrittivo per la destinazione del canale Teams
   • URL del webhook di Microsoft Teams: L'URL del Webhook di ingresso di Teams
   • ID app:L'ID dell'applicazione (client) dalla registrazione dell'app Microsoft Entra ID
   • Segreto di autenticazione: valore del segreto client da Microsoft Entra ID
   • URL del canale: URL del canale da Microsoft Teams
   • ID tenant: ID del tenant della directory di Microsoft Entra

9. Clicca su Crea.

Gli utenti possono ora aggiungere questa destinazione di notifica di Teams come sottoscrittore alle pianificazioni del dashboard.

Per istruzioni sull'iscrizione dei canali di Microsoft Teams alle pianificazioni del dashboard, vedere Iscrivere un canale Slack o Microsoft Teams.

Risoluzione dei problemi

Usare quanto segue per risolvere gli errori comuni relativi alle notifiche di Microsoft Teams.

Allegato PDF mancante

Se la notifica di Teams viene visualizzata senza un allegato PDF, verificare che:

• L'ID dell'applicazione (client) è configurato correttamente nella destinazione delle notifiche
• Il segreto di autenticazione è valido e non è scaduto
• All'app sono state concesse le autorizzazioni necessarie Files.Read.All e Sites.ReadWrite.All in Microsoft Entra ID
• Il consenso dell'amministratore è stato concesso per le autorizzazioni API

Notifica non visualizzata

Se le notifiche non vengono visualizzate nel canale di Teams:

• Verificare che l'URL del webhook sia corretto e corrisponda al canale di destinazione
• Verificare che il segreto di autenticazione usi il valore del segreto client da Microsoft Entra ID e non l'ID segreto
• Controlla che l'app Teams per il bot sia stata aggiunta al canale di destinazione
• Verificare che l'URL del canale sia corretto
• Verificare che l'ID tenant corrisponda all'organizzazione Microsoft
• Verificare che la pianificazione sia attiva e non sospesa

Passaggi successivi

• Sottoscrivere i canali di Teams alle pianificazioni del dashboard. Consultare Sottoscrivere un canale Slack o Microsoft Teams
• Configurare le destinazioni di notifica di Slack. Vedere Configurare le notifiche di Slack
• Configurare le destinazioni di notifica tramite posta elettronica. Vedere Gestire le destinazioni di notifica