Partager via

Configurer les notifications Slack

Les tableaux de bord IA/BI prennent en charge l'envoi de captures programmées aux canaux Slack. Cela permet aux équipes de recevoir des mises à jour de tableau de bord directement dans leur espace de travail Slack. Cette page explique comment créer une application Slack et configurer un canal Slack 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 Slack en tant qu’abonné, consultez Abonnement à un canal Slack ou Microsoft Teams.

Les abonnements Slack 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

Exemple de notification Slack montrant un instantané de tableau de bord

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 installer des applications dans votre espace de travail Slack.

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

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

Étape 1 : Créer et configurer une application Slack

Créez une application Slack pour votre espace de travail et configurez les autorisations nécessaires.

Créer l’application Slack

  1. Accédez à Vos applications dans la documentation de l’API Slack. Vous pouvez être invité à vous connecter à votre espace de travail Slack.
  2. Cliquez sur Créer une application.
  3. Cliquez sur À partir d'un manifeste ou À partir de zéro, en fonction de si vous disposez d’un fichier manifeste pour ajouter les informations de base de votre application ou si vous souhaitez le créer à l’aide de l’UI de configuration de Slack. Consultez la documentation de Slack sur la configuration d’applications avec des manifestes d’application pour obtenir des instructions sur la création à partir d’un manifeste.

Une fois l’application créée, la page paramètres de l’application Slack s’ouvre automatiquement.

Ajouter des étendues OAuth requises

  1. Dans la barre latérale, sous Fonctionnalités, cliquez sur OAuth et Autorisations.
  2. Faites défiler jusqu’aux périmètres.
  3. Sous Étendues de jeton de bot, cliquez sur Ajouter une étendue OAuth.
  4. Ajoutez les étendues suivantes :
    • incoming-webhook
    • files:write
    • files:read
    • chat:write

Installer l’application dans votre espace de travail

  1. Dans la barre latérale des paramètres de l’application Slack, sous Paramètres, cliquez sur Installer l’application.
  2. Cliquez sur Installer ou demander l’installation.
  3. Sélectionnez un canal de destination dans votre espace de travail.
  4. Cliquez sur Autoriser pour terminer l’installation.

Vérifiez que l’application a été ajoutée à votre canal de destination

  1. Dans votre espace de travail Slack, ouvrez le canal de destination. Cliquez sur le nom du canal en haut de la fenêtre.

  2. Cliquez sur l’onglet Intégrations .

    Détails du canal dans un espace de travail Slack.

  3. Sous Applications, vérifiez que vous voyez le bot que vous venez de créer. Si vous ne le voyez pas, cliquez sur Ajouter des applications et ajoutez-le.

Récupérer les informations d'identification

Vous avez besoin des informations suivantes de l’application Slack pour configurer la destination de notification Azure Databricks :

  1. Jeton OAuth de l’utilisateur de bot :
    • Accédez à OAuth & Autorisations dans les paramètres de l’application Slack.
    • Copiez le jeton OAuth de l’utilisateur bot.
  2. URL du webhook :
    • Accédez aux webhooks entrants dans les paramètres de l’application Slack.
    • Copiez l’URL du Webhook pour votre canal de destination.

Obtenir l’ID de canal Slack

  1. Dans votre espace de travail Slack, accédez au canal de destination.
  2. Cliquez sur le nom du canal pour ouvrir les détails du canal.
  3. Copiez l’ID de canal à partir des détails du canal.

É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 Slack.

  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 Slack dans la liste déroulante type de destination.
  8. Entrez les informations suivantes :
    • Nom de destination : nom descriptif pour cette destination Slack
    • URL du webhook Slack : URL du webhook de votre application Slack
    • Jeton OAuth : Jeton OAuth de l’utilisateur bot à partir de votre application Slack
    • ID de canal Slack : ID de canal de votre espace de travail Slack
  9. Cliquez sur Créer.

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

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

Résolution des problèmes

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

Pièce jointe PDF manquante

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

  • Le jeton OAuth est correctement configuré dans la destination de notification
  • L’ID de canal correspond au canal de destination
  • L’application Slack a l’étendue requise files:write

Notification qui n’apparaît pas

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

  • Vérifiez que l’URL du webhook est correcte et correspond au canal de destination
  • Vérifier que l’application Slack est installée dans l’espace de travail
  • Vérifiez que le bot a été ajouté au canal de destination
  • Vérifiez que l'horaire est actif et qu’il n’est pas suspendu

Étapes suivantes

  • Last updated on