Como programar entregas para a integração com o Slack

É possível instalar o app Looker no espaço de trabalho do Slack para enviar ou programar entregas de dados diretamente em canais públicos e privados do Slack. Para ativar a instalação do app Looker, o proprietário do espaço de trabalho do Slack pode precisar ajustar as configurações de instalação do app.

A integração do Anexo do Slack (token de API) também está disponível para uso.

Como ativar a integração no Looker Action Hub

Se a instância do Looker atender às condições exigidas, o administrador do Looker vai precisar ativar a integração com o Slack no Looker Action Hub para cada instância do Looker, antes que os usuários possam enviar dados com a integração com o Slack.

  1. No painel Administrador em Plataforma, acesse a página Ações.
  2. Clique no botão Ativar para ativar a integração com o Slack no Hub de ações do Looker.

  3. Na página de ação Slack, clique em Connect para se conectar ao espaço de trabalho do Slack.

    O Looker vai solicitar acesso ao espaço de trabalho do Slack indicado no menu suspenso no canto superior direito da página. Para conectar vários espaços de trabalho do Slack a uma única instância do Looker, clique no link + Connect to Slack workspace.

  4. Clique em Permitir e retorne à página de ação Slack.

  5. Clique na chave Ativar e, depois, em Salvar.

Como gerenciar conexões do Slack Workspace com o Looker

É possível gerenciar as conexões do espaço de trabalho do Slack da instância na página de ação do Slack. Clique no botão Settings ao lado da integração com o Slack na página Actions no painel Admin.

Os administradores podem realizar as seguintes operações com cada conexão do Workspace com o Slack: conectar, desconectar e redefinir.

  • Para conectar mais espaços de trabalho do Slack à instância do Looker, clique no link + Connect to Slack workspace.

  • Para desconectar uma conexão de espaço de trabalho do Slack, clique no botão Desconectar e depois em OK na mensagem de aviso pop-up. Você não precisa clicar em Save na página de ação Slack para salvar essas configurações. A ação ainda será exibida como Enabled, mesmo que nenhum espaço de trabalho do Slack esteja conectado.

  • Para atualizar a conexão do espaço de trabalho do Slack sem precisar desconectar e reconectar, clique no botão Reset.

Como autenticar no espaço de trabalho do Slack

Os usuários precisam fazer a autenticação no mesmo espaço de trabalho do Slack que o administrador do Looker conectou ao Looker. Os usuários também precisam ser participantes do espaço de trabalho para fazer a autenticação no Looker.

É possível autenticar em um espaço de trabalho do Slack pela primeira vez acessando:

Você vai receber uma mensagem de confirmação do Slack depois de fazer a autenticação no Slack usando o Looker.

Como autenticar em um espaço de trabalho do Slack na página "Conta"

  1. No Looker, clique no ícone do perfil do usuário no canto superior direito da tela e selecione Conta.
  2. As integrações ativadas para sua instância aparecem em Integrações. Se o administrador do Looker tiver ativado pelo menos um espaço de trabalho do Slack, um botão Fazer login com o Slack será exibido. Se o administrador do Looker tiver conectado mais de um espaço de trabalho do Slack à sua instância do Looker, uma lista de espaços de trabalho será exibida com opções para fazer login em cada um deles.
  3. O Looker vai solicitar acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, um menu suspenso vai aparecer no canto superior direito da página do OAuth. Selecione o espaço de trabalho apropriado do Slack no menu suspenso. Clique em Permitir.
  4. Quando você voltar para a página Conta, vai aparecer uma opção na seção Integrações que permite revogar suas credenciais do Slack para todos os espaços de trabalho aos quais você está conectado. Cuidado: tenha cuidado para não revogar seu token do Slack. Se você fizer isso, todas as programações criadas falharão.

Agora que a autenticação foi concluída, você pode enviar ou programar dashboards, Looks e Explores. Consulte a seção Como entregar dados ao Slack nesta página para mais informações.

Como autenticar em um espaço de trabalho do Slack pela janela "Enviar ou programar"

  1. No Looker, navegue até o conteúdo que você quer enviar, clique no menu de engrenagem e em Enviar ou Programar. Em painéis, selecione Programar entrega.
  2. Na janela Send ou Schedule de um Explore ou Look, selecione a ação Slack como destino de entrega em Para onde esses dados devem ir?. Para painéis, selecione Programar entrega na janela "Programar e enviar".
  3. Ao lado de Slack, clique em Log in.
  4. O Looker vai solicitar acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, um menu suspenso vai aparecer no canto superior direito da página do OAuth. Selecione o espaço de trabalho apropriado do Slack no menu suspenso. Clique em Permitir.
  5. A janela Enviar ou Programar (ou a janela Agendar entrega para painéis) agora mostra as opções de entrega do Slack, incluindo os canais públicos e privados do seu espaço de trabalho do Slack.

Entrega de dados ao Slack

É possível enviar conteúdo para um dos vários espaços de trabalho do Slack. Depois que um administrador do Looker configurar as conexões do espaço de trabalho, você vai poder fazer login em cada uma delas na página Conta do usuário. Em seguida, você pode selecionar um espaço de trabalho de destino entre os listados no menu suspenso Espaços de trabalho do pop-up Enviar ou Programar, ou em Janela de programação de entrega para painéis.

O exemplo abaixo mostra as opções de formatação para entrega de um painel, que incluem:

  • PDF
  • Visualização (PNG)
  • Arquivo ZIP CSV

Enviar ou programar um Look ou um Explore tem diferentes opções de formatação disponíveis, incluindo:

  • CSV
  • XLSX
  • JSON: simples: nesse formato, o Looker usa o nome do campo da dimensão ou da medida como valor renderizado em vez do rótulo do campo.
  • JSON: rótulo: nesse formato, o Looker usa o campo labels como o valor renderizado na saída JSON.
  • JSON: simples, inline: nesse formato, o Looker usa o nome de um campo de dimensão ou medida como valor renderizado em vez do rótulo do campo.
  • JSON: detalhado e inline: nesse formato, o Looker usa o nome de um campo de dimensão ou medida como valor renderizado em vez do rótulo dele.
  • Texto
  • HTML

Para entregar um dashboard definido pelo usuário, um dashboard do LookML, um Look ou uma Análise, navegue até o conteúdo e execute estas etapas:

  1. Clique no menu de engrenagem e em Enviar ou Programar. Você não terá a opção de programar uma Análise. Para painéis, selecione Programar entrega no menu de três pontos do painel.
  2. Na janela Send ou Schedule, selecione a integração com o Slack como o destino de entrega em Para onde esses dados devem ir?. Para painéis, selecione a integração com o Slack como o destino de entrega em Destino. Se esta for a primeira vez que você usa a integração com o Slack, primeiro será preciso fazer a autenticação no espaço de trabalho do Slack.
  3. O Looker mostra opções de entrega específicas para os espaços de trabalho do Slack ou os conectados a esta instância do Looker.
    • No campo Share In, insira o nome do canal do Slack em que seus dados serão postados. Você pode enviar mensagens diretas ou e-mails para canais públicos ou privados. Inclua o caractere # no início, por exemplo, #Vendas.
    • No campo Comentário, digite o texto que você quer incluir no envio. Também é possível usar a formatação avançada do Slack com análise especial para mencionar grupos, usuários ou canais específicos ou fazer outras menções especiais.
    • No campo Filename, digite um nome para o arquivo anexado.
  4. Se você estiver programando uma entrega de dados, clique em Salvar tudo. Sua consulta ou painel será enviado ao Slack conforme programado. Se você estiver enviando seus dados, clique em Enviar. Seus dados serão enviados ao canal do Slack.

Acessar o Looker no Slack

É possível acessar os dados do Looker no Slack:

Como compartilhar links para o conteúdo do Looker no Slack

É possível compartilhar links para visualizações do SQL Runner, painéis definidos pelo usuário, painéis do LookerML, Looks (mas não Looks incorporados publicamente) ou Explores no Slack.

O link é desdobrado no Slack para mostrar o título do conteúdo e alguns dos metadados dele, que são visíveis apenas para quem tem acesso ao conteúdo subjacente. Após a expansão do link, você ou outros usuários podem:

  • Poste um link para o conteúdo no Looker e um resumo do conteúdo do canal. Clique em Postar neste canal. Depois que o conteúdo é publicado no canal, qualquer pessoa nele pode acessar o resumo e o título do conteúdo, mesmo que não tenha acesso ao conteúdo subjacente no Looker.
  • Adicione o conteúdo a uma pasta Favorites do Looker: clique em Add to Favorites. Depois que você adiciona conteúdo à pasta Favorites, o app Looker no Slack exibe uma mensagem no Slack com um link para acessar a pasta Favorites no Looker.

Se houver várias instâncias do Looker conectadas ao espaço de trabalho, defina a instância padrão para corresponder à instância do Looker de que você está compartilhando o link.

Como usar comandos de barra para recuperar informações do Looker no Slack

Se o Lookerbot também estiver ativado, talvez seja necessário renomear alguns comandos de barra. Os comandos personalizados do Slack não estão disponíveis para a integração com o Slack, mas é possível configurar comandos personalizados no Lookerbot. Verifique se você está usando o Lookerbot na versão 0.0.16 ou mais recente atualizando o repositório do Lookerbot no GitHub, conforme instruído na seção Introdução ao Lookebot da página de práticas recomendadas Como usar o Lookerbot para Slack.

Use os seguintes comandos de barra para recuperar informações do Looker e publicá-las no Slack:

  • /looker e /looker whoami: o app Looker no Slack chama você pelo nome, informa a instância do Looker a que sua conexão está conectada e links para sua pasta Favorites do Looker, para sua pasta pessoal e para Help.
  • /looker help: o app Looker no Slack lista os comandos de barra compatíveis.
  • /looker favorites: o app Looker no Slack lista o conteúdo da pasta Favorites do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu em que é possível Postar neste canal ou Remover dos favoritos.
  • /looker folder: o app Looker no Slack lista o conteúdo da sua pasta pessoal do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu no qual é possível Postar neste canal ou Remover dos favoritos (se o conteúdo também estiver em sua pasta Favoritos).
  • /looker select: o app Looker no Slack lista as instâncias conectadas a esse espaço de trabalho do Slack. Para definir uma instância padrão para seu espaço de trabalho do Slack, clique nela na lista. Todos os comandos de barra específicos da instância seriam aplicados à instância padrão do Looker.

Acessar a guia "Início" do app Looker no Slack

Para conferir uma lista do seu conteúdo e pastas favoritos do Looker no Slack, clique na guia Página inicial do app Looker.

Se você definir uma instância padrão do Looker para seu espaço de trabalho do Slack, só vai aparecer o conteúdo dessa instância na guia Página inicial do app Looker.

Como configurar uma instância padrão do Looker para seu espaço de trabalho do Slack

Se o administrador do Looker tiver conectado apenas uma única instância do Looker ao seu espaço de trabalho do Slack, ela será o padrão.

Se o administrador do Looker conectou várias instâncias do Looker ao seu espaço de trabalho do Slack, defina uma delas como a instância padrão do Looker. Todos os comandos de barra específicos da instância (a maioria dos comandos, exceto /looker help) e o desdobramento de links são aplicados à instância padrão.

  1. No Slack, execute o comando de barra /looker select para acessar uma lista das instâncias do Looker conectadas ao espaço de trabalho do Slack.

  2. O app Looker pergunta Qual instância você quer definir como padrão? Clique no botão correspondente ao nome da instância do Looker para defini-la como padrão.

    O app Looker vai confirmar sua seleção.

Para mudar sua instância padrão do Looker, execute /looker select novamente e selecione outra instância. Mude as instâncias padrão se você estiver desenrolando links de uma instância do Looker que não é a padrão. Se você não mudar as instâncias e tentar desdobrar um link de uma instância não padrão do Looker, vai precisar fazer login nessa instância.