Configurer des notifications Microsoft Teams

Les tableaux de bord IA/BI prennent en charge l’envoi de captures instantanées planifiées aux canaux Microsoft Teams. Cela permet aux équipes de recevoir des mises à jour de tableau de bord directement dans leur espace de travail Teams. Cette page explique comment créer une application Microsoft Teams et configurer un canal Teams comme destination de notification. Les éditeurs de tableau de bord peuvent ensuite ajouter cette destination de notification en tant qu’abonné aux tableaux de bord planifiés. Pour plus d’informations sur l’ajout d’un canal Teams en tant qu’abonné, consultez S’abonner à un canal Slack ou Microsoft Teams.

Les abonnements Teams fournissent des instantanés de tableau de bord qui incluent :

• Capture instantanée d’image PNG du tableau de bord visible directement dans le canal
• Lien direct pour ouvrir le tableau de bord dans Azure Databricks
• Pièce jointe d'aperçu PDF dans le fil de discussion

Spécifications

Vous devez disposer des autorisations suivantes :

• Vous devez être administrateur d’espace de travail Azure Databricks pour configurer les destinations de notification.
• Vous devez disposer des autorisations appropriées pour créer et configurer des applications dans Microsoft Copilot Studio et Microsoft Entra ID.

Pendant le processus d’installation, vous collectez les informations d’identification d’authentification de Microsoft pour configurer la destination de notification Azure Databricks.

Après avoir configuré la destination de notification, tout utilisateur disposant d’autorisations CAN EDIT sur un tableau de bord peut ajouter la destination Teams en tant qu’abonné aux planifications qu’il gère.

Étape 1 : Créer et configurer une application Microsoft Teams

Créez un bot Microsoft Copilot Studio pour votre espace de travail Teams et configurez les autorisations nécessaires.

Créer le bot Microsoft Copilot Studio

Effectuez les étapes suivantes à partir de la documentation de Microsoft Copilot Studio :

1. Installez l’application Copilot Studio dans Microsoft Teams.
2. Créez un chatbot dans une équipe.

Configurer les autorisations d’application dans l’ID Microsoft Entra

1. Accédez au Centre d'administration de Microsoft Entra.
2. Cliquez sur Inscriptions > d’applications.
3. Recherchez et sélectionnez l’inscription de l’application associée à votre bot Copilot Studio à l’aide de l’ID d’application de l’étape précédente.
4. Dans la barre latérale gauche, cliquez sur Autorisations d’API.
5. Cliquez sur Ajouter une autorisation.
6. Dans les API Microsoft, cliquez sur Autorisations d’application Microsoft Graph>.
7. Ajoutez les autorisations suivantes :
   • Files.Read.All
   • Sites.ReadWrite.All
8. Cliquez sur Ajouter des autorisations.
9. Cliquez sur Accorder le consentement de l’administrateur pour accorder les autorisations à votre organisation.

Créer un secret d’authentification

1. Dans le Centre d’administration Microsoft Entra, avec l’inscription de votre application sélectionnée, cliquez sur Certificats et secrets.
2. Cliquez sur Secrets client > Nouveau secret client.
3. Entrez une description et sélectionnez une période d’expiration.
4. Cliquez sur Ajouter.
5. Copiez la valeur du secret nouvellement créé. Cette valeur n’est affichée qu’une seule fois et vous en avez besoin pour configurer la destination de notification Azure Databricks.

Obtenir l’ID de locataire

1. Dans le Centre d’administration Microsoft Entra, avec l’inscription de votre application sélectionnée, accédez à Vue d’ensemble.
2. Copiez l’ID d’annuaire (locataire). Vous avez besoin de cette valeur pour configurer la destination de notification Azure Databricks.

Publier le bot et ajouter au canal Teams

Effectuez les étapes suivantes à partir de la documentation de Microsoft Copilot Studio :

1. Publiez votre chatbot.
2. Rendre votre chatbot disponible pour d’autres employés.

Créer un webhook entrant pour le canal

1. Dans la documentation de Microsoft Copilot Studio, suivez les étapes de création d’un webhook entrant.
2. Copiez et enregistrez l’URL du webhook généré.
3. Cliquez sur Done.

Obtenir l’URL du canal Teams

1. Dans Microsoft Teams, accédez au canal de destination.
2. Cliquez sur le menu hamburger ••• à côté du nom du canal.
3. Cliquez sur Copier le lien. Veillez à copier l’URL du canal et non l’URL Teams. Vous avez besoin de cette URL pour configurer la destination de notification Azure Databricks.

Étape 2 : Configurer la destination de notification dans Azure Databricks

Créez une destination de notification dans votre espace de travail Azure Databricks qui pointe vers votre canal Microsoft Teams.

1. Connectez-vous à votre espace de travail Azure Databricks.

2. Cliquez sur votre nom d’utilisateur dans le coin supérieur droit de l’espace de travail.

3. Sélectionnez Paramètres dans la liste déroulante.

4. Dans la section Administrateur de l’espace de travail, cliquez sur l’onglet Notifications.

5. Cliquez sur Gérer dans la section Destinations de notification .

6. Cliquez sur Ajouter une destination.

7. Sélectionnez Microsoft Teams dans la liste déroulante type de destination.

8. Entrez les informations suivantes :

   • Nom : Un nom descriptif pour cette destination de canal Microsoft Teams
   • URL du webhook de Microsoft Teams : L'URL du webhook provenant du webhook entrant de Teams
   • ID d’application : ID d’application de votre bot Microsoft Copilot Studio
   • Secret d’authentification : valeur du secret client de Microsoft Entra ID
   • URL du canal : URL du canal de Microsoft Teams
   • ID de locataire : ID d’annuaire (locataire) de Microsoft Entra ID

9. Cliquez sur Créer.

Les utilisateurs peuvent désormais ajouter cette destination de notification Teams en tant qu’abonné aux planifications de tableau de bord.

Pour obtenir des instructions sur l’abonnement des canaux Teams aux planifications de tableau de bord, consultez Abonnement à un canal Slack ou Microsoft Teams.

Résolution des problèmes

Utilisez ce qui suit pour résoudre les erreurs courantes avec les notifications Microsoft Teams.

Pièce jointe PDF manquante

Si la notification Teams s’affiche sans pièce jointe PDF, vérifiez que :

• L’ID d’application est correctement configuré dans la destination de notification
• Le secret d’authentification est valide et n’a pas expiré
• L'application a reçu les autorisations requises Files.Read.All et Sites.ReadWrite.All dans Microsoft Entra ID.
• Le consentement administrateur a été accordé pour les autorisations d’API

Notification qui n’apparaît pas

Si les notifications n’apparaissent pas dans votre canal Teams :

• Vérifiez que l’URL du webhook est correcte et correspond au canal de destination
• Vérifiez que le bot a été publié et ajouté au canal de destination
• Vérifiez que l’URL du canal est correcte
• Vérifier que l’ID de locataire correspond à votre organisation Microsoft
• Vérifiez que l'horaire est actif et qu’il n’est pas suspendu

Étapes suivantes

• Abonnez-vous des canaux Teams dans les planifications de tableau de bord. Voir S’abonner à un canal Slack ou Microsoft Teams
• Configurer les destinations de notification Slack. Voir Configurer les notifications Slack
• Configurez les destinations de notification par e-mail. Voir Gérer les destinations de notification