Ir para o conteúdo

Conexão Slack

Introdução

Uma conexão Slack, criada usando o conector Slack, estabelece acesso ao Slack. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Slack associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Importante

Para usar o conector Slack, é necessário criar um aplicativo Slack e adicionar os escopos necessários (conforme descrito em Pré-requisitos do Slack).

Criar ou editar uma conexão Slack

Uma nova conexão Slack é criada usando o conector Slack a partir de uma destas localizações:

Uma conexão Slack existente pode ser editada a partir destas localizações:

Configurar uma conexão Slack

Cada elemento da interface da tela de configuração da conexão Slack é descrito abaixo.

A interface utilizada na configuração da conexão Slack depende da opção Mecanismo de autenticação selecionada:

  • Autenticação baseada em Token: Para esta opção, a conexão é autenticada usando um token OAuth para seu aplicativo Slack.

  • Código de Autorização: Para esta opção, a conexão é autenticada através do Slack em uma aba de navegador separada (OAuth de 3 etapas). Uma vez autenticado, você fornece consentimento para que o Harmony acesse o aplicativo Slack. Esta opção requer o uso da versão do agente 10.83 / 11.21 ou posterior.

Nota

Autenticação baseada em Token deve ser usada para um endpoint global do Slack.

Autenticação baseada em Token

Quando Autenticação baseada em Token é selecionada como o mecanismo de autenticação, a interface descrita abaixo é apresentada.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão Slack e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Slack, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Mecanismo de autenticação: Selecione Autenticação baseada em Token para autenticar usando um token de acesso OAuth.

  • Tipo de autenticação: Selecione o tipo de autenticação, seja Token de Acesso OAuth ou Token de Acesso OAuth de Bot User (recomendado):

  • Token de acesso OAuth do usuário do bot: Se Token de acesso OAuth do usuário do bot foi selecionado como o Tipo de autenticação, insira o token do bot que você obteve do site da API do Slack, conforme descrito em Obter um token OAuth em Pré-requisitos. Esta é a opção recomendada.

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Concessão de Código de Autorização

Quando Concessão de Código de Autorização é selecionada como o Mecanismo de autenticação, a interface descrita abaixo é apresentada.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do Slack e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Slack, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Mecanismo de autenticação: Selecione Authorization Code Grant para autenticar fornecendo consentimento através do Slack em uma aba do navegador separada (OAuth de 3 etapas).

  • Aplicativo OAuth: Visível apenas quando aplicativos privados estão registrados na página de Registro de Aplicativos. Use o menu para selecionar um aplicativo OAuth 2.0 de uma dessas categorias:

    • Aplicativos em Nuvem: O aplicativo nesta categoria (Jitterbit App) é um aplicativo OAuth 2.0 fornecido pela Jitterbit. Se não houver aplicativos privados registrados na página de Registro de Aplicativos, o Jitterbit App é usado por padrão.

    • Aplicativos Privados: Esta categoria exibe aplicativos de conector do Slack configurados na página de Registro de Aplicativos do Console de Gerenciamento. Para mais informações sobre como configurar um aplicativo de conector do Slack na página de Registro de Aplicativos, veja Configurar OAuth de 3 etapas em Pré-requisitos.

    Nota

    Se o campo Aplicativo OAuth não estiver visível, o aplicativo OAuth 2.0 fornecido pela Jitterbit é usado por padrão.

  • Entrar com Slack: Clique para autenticar através do Slack em uma aba do navegador separada e forneça consentimento para que a Jitterbit acesse o aplicativo Slack.

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão Slack, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Fundamentos do conector.

Estes tipos de atividade estão disponíveis:

  • Buscar: Encontra mensagens no Slack e é destinado a ser usado como uma fonte em uma operação.

  • Postar: Publica um objeto em um canal do Slack e é destinado a ser usado como um alvo em uma operação.

  • Chat: Coloca informações de chat no Slack e é destinado a ser usado como um alvo em uma operação.

  • Obter: Recupera dados de objeto do Slack e é destinado a ser usado como uma fonte em uma operação.

  • Arquivos: Coloca informações de arquivo no Slack e é destinado a ser usado como um alvo em uma operação.

  • Conversas: Envia informações de conversas para o Slack e é destinado a ser usado como um alvo em uma operação.

  • Usuários: Envia informações de usuários para o Slack e é destinado a ser usado como um alvo em uma operação.