Como usar o Lookerbot para Slack

Esta página oferece uma visão geral de como usar o Lookerbot, uma das várias integrações que o Looker oferece para compartilhar dados do Looker no Slack.

O Lookerbot para Slack se integra ao Looker para que você possa consultar seus dados diretamente no Slack. Isso 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 suspendeu alguns endpoints de API que afetam a forma como o Lookerbot interage 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 de 0.0.16 ou mais recente.

Como expandir URLs do Looker automaticamente

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. 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 legados da API desdobrável 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 um canal "Explore" ou "Look" em um canal do Slack para o qual o Lookerbot foi convidado, 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 dessa visualização. Se o conteúdo do Looker for uma tabela de dados, o Lookerbot vai mostrar os dados como texto.

Como 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 postam 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 são necessários para interagir com o Lookerbot. Para usar todas as funções do Lookerbot, você também pode enviar uma mensagem diretamente para o 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 que foram criados para seu Lookerbot:

  • Passe o cursor sobre qualquer menção do 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 extrair dados do Looker e rastrear o número de pedidos que os clientes fizeram de determinado produto. O desenvolvedor usou "ordens" para representar esses dados ao configurar o comando de barra. Para invocar esse comando, você pode:

  1. @mencionar 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 ao Lookerbot. Se você enviar uma mensagem diretamente ao Lookerbot, não vai ser necessário incluir /lookerbot no início do comando. Nesse caso, a mensagem direta seria simplesmente orders.

Como 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 será executada sem esse filtro se nenhum valor for especificado.

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

Resposta do Slackbot de uma visualização de dados mostrando 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 retornam dados de maneiras diferentes, dependendo do tipo de visualização do elemento "Explore", "Look" ou " dashboard" subjacente. Há três formatos de retorno possíveis:

  • 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 principal cliente deste mês retorna um link para a consulta do Looker e os valores para "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 serão 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:

    A resposta do Slackbot aos pedidos da semana passada retornava um link para a consulta do Looker e a contagem total de pedidos como 228.
  • Visualização: quando o conteúdo é uma visualização, os dados retornam como uma imagem dela. 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 orçamento médio do filme 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 outras integrações do Looker com o Slack, consulte estes recursos: