Como usar o Lookerbot para Slack

Nesta página, você terá uma visão geral de como usar o Lookerbot, uma das várias integrações oferecidas pelo Looker para compartilhar dados do Looker no Slack.

O Lookerbot para Slack é integrado ao Looker para que você possa consultar seus dados diretamente no Slack, o que permite compartilhar dados com facilidade e responder a perguntas baseadas em dados sem ter que trabalhar fora do fluxo de trabalho atual da sua organização.

Esta página discute esses fluxos de trabalho do Slack-Lookerbot:

Começar a usar o Lookerbot

Antes de usar o Lookerbot no Slack, configure o aplicativo Lookerbot seguindo as instruções de configuração técnica no repositório GitHub de código aberto do Looker.

Em fevereiro de 2021, o Slack descontinuou alguns endpoints de API que afetam a interação do Lookerbot com ações de dados. Extraia as atualizações mais recentes do repositório do Lookerbot no GitHub (em inglês). O arquivo package.json precisa indicar uma versão do Looker do 0.0.16 ou mais recente.

Expansão automática dos URLs do Looker

O Lookerbot pode expandir os URLs automaticamente para o conteúdo do Looker que você compartilha no Slack. Para permitir que o Lookerbot expanda automaticamente os URLs compartilhados em um canal do Slack, adicione o Lookerbot a esse canal do Slack. A configuração do bot também precisa definir a variável de ambiente LOOKER_SLACKBOT_EXPAND_URLS como true. Consulte as instruções de configuração técnica do Lookerbot para mais informações sobre variáveis de ambiente.

A capacidade de expandir os URLs do Looker não está disponível nas mensagens diretas do Slack devido à distinção entre canais privados/públicos e mensagens diretas nos recursos da API de desenvolvimento legado usados no Lookerbot.

Se quiser convidar o Lookerbot para um canal público ou privado no Slack:

  1. Clique no nome do canal para abrir as configurações.
  2. Selecione a guia Integrações.
  3. Em Apps, selecione o nome do seu app Lookerbot.

Quando você cola o URL de uma Análise ou Look em um canal do Slack que recebeu um convite, o Lookerbot expande automaticamente o URL e o conteúdo dele. Se o conteúdo do Looker tiver uma visualização associada, o Lookerbot vai mostrar uma imagem dela. Se o conteúdo do Looker for uma tabela de dados, o Lookerbot vai mostrar os dados como texto.

Usar comandos de barra personalizados para executar e postar consultas do Looker

Também é possível criar e usar comandos de barra personalizados que, quando executados, executam uma consulta salva dos dados no Looker e publicam o resultado no Slack. Os comandos de barra personalizados são criados durante a configuração do Lookerbot, mas podem ser executados no Slack por qualquer usuário do Slack.

Os comandos de barra não precisam interagir com o Lookerbot. Para usar todas as funções do Lookerbot, você também pode enviar uma mensagem diretamente ao bot ou mencioná-lo em um canal do Slack em que o Lookerbot está presente: @lookerbot help.

Se a integração com o Slack estiver ativada para seu espaço de trabalho do Slack, não será possível usar comandos de barra /looker com o Lookerbot. No lugar de @looker ou /looker, use @lookerbot ou /lookerbot.

Para conferir os comandos criados para seu Lookerbot:

  • Passe o cursor sobre qualquer menção ao Lookerbot. Os comandos disponíveis estão listados na janela pop-up.
  • Selecione o app Lookerbot na seção Apps do espaço de trabalho do Slack. Em seguida, selecione a guia Sobre na página do app. Os comandos disponíveis serão listados em Comandos.

Diferentes maneiras de usar comandos de barra

Há três maneiras de usar os comandos. Digamos, por exemplo, que você ou um desenvolvedor da sua organização tenha configurado um comando para recuperar dados do Looker e acompanhar o número de pedidos que os clientes fizeram de um determinado produto. O desenvolvedor usou "ordens" para representar esses dados ao configurar o comando de barra. Para invocar esse comando, você pode:

  1. @mention Lookerbot seguido do componente de texto do comando. Isso pode ser feito em qualquer canal em que o Lookerbot esteja presente. Exemplo:

    @lookerbot orders

  2. Use o comando de barra. Para usar um comando, clique nele na lista de comandos ou digite o nome dele (precedido por uma barra). É possível fazer isso se o comando de barra tiver sido configurado durante a configuração.

    /lookerbot orders

  3. Mensagem direta do Lookerbot. Se você enviar uma mensagem diretamente ao Lookerbot, não vai ser necessário incluir /lookerbot no início do comando. Nesse caso, o DM seria apenas orders.

Usar comandos de barra com filtros

Se você ou um desenvolvedor da sua organização tiver criado um comando de barra que consulta um painel com um único elemento e filtros de painel, execute o comando para recuperar esse conteúdo do Looker e adicionar valores de filtro do Slack. Os filtros são opcionais, e a consulta vai ser executada sem eles se nenhum valor for especificado.

Por exemplo, digamos que você tenha um painel com uma visualização de mapa do cliente que filtra por cidades específicas dos EUA e um comando de barra personalizado foi configurado para chamar os dados do painel. É possível executar o comando customer map in, filtrado por Nova York, da seguinte maneira:

Resposta do Slackbot de uma visualização de dados com um mapa de Nova York com pontos de diferentes tamanhos representando o número de usuários em uma determinada área.

Formatos de dados

Os comandos vão retornar dados de maneiras diferentes, dependendo do tipo de visualização dos elementos "Explore", "Look" ou " dashboard" subjacente. Há três formatos possíveis de retorno:

  • Texto: se o conteúdo subjacente for uma tabela, os dados serão retornados como texto. Por exemplo, se um usuário executar o comando configurado top customer this month, o Slackbot retornará o registro superior no formato de texto:

    A resposta do Slackbot ao comando do cliente principal neste mês retorna um link para a consulta do Looker e os valores de "Nome dos usuários", "Idade dos usuários", "Estado dos usuários" e "Contagem de pedidos".
  • Visualização de valor único: se o conteúdo subjacente for uma visualização de valor único, os dados vão ser retornados como um valor de texto. Por exemplo, se um usuário executar o comando configurado orders last week, o Slackbot retornará a contagem total da semana anterior:

    Resposta do Slackbot aos pedidos do comando da semana passada que retorna um link para a consulta do Looker e a contagem total de pedidos como 228.
  • Visualização: se o conteúdo subjacente for uma visualização, os dados vão ser retornados como uma imagem da visualização. Por exemplo, se um usuário executar o comando configurado movie budgets com o valor Brad Pitt, o Slackbot responderá com um link para a consulta do Looker e uma visualização de gráfico de linhas que mostra as tendências de aumento e diminuição do valor do orçamento médio de um filme de Brad Pitt de 0 a 160 milhões para o primeiro ano de lançamento de um filme, de 1990 a 2015:

Outros recursos

Para informações sobre as outras integrações do Looker com o Slack, consulte estes recursos: