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:
- Introdução ao Lookerbot
- Expansão automática de URLs de conteúdo do Looker
- Como usar comandos de barra personalizados para executar e postar consultas do Looker
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 arquivopackage.json
precisa indicar uma versão do Looker de0.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:
- Clique no nome do canal para abrir as configurações.
- Selecione a guia Integrações.
- 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:
-
@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
-
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
-
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 simplesmenteorders
.
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:
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: -
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: -
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 valorBrad 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:
- Como enviar dados do Looker com a ação de anexo do Slack (token de API)
- Como enviar alertas para a integração do anexo do Slack (token de API)
- Como programar entregas para a integração com o Slack
- Como enviar alertas para a integração com o Slack