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 datos de Looker en Slack.

Lookerbot para Slack se integra con Looker para que puedas consultar tus datos directamente desde Slack, lo que te permite compartirlos 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 estos flujos de trabajo de Slack-Lookerbot:

Comienza a usar Lookerbot

Antes de poder usar Lookerbot en Slack, debes configurar la aplicación de Lookerbot siguiendo las instrucciones de configuración técnica 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 Lookerbot. Tu archivo package.json debe indicar una versión de Looker de 0.0.16 o una posterior.

Expansión automática de las URLs de Looker

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 desplegado 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.
  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.

Usar 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 directamente al bot 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, sigue estos pasos:

  • Coloca el cursor sobre cualquier mención de Lookerbot. Los comandos disponibles se enumeran en la ventana emergente.
  • Selecciona la app de Lookerbot en la sección Apps del espacio 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 los comandos. Supongamos, por ejemplo, que tú o un desarrollador de tu organización configuraron un comando para recuperar datos desde Looker y hacer un seguimiento de la cantidad de pedidos que los clientes hicieron de un producto determinado. El desarrollador utilizó “orders” para representar estos datos al configurar el comando de barra. Para invocar este comando, puedes hacer lo siguiente:

  1. @menciona a Lookerbot, seguido del 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, puede hacer clic en él en la lista de comandos o escribir el nombre del comando (precedido por una barra diagonal). Puedes hacerlo si el comando de barra se configuró durante la configuración.

    /lookerbot orders

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

Uso de 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 de 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 tienes 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 devolverán datos de diferentes maneras, según el tipo de visualización del elemento subyacente de Explorar, Vistas o Panel. Existen tres formatos de datos posibles que se muestran:

  • 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 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 para películas de Brad Pitt de 0 a 160 millones para el primer año de estreno de una película, que va de 1990 a 2015:

Recursos adicionales

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