Utiliser Lookerbot pour Slack

Cette page explique comment utiliser Lookerbot, l'une des nombreuses intégrations proposées par Looker pour partager des données Looker dans Slack.

Lookerbot pour Slack s'intègre à Looker pour vous permettre d'interroger vos données directement depuis Slack. Vous pouvez ainsi partager facilement des données et répondre à des questions axées sur les données sans avoir à travailler en dehors du workflow existant de votre organisation.

Cette page présente les workflows Slack-Lookerbot suivants:

Premiers pas avec Lookerbot

Avant de pouvoir utiliser Lookerbot dans Slack, vous devez configurer l'application Lookerbot en suivant les instructions de configuration technique dans le dépôt GitHub Open Source de Looker.

En février 2021, Slack a abandonné certains points de terminaison d'API qui affectent la façon dont Lookerbot interagit avec les actions de données. Veuillez récupérer les dernières mises à jour du dépôt GitHub Lookerbot de Looker. Votre fichier package.json doit indiquer une version de Looker 0.0.16 ou ultérieure.

Développer automatiquement les URL Looker

Lookerbot peut développer automatiquement les URL du contenu Looker que vous partagez dans Slack. Pour permettre à Lookerbot d'étendre automatiquement les URL partagées dans un canal Slack, vous devez ajouter Lookerbot à ce canal Slack. (La configuration du robot doit également définir la variable d'environnement LOOKER_SLACKBOT_EXPAND_URLS sur true. Pour en savoir plus sur les variables d'environnement, consultez les instructions de configuration technique de Lookerbot.

La possibilité d'étendre les URL Looker n'est pas disponible dans les messages privés Slack, en raison de la distinction faite entre les canaux privés/publics et les messages privés dans les anciennes fonctionnalités d'ouverture de l'API utilisées dans Lookerbot.

Pour inviter Lookerbot à un canal public ou privé dans Slack:

  1. Cliquez sur le nom de la chaîne pour accéder à ses paramètres.
  2. Sélectionnez l'onglet Intégrations.
  3. Sous Applications, sélectionnez le nom de votre application Lookerbot.

Lorsque vous collez l'URL d'une exploration ou d'une présentation dans un canal Slack auquel Lookerbot a été invité, il développe automatiquement l'URL et son contenu. Si le contenu Looker est associé à une visualisation, Lookerbot affiche une image de cette visualisation. Si le contenu Looker est une table de données, Lookerbot affiche les données sous forme de texte.

Utiliser des commandes barre oblique personnalisées pour exécuter et publier des requêtes Looker

Vous pouvez également créer et utiliser des commandes barre oblique personnalisées qui, lorsqu'elles sont exécutées, exécutent une requête enregistrée de vos données dans Looker et publient le résultat dans Slack. Les commandes Slash personnalisées sont créées lors de la configuration de Lookerbot, mais peuvent être exécutées dans Slack par n'importe quel utilisateur Slack.

Les commandes à barre oblique ne sont pas nécessaires pour interagir avec Lookerbot. Pour utiliser toutes les fonctions de Lookerbot, vous pouvez également envoyer un message directement au bot ou le mentionner dans un canal Slack dans lequel il est présent: @lookerbot help.

Si l'intégration Slack est activée pour votre espace de travail Slack, vous ne pouvez pas utiliser les commandes barre oblique /looker avec Lookerbot. Au lieu de @looker ou /looker, utilisez @lookerbot ou /lookerbot.

Pour afficher les commandes créées pour votre Lookerbot:

  • Pointez sur toute mention du Lookerbot. Les commandes disponibles sont listées dans la fenêtre pop-up.
  • Sélectionnez l'application Lookerbot dans la section Applications de l'espace de travail Slack. Sélectionnez ensuite l'onglet À propos sur la page de l'application. Les commandes disponibles s'affichent sous Commandes.

Différentes façons d'utiliser les commandes à barre oblique

Il existe trois façons d'utiliser les commandes. Imaginons, par exemple, que vous ou un développeur de votre organisation ayez configuré une commande pour récupérer des données de Looker afin de suivre le nombre de commandes passées par les clients pour un certain produit. Le développeur a utilisé "orders" pour représenter ces données lors de la configuration de la commande à barre oblique. Pour appeler cette commande, vous pouvez:

  1. @mention Lookerbot, suivi du composant texte de la commande. Vous pouvez le faire dans n'importe quel canal dans lequel Lookerbot est présent. Exemple :

    @lookerbot orders

  2. Utilisez la commande slash. Pour utiliser une commande, cliquez dessus dans la liste des commandes ou saisissez son nom (précédé d'une barre oblique). Vous pouvez le faire si la commande slash a été configurée lors de la configuration.

    /lookerbot orders

  3. Envoyez un message privé au Lookerbot. Si vous envoyez un message directement à Lookerbot, vous n'avez pas besoin de placer /lookerbot au début de la commande. Dans ce cas, le message privé est simplement orders.

Utiliser des commandes à barre oblique avec des filtres

Si vous ou un développeur de votre organisation avez créé une commande slash qui interroge un tableau de bord avec un seul élément et des filtres de tableau de bord, vous pouvez exécuter la commande pour récupérer ce contenu Looker et ajouter des valeurs de filtre à partir de Slack. Les filtres sont facultatifs. Si aucune valeur n'est spécifiée, la requête s'exécute sans ce filtre.

Par exemple, imaginons que vous disposiez d'un tableau de bord avec une visualisation cartographique des clients qui filtre sur des villes américaines spécifiques et qu'une commande slash personnalisée a été configurée pour appeler les données de ce tableau de bord. Vous pouvez exécuter la commande customer map in, filtrée pour New York, comme suit:

Réponse du Slackbot à une visualisation de données représentant une carte de New York avec des points de différentes tailles représentant le nombre d'utilisateurs dans une zone donnée.

Formats de données

Les commandes renvoient des données de différentes manières selon le type de visualisation de l'élément d'exploration, de vue ou de tableau de bord sous-jacent. Trois formats de retour sont possibles:

  • Texte: si le contenu sous-jacent est un tableau, les données sont renvoyées sous forme de texte. Par exemple, si un utilisateur exécute la commande top customer this month configurée, Slackbot renvoie le premier enregistrement au format texte:

    La réponse du bot Slack à la commande "meilleur client ce mois-ci" renvoie un lien vers la requête Looker et les valeurs pour "Nom de l'utilisateur", "Âge de l'utilisateur", "État de l'utilisateur" et "Nombre de commandes".
  • Visualisation de valeur unique: si le contenu sous-jacent est une visualisation de valeur unique, les données sont renvoyées sous forme de valeur textuelle. Par exemple, si un utilisateur exécute la commande orders last week configurée, Slackbot renvoie le nombre total pour la semaine précédente:

    Réponse de Slackbot à la commande "commandes de la semaine dernière", qui renvoie un lien vers la requête Looker et indique que le nombre total de commandes est de 228.
  • Visualisation: si le contenu sous-jacent est une visualisation, les données sont renvoyées sous forme d'image de la visualisation. Par exemple, si un utilisateur exécute la commande movie budgets configurée avec la valeur Brad Pitt, Slackbot répond avec un lien vers la requête Looker et une visualisation de graphique linéaire qui représente les tendances à la hausse et à la baisse du budget moyen des films de Brad Pitt, de 0 à 160 millions de dollars pour la première année de sortie d'un film, entre 1990 et 2015:

Autres ressources

Pour en savoir plus sur les autres intégrations de Looker à Slack, consultez les ressources suivantes: