Usa Lookerbot para Slack

En esta página, se proporciona una descripción general de cómo usar Lookerbot, una de las varias integraciones que proporciona Looker para compartir sus datos en Slack.

Lookerbot para Slack se integra en Looker para que puedas consultar tus datos directamente desde Slack, lo que te permite compartir datos con facilidad y responder preguntas basadas en datos sin tener que trabajar fuera del flujo de trabajo existente de tu organización.

En esta página, se analizan los siguientes flujos de trabajo de Slack-Lookerbot:

Comienza a usar Lookerbot

Antes de que puedas usar Lookerbot en Slack, debes configurar su aplicación siguiendo las instrucciones de configuración técnica que se encuentran en el repositorio de GitHub de código abierto de Looker.

En febrero de 2021, Slack dio de baja algunos extremos de la API que afectan la forma en que Lookerbot interactúa con las acciones de datos. Obtén las actualizaciones más recientes del repositorio de GitHub de Looker. Tu archivo package.json debe indicar una versión de Looker de 0.0.16 o una posterior.

Expande las URLs de Looker automáticamente

Lookerbot puede expandir automáticamente las URLs para el contenido de Looker que compartes en Slack. Para permitir que Lookerbot expanda automáticamente las URLs compartidas dentro de un canal de Slack, debes agregar Lookerbot a ese canal. (La configuración del bot también debe establecer la variable de entorno LOOKER_SLACKBOT_EXPAND_URLS en true. Consulta las instrucciones de configuración técnica de Looker para obtener más información sobre las variables de entorno).

La capacidad de expandir las URLs de Looker no está disponible en los mensajes directos de Slack debido a la distinción que se hace entre los canales privados y públicos y los mensajes directos en las funciones heredadas de la API de despliegue que se usan en Lookerbot.

Sigue estos pasos para invitar a Lookerbot a un canal público o privado en Slack:

  1. Haz clic en el nombre del canal para abrir la configuración del canal.
  2. Selecciona la pestaña Integraciones.
  3. En Apps, selecciona el nombre de tu app de Lookerbot.

Cuando pegues la URL de una exploración o una vista en un canal de Slack al que se invitó a Lookerbot, Lookerbot expandirá automáticamente la URL y su contenido. Si el contenido de Looker tiene una visualización asociada, Lookerbot mostrará una imagen de esa visualización. Si el contenido de Looker es una tabla de datos, Lookerbot mostrará los datos como texto.

Usa comandos de barra personalizados para ejecutar y publicar consultas de Looker

También puedes crear y usar comandos de barra personalizados que, cuando se ejecuten, ejecutarán una consulta guardada de tus datos en Looker y publicarán el resultado en Slack. Los comandos de barra personalizados se crean durante la configuración de Lookerbot, pero cualquier usuario de Slack puede ejecutarlos en Slack.

No se requieren comandos de barra para interactuar con Lookerbot. Para usar todas las funciones de Lookerbot, también puedes enviar un mensaje al bot directamente o mencionarlo en un canal de Slack en el que esté presente Lookerbot: @lookerbot help.

Si la integración de Slack está habilitada para tu lugar de trabajo de Slack, no puedes usar comandos de barra /looker con Lookerbot. En lugar de @looker o /looker, usa @lookerbot o /lookerbot.

Si quieres ver los comandos que se crearon para tu Lookerbot, haz lo siguiente:

  • Coloca el cursor sobre cualquier mención de Lookerbot. Los comandos disponibles se enumeran en la ventana emergente.
  • Selecciona la app Lookerbot en la sección Apps del lugar de trabajo de Slack. Luego, selecciona la pestaña Acerca de en la página de la app. Los comandos disponibles aparecerán en Comandos.

Diferentes formas de usar los comandos de barra

Existen tres formas de usar comandos. Por ejemplo, supongamos que tú o un desarrollador de tu organización configuraron un comando para recuperar datos de Looker mediante el seguimiento de la cantidad de pedidos que los clientes hicieron de un producto determinado. El desarrollador usó “orders” para representar estos datos al configurar el comando de barra. Para invocar este comando, puedes hacer lo siguiente:

  1. @menciona Lookerbot y, luego, el componente de texto del comando. Esto se puede hacer en cualquier canal en el que esté presente Lookerbot. Por ejemplo:

    @lookerbot orders

  2. Usa el comando de barra. Para usar un comando, puedes hacer clic en él en la lista de comandos o escribir su nombre (precedido por una barra diagonal). Puede hacerlo si el comando de barra se configuró durante la configuración.

    /lookerbot orders

  3. Enviar un mensaje directo a Lookerbot. Si envías un mensaje directamente a Lookerbot, no es necesario que agregues /lookerbot al comando. En este caso, el DM sería simplemente orders.

Usa comandos de barra con filtros

Si tú o un desarrollador de tu organización crearon un comando de barra que consulta un panel con un solo elemento y filtros del panel, puedes ejecutar el comando para recuperar ese contenido de Looker y agregar valores de filtro desde Slack. Los filtros son opcionales y la consulta se ejecutará sin ese filtro si no se especifican valores.

Por ejemplo, supongamos que tiene un panel con una visualización de mapa del cliente que filtra ciudades específicas de EE.UU. y se configuró un comando de barra personalizado para llamar a estos datos del panel. Puedes ejecutar el comando customer map in, filtrado por Nueva York, de la siguiente manera:

Respuesta de Slackbot de una visualización de datos que muestra un mapa de Nueva York con puntos de diferentes tamaños que representan la cantidad de usuarios en un área determinada.

Formatos de datos

Los comandos mostrarán datos de diferentes maneras según el tipo de visualización del elemento subyacente Explorar, Vista o Panel. Existen tres formatos de devolución posibles:

  • Texto: Si el contenido subyacente es una tabla, los datos se mostrarán como texto. Por ejemplo, si un usuario ejecuta el comando configurado top customer this month, Slackbot muestra el registro principal en formato de texto:

    La respuesta de Slackbot al cliente principal de este mes muestra un vínculo a la consulta de Looker y los valores de Nombre de los usuarios, Edad de los usuarios, Estado de los usuarios y Recuento de pedidos.
  • Visualización de un solo valor: Si el contenido subyacente es una visualización de un solo valor, los datos se mostrarán como un valor de texto. Por ejemplo, si un usuario ejecuta el comando configurado orders last week, Slackbot muestra el recuento total de la semana anterior:

    Respuesta de Slackbot al comando de pedidos de la semana pasada que muestra un vínculo a la consulta de Looker y el recuento total de pedidos es 228.
  • Visualización: Si el contenido subyacente es una visualización, los datos se mostrarán como una imagen de la visualización. Por ejemplo, si un usuario ejecuta el comando configurado movie budgets con el valor Brad Pitt, Slackbot responde con un vínculo a la consulta de Looker y una visualización de gráfico de líneas que muestra las tendencias de valor crecientes y decrecientes del presupuesto promedio de una película de Brad Pitt de 0 a 160 millones para el primer año de estreno de una película, entre 1990 y 2015:

Recursos adicionales

Para obtener información sobre otras integraciones de Slack de Looker, consulta estos recursos: