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 enregistrer des applications et accorder le consentement administrateur dans Microsoft Entra ID. Vous devez également être capable de créer une ressource Azure Bot dans Portail Azure, d’ajouter une application Teams et de créer des flux de travail Power Automate dans Microsoft Teams.

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

Enregistrez une application Microsoft Entra ID, créez un bot Azure associé à cette application, et ajoutez une application Teams pour le bot à votre chaîne.

Inscrivez une application Microsoft Entra ID

1. Accédez au Centre d'administration de Microsoft Entra.
2. Cliquez sur Applications > inscriptions d'applications > Nouvelle inscription.
3. Saisissez un nom pour l’application et cliquez sur Inscrire.
4. Dans la page Vue d’ensemble de l’application, copiez l’ID d’application (client). Vous avez besoin de cette valeur pour créer le bot Azure et configurer la destination de notification Azure Databricks.

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

1. Dans le centre d’administration centre d’administration Microsoft Entra, avec votre inscription à l’application sélectionnée, cliquez sur les permissions API dans la barre latérale de gauche.
2. Cliquez sur Ajouter une autorisation.
3. Dans les API Microsoft, cliquez sur Autorisations d’application Microsoft Graph>.
4. Ajoutez les autorisations suivantes :
   • Files.Read.All
   • Sites.ReadWrite.All
5. Cliquez sur Ajouter des autorisations.
6. 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 centre d’administration Microsoft Entra, avec votre inscription à l’application sélectionnée, cliquez sur Certificats & 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.

Créer un bot Azure pour l’application

Créez une ressource Azure Bot qui utilise l’application Microsoft Entra ID que vous avez enregistrée.

1. Allez sur le Portail Azure et cliquez sur Créer une ressource.
2. Cherchez Azure Bot, sélectionnez la carte Azure Bot, puis cliquez sur Créer.
3. Sous l’ID d’application Microsoft, sélectionnez Utiliser l’enregistrement existant de l’application et saisissez l’ID de l’application (client) de l’application que vous avez enregistrée.
4. Remplissez les champs restants requis, puis cliquez sur Réviser + créer > Créer.
5. Lorsque le déploiement est terminé, cliquez sur Aller à la ressource.

Connectez le bot à Microsoft Teams

Ajoutez le canal Microsoft Teams au bot, puis créez une application Teams pour le bot et ajoutez-la à votre chaîne. Pour la procédure complète, voir Connecter un bot à Microsoft Teams dans la documentation Azure Bot Service.

1. Dans la ressource Azure Bot, ouvrez les Paramètres > Channels et cliquez sur Microsoft Teams.
2. Acceptez les conditions d’utilisation. Dans l’onglet Messagerie , sélectionnez l’environnement cloud de votre bot, puis cliquez sur Appliquer.
3. Créez une application Teams pour le bot, emballez-le, puis téléchargez-le sur Microsoft Teams. Pour les instructions, voir Publier votre bot dans Teams.
4. Ajoutez l’application Teams au canal où vous souhaitez recevoir les notifications du tableau de bord.

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.

Créer un webhook entrant pour le canal

1. Suivez les étapes de Microsoft pour créer un webhook entrant avec Workflows for Microsoft Teams, en utilisant l’envoi d’alertes webhook vers un modèle de canal et en sélectionnant le canal de destination.
2. Copiez et enregistrez l’URL du webhook généré. 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 de l’application : L’ID de l’application (client) de votre enregistrement à l’application Microsoft Entra ID
   • 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’identifiant de l’application (client) est correctement configuré dans la destination des notifications
• 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 secret d’authentification utilise la valeur de clé secrète client de Microsoft Entra ID et non l’ID de secret
• Vérifiez que l’application Teams du bot a été ajoutée 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