Agendamento de entregas para a integração com o Slack

Você pode instalar o app Looker no espaço de trabalho do Slack para enviar ou programar entregas de dados diretamente para 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 precisa ajustar as configurações de instalação do app.

A integração Slack Attachment (API Token) também está disponível para uso.

Ativar a integração no Looker Action Hub

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

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

  3. Na página de ação Slack, clique em Conectar para se conectar ao seu 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 + Conectar ao espaço de trabalho do Slack.

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

  5. Clique na chave Ativar e em Salvar.

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

É possível gerenciar as conexões do espaço de trabalho do Slack na página de ação Slack. Clique no botão Configurações ao lado da integração com o Slack na página Ações no painel Administrador.

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

  • 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 Slack Workspace, 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ções do Slack para salvar essas configurações. A ação ainda será exibida como Enabled mesmo se nenhum espaço de trabalho do Slack estiver conectado.

  • Para atualizar sua conexão do Slack Workspace sem desconectar e reconectar, clique no botão Reset.

Autenticação no seu 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 conectou ao Looker. Os usuários também precisam ser membros 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 em:

Você recebe uma mensagem de confirmação do Slack depois de se autenticar 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. Todas 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 de Fazer login com o Slack vai aparecer. Se o administrador do Looker conectar mais de um espaço de trabalho do Slack à sua instância do Looker, uma lista de espaços de trabalho vai aparecer com opções para fazer login em cada um individualmente.
  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 OAuth. Selecione o espaço de trabalho do Slack adequado na lista suspensa. Clique em Permitir.
  4. Quando você retornar à página Conta, uma opção vai aparecer na seção Integrações para que você possa revogar suas credenciais do Slack em todos os espaços de trabalho a que você está conectado. Cuidado: tome cuidado para não revogar seu token do Slack. Se fizer isso, qualquer programação criada falhará.

Agora que está autenticado, é possível enviar ou programar dashboards, Looks e Explores. Consulte a seção Como enviar dados para o Slack nesta página para mais informações.

Como autenticar em um espaço de trabalho do Slack na janela "Enviar" ou "Programar"

  1. No Looker, navegue até o conteúdo a ser enviado, clique no menu de engrenagem e em Enviar ou Programar. Para painéis, selecione Programar entrega.
  2. Na janela Enviar ou Programar de uma Análise ou um 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 Fazer login.
  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 do Slack no menu suspenso. Clique em Permitir.
  5. A janela Enviar ou Programar (ou a janela Agendar entrega dos painéis) agora mostra as opções de entrega do Slack, incluindo os canais públicos e privados do espaço de trabalho do Slack.

Como entregar dados para o Slack

Você pode 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ê pode fazer login em cada uma delas na página Conta do usuário. Em seguida, é possível selecionar um espaço de trabalho de destino entre os listados na lista suspensa Espaços de trabalho do pop-up Enviar ou Programar, ou em Programar janela de entrega para painéis.

Estas são as opções de formatação para enviar um dashboard:

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

O envio ou a programação de um Look ou uma Análise detalhada tem diferentes opções de formatação disponíveis, incluindo:

  • CSV
  • XLSX
  • JSON — simples: nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como valor renderizado em vez do rótulo do campo.
  • JSON — Rótulo: nesse formato, o Looker usa rótulos de campo 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 métrica como valor renderizado em vez do rótulo do campo.
  • JSON: detalhado, inline: nesse formato, o Looker usa o nome de um campo de dimensão ou métrica como valor renderizado em vez do rótulo do campo.
  • Texto
  • HTML

Para criar um painel definido pelo usuário, um painel do LookML, um Look ou uma Análise detalhada, acesse seu conteúdo e siga 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.
  2. Na janela Enviar ou Programar, selecione a integração do Slack como o destino de entrega em Para onde esses dados devem ir? Para painéis, selecione a integração com o Slack como destino de entrega em Destino. Se esta for a primeira vez que você usa a integração com o Slack, primeiro será necessário fazer a autenticação no espaço de trabalho do Slack.
  3. O Looker mostra opções de entrega específicas para o espaço de trabalho do Slack ou os espaços de trabalho conectados a esta instância do Looker.
    • No campo Compartilhar em, insira o nome do canal do Slack em que você quer postar os dados. Você pode enviar mensagens diretas ou mensagens para canais públicos ou privados. Inclua o caractere # no início, por exemplo, #Vendas.
    • No campo Comentário, insira qualquer texto que você queira incluir na entrega. Você também pode 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 Nome do arquivo, insira um nome para o arquivo de anexo.
  4. Se você estiver agendando 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. Seus 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:

Como 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, painéis do LookML, Looks (mas não Looks incorporados publicamente) ou Análises no Slack.

O link é aberto no Slack para mostrar o título do conteúdo e alguns dos metadados, que só são visíveis para quem tem acesso ao conteúdo. Depois que o link for alterado, 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 é publicado no canal, qualquer pessoa no canal pode conferir o resumo e o título do conteúdo, mesmo que não tenha acesso ao conteúdo no Looker.
  • Adicione o conteúdo a uma pasta Favoritos do Looker. Clique em Adicionar aos favoritos. Depois de adicionar conteúdo à pasta Favoritos, o app do Looker no Slack mostra uma mensagem 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, defina a instância padrão para que ela corresponda à instância do Looker que você está usando para compartilhar o link.

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. Os comandos personalizados do Slack não estão disponíveis para a integração com o Slack, mas você pode configurar comandos personalizados no Lookerbot. Atualize a partir do repositório do GitHub do Lookerbot, conforme instruído na seção Como começar com o Lookerbot da página de práticas recomendadas Usar o Lookerbot para Slack.

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

  • /looker e /looker whoami: o app do Looker no Slack cumprimenta você pelo nome, informa a instância do Looker à qual você está conectado e fornece links para a pasta Favoritos, 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 Favorites 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 sua pasta pessoal. 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. Para definir uma instância padrão para seu espaço de trabalho do Slack, clique nela nesta lista. Todos os comandos de barra específicos da instância se aplicam à instância padrão do Looker.

Visualizar a guia inicial do app Looker no Slack

Para acessar uma lista das suas pastas e conteúdos 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 o espaço de trabalho do Slack, verá apenas o conteúdo dessa instância na guia Página inicial do app Looker.

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

Se o administrador do Looker conectou apenas uma instância do Looker ao espaço de trabalho do Slack, ela é o padrão.

Se o administrador do Looker conectou várias instâncias do Looker ao espaço de trabalho do Slack, é possível definir uma das instâncias como padrão. Qualquer comando de barra específico da instância (a maioria dos comandos além de /looker help) e o desencapsulamento de links 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 vai perguntar 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 a seleção.

Para mudar a instância padrão do Looker, execute /looker select novamente e selecione outra instância. Você precisa mudar as instâncias padrão se estiver abrindo links de uma instância do Looker que não seja a padrão. Se você não mudar de instância e tentar desfazer o encapsulamento de um link de uma instância do Looker que não é padrão, será necessário fazer login nessa instância.