Configuração

Introdução

Para habilitar as atividades do Slack, você precisa inserir detalhes de autenticação na atividade Slack Scope . Esses detalhes de autenticação dão a um Robô a capacidade de realizar Actions em seu nome e acessar seus dados permitidos.

Para gerar e conceder os detalhes de autenticação e começar a criar seu projeto de automação, conclua as seguintes etapas:

Crie um novo Aplicativo Slack (sem necessidade de codificação)
Adicionar permissões de aplicativos
Instale seu aplicativo em seu espaço de trabalho
Crie seu projeto

Depois de criar seu aplicativo, o Slack atribui a ele um ID de cliente exclusivo, Segredo do cliente (ou seja, credenciais de aplicativo) e um token de acesso OAuth (para automação autônoma) que você inserirá nas propriedades de autenticação da atividade Slack Scope .

Etapas

Antes de usar as atividades do Slack, siga as etapas abaixo para gerar ou coletar os dados de entrada necessários para a atividade Slack Scope .

1. Crie um aplicativo Slack

Para usar as atividades do Slack, você pode criar um aplicativo simples de espaço de trabalho único. As etapas e o exemplo abaixo pressupõem que você tenha e seja membro de um espaço de trabalho existente.

Faça login no seu espaço de trabalho Slack ou abra o aplicativo de desktop Slack.
- Se você fizer login usando o URL acima, precisará do URL do Slack do seu espaço de trabalho.
Acesse Seus aplicativos e clique no botão Criar novo aplicativo .
Digite o nome do seu aplicativo, selecione o Development Slack Workspace e clique no botão Create App .

Depois de criar seu aplicativo, você será direcionado para a página Informações básicas . É aqui que você pode encontrar o Client ID e o Client Secret necessários para a autenticação de automação assistida na atividade Slack Scope .

Antes de copiá-los e colá-los em sua atividade, você deve configurar os recursos OAuth e permissões seguindo as etapas na próxima seção.

Observação:

Embora tecnicamente seja possível, isso não é recomendado porque você precisaria compartilhar seu segredo do cliente com eles.

Se estiver interessado em compartilhar seu aplicativo com os membros da equipe, você pode usar o modo de automação autônomo porque ele depende de um token de acesso OAuth compartilhável.

2. Adicione permissões de aplicativos

Adicionar permissões ao seu aplicativo é feito usando escopos. Os escopos definem os métodos de API que esse aplicativo pode chamar e as informações que ele pode acessar no espaço de trabalho em que está instalado. Muitos escopos são restritos a recursos específicos, como canais ou arquivos.

Observação:

Não é necessário adicionar escopos diretamente ao seu aplicativo se você planeja executar apenas a automação assistida. Se você executar automação assistida, selecione seus escopos usando a propriedade Scopes na atividade Slack Scope .

Como definir escopos em seu aplicativo permite automação autônoma e assistida, recomendamos concluir as etapas abaixo antes de começar a usar o pacote de atividades; isso permite que você alterne livremente entre os modos.

Na navegação à esquerda, clique em OAuth e permissões.
Na seção URLs de redirecionamento , clique no botão Adicionar novo URL de redirecionamento e insira seu URL.
- Se você não souber o URL que deve inserir, pode deixá-lo em branco por enquanto.
- Quando você tenta se conectar ao seu aplicativo com a atividade Slack Scope pela primeira vez (usando automação assistida), a atividade abre uma nova página da web que exibe um erro OAuth. Este erro inclui o URL de redirecionamento (ou seja, URI aprovado) que seu espaço de trabalho está usando. Você pode copiar este URL e inseri-lo como seu URL de redirecionamento.
Na seção Escopos , adicione os escopos de permissão que você deseja atribuir ao seu aplicativo e clique no botão Salvar alterações (consulte a lista completa dos Escopos a adicionar na próxima seção).

Escopos a serem adicionados

A seguir estão os escopos necessários para as diferentes atividades do Slack. Também está incluído na tabela o mapeamento de cada escopo para os valores de propriedade Scopes da atividade Slack Scope .

Escopo	Atividade	Propriedade de escopos
channels:write ^{Modifique seus canais públicos}	Criar canal Convidar para o canal Entrar no canal Sair do canal Remover do canal Enviar mensagem	PublicChannels
grupos:escrever ^{Modifique seus canais privados}	Convidar para o canal Sair do canal Remover do canal Enviar mensagem	PrivateChannels
im:escrever ^{Modifique as mensagens diretas do usuário}	Convidar para o canal Sair do canal Remover do canal Enviar mensagem	DirectMessages
mpim:write ^{Fazer alterações nas mensagens de grupo do usuário}	Convidar para o canal Sair do canal Remover do canal Enviar mensagem	GroupMessages
arquivos:escrever:usuário ^{Carregar e modificar arquivos como usuário}	Enviar mensagem	Arquivos
arquivos: ler ^{Acesse os arquivos, comentários e informações associadas do espaço de trabalho}	Download File Enviar mensagem	Arquivos
channels:read ^{Acessar informações sobre o canal público do usuário}	Get Messages	PublicChannels
grupos: ler ^{Acessar informações sobre os canais privados do usuário}	Get Messages	PrivateChannels
im:read ^{Acessar informações sobre as mensagens diretas do usuário}	Get Messages	DirectMessages
mpim:leia ^{Acessar informações sobre as mensagens de grupo do usuário}	Get Messages	GroupMessages
channels:history ^{Acesse os canais públicos do usuário}	Obter respostas	PublicChannels
grupos:história ^{Acesse o conteúdo nos canais privados do usuário}	Obter respostas	PrivateChannels
im:history ^{Acesse o conteúdo nas mensagens diretas do usuário}	Obter respostas	DirectMessages
mpim:história ^{Acesse as mensagens de grupo do usuário}	Obter respostas	GroupMessages
bate-papo:escrever:usuário ^{Enviar mensagens como usuário}	Responder Enviar mensagem	Chat
pesquisar:ler ^{Pesquise o conteúdo do seu espaço de trabalho}	Pesquisar	(incluído com DirectMessages e/ou GroupMessages)
usuários.perfil:escrever ^{Modificar o perfil do usuário}	Atualizar status	Usuários
usuários:ler.email ^{Ver os endereços de e-mail dos membros do workspace}	Convidar para o canal Remover do canal	Usuários
users:read ^{Exibir a lista de membros do workspace e suas informações de contato}	Convidar para o canal Remover do canal	Usuários

Depois de selecionar seus escopos, você estará pronto para instalar seu aplicativo em seu espaço de trabalho seguindo as etapas na próxima seção.

3. Instale seu aplicativo em seu espaço de trabalho

Dependendo de como seu espaço de trabalho é administrado, pode ser necessário solicitar a instalação do aplicativo.

Na seção OAuth Tokens & Redirects URLs , clique no botão Install App to Workspace ou no botão Request to Install .
Após a instalação do aplicativo, um token de acesso OAuth é gerado.
- Semelhante ao Client ID e Client Secret, o OAuth Access Token é usado para fins de autenticação. As diferenças entre os dois se aplicam ao executar seu projeto de automação.
  - Se estiver executando a automação assistida, a atividade Slack Scope precisa de valores nas propriedades ID do cliente, Segredo do clientee Escopos .
  - Se estiver executando automação autônoma, a atividade Slack Scope precisa apenas de um valor na propriedade OAuth Access Token .

4. Crie seu projeto

Crie um novo projeto de automação.
1. Abra o UiPath Studio.
2. Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
3. Insira um Nome, Locale Descriçãodo projeto.
4. Clique em Criar.
Instale o pacote UiPath.Slack.Activities .
1. Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
2. Em Todos os pacotes, clique em Ir!
3. Na barra de pesquisa , digite Slack.
4. Clique, instale e aceite a licença para UiPath.Slack.Activities.
  - Para obter mais informações sobre os pacotes do Uipath Studio, consulte Gerenciando pacotes no Guia do Studio.

Está feito!

Agora que você concluiu a configuração, pode começar a adicionar as atividades do Slack ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte os Guias de início rápido . Esses guias fornecem instruções passo a passo para ajudar você a criar amostras de trabalho das diferentes atividades para que você possa verificar a conexão com seu WorkSpace do Slack e se familiarizar com as propriedades de entrada e saída.

Para saber mais sobre as atividades do Slack (incluindo exemplos de entradas/saídas de propriedades), consulte a página Atividades para obter uma lista completa de atividades e links para as páginas de detalhes das atividades.

Nesta página