Utilisation de Lookerbot pour Slack

Cette page présente l'utilisation de 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 afin que vous puissiez interroger vos données directement depuis Slack, ce qui vous permet de partager facilement des données et de répondre à des questions fondées sur les données sans avoir à travailler en dehors du workflow existant de votre organisation.

Cette page traite de ces flux de travail Slack-Lookerbot:

• Premiers pas avec Lookerbot
• Expansion automatique des URL de contenu Looker
• Utiliser des commandes à barre oblique personnalisées pour exécuter et publier des requêtes Looker

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 rendu obsolète 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 à partir du dépôt GitHub Lookerbot de Looker. Votre fichier package.json doit indiquer une version Looker 0.0.16 ou ultérieure.

Développement automatique des URL Looker

Lookerbot peut développer les URL automatiquement 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 à cette chaîne Slack. (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 des 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 d'une exploration ou d'une présentation dans une chaîne Slack à 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.

Utilisation de 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 aussi envoyer un message directement au bot ou le mentionner dans un canal Slack où 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 voir les commandes créées pour votre Lookerbot:

• Passez le curseur sur n'importe quelle mention du Lookerbot. Les commandes disponibles sont répertorié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 ayez configuré une commande pour récupérer auprès de Looker des données permettant de suivre le nombre de commandes passées par des clients pour un produit donné. 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. @mentionnez Lookerbot suivi du composant texte de la commande. Cette opération peut s'effectuer dans n'importe quel canal où Lookerbot est présent. Exemple :
   @lookerbot orders

2. Utilisez la commande à barre oblique. Pour utiliser une commande, cliquez sur la commande 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, il n'est pas nécessaire d'ajouter le préfixe /lookerbot à la commande. Dans ce cas, le MP est simplement orders.

Utilisation de 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 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 et la requête s'exécutera sans ce filtre si aucune valeur n'est spécifiée.

Imaginons, par exemple, que vous ayez un tableau de bord avec une visualisation cartographique des clients qui filtre sur des villes spécifiques des États-Unis et qu'une commande à barre oblique personnalisée a été configurée pour appeler les données du tableau de bord. Vous pouvez exécuter la commande customer map in en filtrant celle de New York, comme suit:

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 présentation 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 configurée top customer this month, Slackbot renvoie l'enregistrement supérieur au format texte:
  
• Visualisation d'une 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:
  
• 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 en courbes représentant les tendances de valeur croissantes et décroissantes du budget moyen d'un 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:

• Envoyer des données à partir de Looker avec l'action de pièce jointe Slack (jeton d'API)
• Envoyer des alertes à l'intégration des pièces jointes Slack (jeton d'API)
• Planification d'envois à l'intégration Slack
• Envoyer des alertes à l'intégration Slack