Como programar entregas para a integração do Slack

É possível instalar o app Looker no seu espaço de trabalho do Slack para enviar ou agendar entregas de dados diretamente em canais públicos e particulares do Slack. Para permitir 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 de apps do seu espaço de trabalho do Slack.

A integração do Slack não é compatível com instâncias hospedadas pelo cliente.
A integração com o Slack está disponível para implantações hospedadas pelo Looker que atendem a estas condições:

  • A instância do Looker está na versão 6.24 ou posterior.
  • O recurso Lista de permissões de IP não está ativado na instância do Looker.

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

Como ativar a integração no Looker Action Hub

Caso sua instância do Looker atenda às condições necessárias, seu administrador do Looker precisa ativar a integração do Slack no Hub de ação do Looker (ambos em inglês) para cada instância do Looker antes que os usuários possam entregar dados com a integração do Slack.

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

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

    O Looker solicita 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 + Conectar ao espaço de trabalho do Slack.

  4. Clique em Permitir e volte para a página de ação do Slack.

  5. Clique na chave Ativar e em Salvar.

Como gerenciar conexões do espaço de trabalho do Slack com o Looker

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

Os administradores podem realizar as seguintes operações com cada conexão de espaço de trabalho do Slack: Connect, Disconnect, and reset.

  • Para conectar outros espaços de trabalho do Slack à instância do Looker, clique no link + Conectar ao espaço de trabalho do Slack.

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

  • Para atualizar a conexão do Workspace com o Slack sem precisar se desconectar e reconectar, clique no botão Redefinir.

Como autenticar no seu espaço de trabalho do Slack

Os usuários precisam ser autenticados no mesmo espaço de trabalho do Slack que o administrador do Looker se conectou. Os usuários também precisam ser membros atuais do espaço de trabalho para se autenticarem no Looker.

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

Você recebe uma mensagem de confirmação do Slack depois de se autenticar no Looker no Looker.

Autenticar em um espaço de trabalho do Slack na página Conta

  1. No Looker, clique no ícone do seu perfil de usuário no canto superior direito da tela e selecione Conta.
  2. Todas as integrações ativadas para a instância aparecem em Integrações. Se o administrador do Looker tiver ativado pelo menos um espaço de trabalho do Slack, você verá um botão para Fazer login com o Slack. 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 individualmente.
  3. O Looker solicita 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 será exibido no canto superior direito da página OAuth. Selecione o espaço de trabalho adequado do Slack no menu suspenso. Clique em Permitir.
  4. Voltando à página Conta, aparece uma opção para revogar as credenciais do Slack de todos os espaços de trabalho a que você está conectado.

Tenha cuidado para não revogar seu token do Slack. Se você fizer isso, todas as programações que você criou falharão.

Agora que você está autenticado, é possível enviar ou programar painéis, aparências e explorações. Consulte a seção Como entregar dados ao Slack nesta página para saber mais.

Autenticar em um espaço de trabalho do Slack na janela Enviar ou Programar

  1. No Looker, navegue até o conteúdo a ser exibido, clique no menu de engrenagem e clique em Enviar ou Programar.
  2. Na janela Enviar ou Programar, selecione a ação Slack como destino de entrega em Para onde devem ir os dados?
  3. Ao lado de Slack, clique em Fazer login.
  4. O Looker solicita 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 será exibido no canto superior direito da página OAuth. Selecione o espaço de trabalho adequado do Slack no menu suspenso. Clique em Permitir.
  5. A janela Send ou Schedule agora mostra as opções de entrega do Slack, incluindo os canais públicos e particulares do espaço de trabalho do Slack. 

Como entregar dados ao Slack

Para entregar dados à integração do Slack, o administrador do Looker precisa conceder aos usuários a permissão send_to_integration e ativar a integração do Slack no Hub de ação do Looker. Os usuários também precisam ser autenticados no mesmo espaço de trabalho do Slack ou nos mesmos espaços de trabalho que o administrador conectou ao Looker.

É possível entregar conteúdo em 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ê poderá fazer login em cada um na página Conta do usuário. Em seguida, selecione um espaço de trabalho de destino entre os listados no menu suspenso Espaços de trabalho do pop-up Enviar ou Programar.

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

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

O envio ou a programação de um recurso "Olhar" ou "Explorar" tem diferentes opções de formatação disponíveis, incluindo:

  • CSV
  • XLSX
  • JSON — Simples: neste formato, o Looker usa um nome de campo de dimensão ou medida como o valor renderizado, em vez do marcador do campo.
  • JSON: rótulo: neste formato, o Looker usa o campo labels como o valor renderizado na saída JSON.
  • JSON — simples, in-line: neste formato, o Looker usa um nome de campo de dimensão ou medida como o valor renderizado, em vez do rótulo do campo.
  • JSON: detalhado e in-line: neste formato, o Looker usa um nome de campo de dimensão ou medida como o valor renderizado, em vez do rótulo do campo.
  • Texto
  • HTML

Para enviar uma exploração no formato PDF ou PNG, salve o recurso "Consultar um painel" e programe o painel no formato desejado. Para programar uma exploração, primeiro é necessário salvá-la como um olhar.

Para enviar ou programar um visual no formato PDF ou PNG, salve o documento no painel e programe-o no formato desejado.

Para fornecer um painel definido pelo usuário, um painel LookML, um Look ou um Explore, navegue até seu 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 exploração.
  2. Na janela Send ou Schedule, selecione a integração do Slack como o destino de entrega em Para onde esses dados devem ir?. Se esta for a primeira vez que você usa a integração do Slack, primeiro será preciso autenticar no espaço de trabalho do Slack.
  3. O Looker exibe opções de entrega específicas para os espaços de trabalho do Slack ou do Workspace conectados a esta instância do Looker.
    • No campo Share In, digite o nome do canal do Slack em que os dados serão publicados. É possível enviar mensagens diretas ou mensagens para canais públicos ou privados. Inclua o caractere # principal, por exemplo, #Vendas.
    • No campo Comentário, digite qualquer texto para incluir na entrega.
      • Para mencionar um usuário, inclua <@user_ID>, que pode ser copiado clicando no botão ... no perfil de usuário do Slack.
      • Para mencionar um grupo, inclua <@group_ID>, que você pode copiar do URL do navegador quando estiver no perfil do grupo.
      • Para mencionar um canal específico, inclua <#channel_ID>, que pode ser copiado do URL do navegador quando você estiver nele.
      • Para outras menções especiais, use <!here>, <!channel> ou <!everyone>.
    • No campo Filename, digite um nome para o arquivo anexo.
  4. Para programar uma entrega de dados, clique em Salvar tudo. Sua consulta ou painel será entregue ao Slack conforme programado. Se você estiver enviando seus dados, clique em Enviar. Os dados serão enviados para seu canal do Slack.

Como acessar o Looker no Slack

Para acessar os dados do Looker no Slack, faça o seguinte:

Compartilhar links para conteúdo do Looker no Slack

Você pode compartilhar links para visualizações do SQL Runner, painéis definidos pelo usuário (incluindo conteúdo de painéis legados), Painéis do LookML, Looks (mas não Looks publicamente incorporados) ou Explorars no Slack.

O link é revelado no Slack para mostrar o título do conteúdo e alguns dos metadados dele, que são visíveis somente para as pessoas que têm acesso ao conteúdo. Depois que o link for desbloqueado, você ou outros usuários poderão:

  • Poste um link para o conteúdo no Looker e um resumo do conteúdo no canal. Clique em Postar neste canal. Depois que o conteúdo é postado no canal, qualquer pessoa no canal pode ver o resumo e o título do conteúdo, mesmo que não tenham acesso ao conteúdo subjacente no Looker.
  • Adicione o conteúdo a uma pasta Favoritos do Looker e clique em Adicionar aos favoritos. Depois que você adicionar conteúdo à sua pasta Favoritos, o app Looker no Slack exibirá uma mensagem no Slack com um link para acessar a pasta Favoritos no Looker.

Se você tiver várias instâncias do Looker conectadas ao espaço de trabalho, precisará definir a instância padrão para corresponder à instância do Looker em que o link é compartilhado.

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

Se você também tiver o Lookerbot ativado, talvez seja necessário renomear alguns comandos de barra. Comandos personalizados do Slack não estão disponíveis para a integração do Slack, mas você pode configurar comandos personalizados no Lookerbot. Verifique se você está usando o Lookerbot versão 0.0.16 ou posterior, atualizando a partir do repositório do GitHub do Looker, conforme instruído na seção Como atualizar o aplicativo Lookerbot do artigo Como usar o Lookerbot para Slack da Central de Ajuda.

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 sauda você pelo nome, informa a instância do Looker a que você está conectado e fornece links para a pasta Favoritos do Looker, para sua pasta pessoal e para a Ajuda.
  • /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 Favoritos do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu em que você pode Postar neste canal ou Remover dos favoritos.
  • /looker folder: o app Looker no Slack lista o conteúdo da pasta pessoal do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu em que você pode Postar neste canal ou Remover dos favoritos (se o conteúdo também estiver na 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 o espaço de trabalho do Slack, clique nela na lista. Todos os comandos de barra específicos da instância são aplicados à instância padrão do Looker.

Ver a guia inicial do app Looker no Slack

Para ver uma lista do seu conteúdo e das pastas favoritas do Looker no Slack, clique na guia Página inicial no aplicativo do Looker.

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

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

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

Se o administrador do Looker tiver conectado várias instâncias do Looker ao seu espaço de trabalho do Slack, você poderá definir uma das instâncias como a instância padrão do Looker. Todos os comandos de barra específicos da instância, a maioria dos comandos além de /looker help, e o desenrolamento de link se aplicam à instância padrão.

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

  2. O app Looker pergunta Qual instância você gostaria de 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 confirmará sua seleção.

Para alternar a instância padrão do Looker, execute /looker select novamente e selecione uma instância diferente do Looker. Será preciso alternar as instâncias padrão se você quiser desassociar links de uma instância do Looker que não seja a instância padrão. Se você não trocar de instância e tentar descompactar um link de uma instância não padrão do Looker, será necessário fazer login nela.