Ir para o conteúdo

Conexão Slack

Introdução

Uma conexão Slack, criada usando o conector Slack, estabelece acesso ao Slack. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Slack associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Importante

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

Crie ou edite uma conexão Slack

Uma nova conexão Slack é criada usando o conector Slack de um destes locais:

Uma conexão existente do Slack pode ser editada nestes locais:

Configurar uma conexão Slack

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

A interface usada na configuração da conexão do 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 Concessão: Para esta opção, a conexão é autenticada pelo Slack em uma aba separada do navegador (OAuth de 3 pernas). Após 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 uma conexão global do Slack.

Autenticação baseada em token

Quando Autenticação baseada em token é selecionada como o Mecanismo de autenticação, esta interface é apresentada:

Configuração de conexão do Slack

Dica

Campos com um suporte a ícones variáveis usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para usar 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 Autenticação baseada em token para autenticar usando um token de acesso OAuth.

  • Tipo de autenticação: Selecione o tipo de autenticação, Token de acesso OAuth ou Token de acesso OAuth do usuário do bot (recomendado):

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

  • Teste: 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 a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de 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 para você confirmar 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

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

Quando Concessão de código de autorização é selecionado como o Mecanismo de autenticação, esta interface é apresentada:

Configuração de conexão do Slack

  • Nome da conexão: Insira um nome para usar 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 Concessão de código de autorização para autenticar fornecendo consentimento por meio do Slack em uma aba separada do navegador (OAuth de 3 etapas).

  • Aplicativo OAuth: Visível somente quando aplicativos privados são registrados no App Registration. Use o menu para selecionar um aplicativo OAuth 2.0 de uma destas categorias:

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

    • Aplicativos privados: Esta categoria exibe os aplicativos do conector Slack configurados no Management Console Registros de aplicativos. Para obter mais informações sobre como configurar um aplicativo do conector Slack na página Registros de aplicativo, consulte Configurar OAuth de 3 pernas em Pré-requisitos.

    Nota

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

  • Faça login com o Slack: Clique para autenticar pelo Slack em uma aba separada do navegador e dê consentimento para que o Jitterbit acesse o aplicativo Slack.

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

  • Teste: 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 a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de 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 para você confirmar 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

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

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

  • Pesquisar: Encontra mensagens no Slack e deve ser usado como fonte em uma operação.

  • Publicar: Publica um objeto em um canal do Slack e deve ser usado como alvo em uma operação.

  • Bater papo: Coloca informações de bate-papo no Slack e deve ser usado como alvo em uma operação.

  • Pegar: Recupera dados de objetos do Slack e deve ser usado como fonte em uma operação.

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

  • Conversas: Publica informações de conversas no Slack e deve ser usado como alvo em uma operação.

  • Usuários: Coloca informações do usuário no Slack e deve ser usado como alvo em uma operação.