Utiliser Lookerbot pour Slack

Cette page présente l'utilisation de Lookerbot, l'une des nombreuses intégrations fournies par Looker pour partager des données Looker dans Slack.

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

Cette page décrit ces workflows Slack-Lookerbot:

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 manière dont Lookerbot interagit avec les actions sur les données. Veuillez extraire les dernières mises à jour du dépôt GitHub Lookerbot de Looker. Votre fichier package.json doit indiquer une version Looker 0.0.16 ou ultérieure.

Développer automatiquement les URL Looker

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

La possibilité d'étendre les URL Looker n'est pas disponible dans les messages privés Slack, en raison de la distinction entre les canaux privés/publics et les messages privés dans les anciennes fonctionnalités d'API de déploiement 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 Integrations (Intégrations).
  3. Sous Apps (Applications), sélectionnez le nom de votre application Lookerbot.

Lorsque vous collez l'URL à partir d'une exploration ou d'une présentation dans un canal Slack vers laquelle Lookerbot a été invité, Lookerbot 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, permettent d'exécuter une requête enregistrée de vos données dans Looker et de publier le résultat dans Slack. Les commandes à barre oblique personnalisées sont créées lors de la configuration de Lookerbot, mais peuvent être exécutées dans Slack par n'importe quel utilisateur de 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 au bot directement ou le mentionner dans un canal Slack dans lequel Lookerbot 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 le Lookerbot. À la place de @looker ou /looker, utilisez @lookerbot ou /lookerbot.

Pour afficher les commandes qui ont été créées pour votre Lookerbot:

  • Pointez sur n'importe quelle mention du Lookerbot. Les commandes disponibles sont listées dans la fenêtre pop-up.
  • Sélectionnez l'application Lookerbot dans la section Apps (Applications) de l'espace de travail Slack. Sélectionnez ensuite l'onglet À propos sur la page de l'application. Les commandes disponibles sont répertoriées sous Commands (Commandes).

Différentes manières d'utiliser les commandes à barre oblique

Il existe trois façons d'utiliser les commandes. Supposons, par exemple, que vous ou un développeur de votre entreprise ait configuré une commande pour récupérer dans Looker des données qui suivent le nombre de commandes passées par les clients d'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. Cela peut se faire dans n'importe quel canal où Lookerbot est présent. Exemple :

    @lookerbot orders

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

    /lookerbot orders

  3. Envoyer un message privé à Lookerbot Si vous envoyez un message directement à Lookerbot, vous n'avez pas besoin d'ajouter le préfixe /lookerbot à la commande. Dans ce cas, le MP est simplement orders.

Utiliser des commandes à barre oblique avec des filtres

Si vous ou un développeur de votre organisation avez créé une commande à barre oblique qui interroge un tableau de bord contenant un seul élément et des filtres de tableau de bord, vous pouvez l'exécuter 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 sera exécutée sans ce filtre.

Imaginons, par exemple, que vous disposiez d'un tableau de bord avec une visualisation de carte client qui filtre sur des villes spécifiques des États-Unis et qu'une commande à barre oblique personnalisée ait été configurée pour appeler ces données de tableau de bord. Vous pouvez exécuter la commande customer map in, filtrée pour New York, comme suit:

Réponse Slackbot d'une visualisation des données montrant 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 en fonction du type de visualisation de l'exploration, de la présentation ou de l'élément du tableau de bord sous-jacent. Il existe trois formats de retour 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 configurée top customer this month, Slackbot renvoie l'enregistrement de niveau le plus élevé au format texte:

    La réponse Slackbot au client principal ce mois-ci renvoie un lien vers la requête Looker et les valeurs associées à "Users Name" (Nom d'utilisateur), à "User Age", à "Users State" et à "Orders Count".
  • Visualisation à valeur unique: si le contenu sous-jacent est une visualisation à valeur unique, les données sont renvoyées sous forme de valeur textuelle. Par exemple, si un utilisateur exécute la commande configurée orders last week, Slackbot renvoie le nombre total de la semaine précédente:

    Réponse Slackbot à la commande des commandes de la semaine dernière renvoyant un lien vers la requête Looker et 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 configurée movie budgets avec la valeur Brad Pitt, Slackbot répond avec un lien vers la requête Looker et une visualisation de graphique linéaire qui illustre les tendances croissantes et décroissantes des valeurs du budget moyen du film de Brad Pitt de 0 à 160 millions pour la première année de sortie d'un film, 1990 à 2015:

Autres ressources

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