Configuração

Introdução

Para habilitar as atividades do Slack, você deve inserir detalhes de autenticação na atividade Slack Scope . Esses detalhes de autenticação dão a um Robô a capacidade de agir 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:

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

After creating your app, Slack assigns it a unique Client ID, Client Secret (i.e. app credentials), and an OAuth Access Token (for unattended automation) that you'll enter in the Slack Scope activity's authentication properties.

Etapas

Before using the Slack activities, follow the steps below to generate or collect the required input data for the Slack Scope activity.

1. Crie um aplicativo Slack

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

1. Faça login no seu espaço de trabalho do Slack ou abra o aplicativo de desktop do Slack.

   • Se você fazer login usando o URL acima, você precisará do URL do Slack do seu espaço de trabalho.

2. Acesse Seus Apps e clique no botão Criar novo aplicativo.

   

3. Enter your App Name, select the Development Slack Workspace and click the Create App button.

   

After you create your app, you're taken to the Basic Information page. This is where you can find the Client ID and Client Secret that you'll need for attended automation authentication in the Slack Scope activity.

Before you copy and paste these into your activity, you should configure the OAuth & Permissions features by following the steps in the next section.

Observação:

Embora você seja tecnicamente possível, não é recomendável porque você precisaria compartilhar seu Segredo do Cliente com eles. Se você estiver interessado em compartilhar seu aplicativo com membros da equipe, poderá usar o modo de automação unattended, porque ele depende de um Token de Acesso OAuth compartilhável.

2. Adicione permissões de aplicativos

A adição de permissões ao seu aplicativo é feita usando escopos. Os escopos definem os métodos de API que este app 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 attended. Se você executar a automação Attended, selecione seus escopos usando a propriedade Escopos na atividade Slack Scope . Como a configuração de escopos no seu aplicativo permite tanto a automação unattended quanto a attended, recomendamos concluir as etapas abaixo antes de começar a usar o pacote de atividades; isso permite que você alterne livremente entre os modos.

1. In the left-hand navigation, click the OAuth & Permissions.

2. In the Redirect URLs section, click the Add New Redirect URL button and enter your URL.

   • Se você não souber o URL que deve inserir, pode deixá-lo em branco por enquanto.

   • When you try connecting to your app with the Slack Scope activity for the first time (using attended automation) the activity opens a new web page that displays an OAuth Error. This error includes the redirect URL (i.e., Passed URI) that your workspace is using. You can copy this URL and enter it as your Redirect URL .

     

3. 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

The following are the scopes required for the different Slack activities. Also included in the table is each scope's mapping to to the Scopes property values from the Slack Scope activity.

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.

1. In the OAuth Tokens & Redirects URLs section, click the Install App to Workspace button or Request to Install button.

   

2. After the app is installed, an OAuth Access Token is generated.

   • Similar to the Client ID and Client Secret, the OAuth Access Token is used for authentication purposes. The differences between the two become applicable when run your automation project.

     • If running attended automation, the Slack Scope activity needs values in the Client ID, Client Secret, Scopes properites.

     • If running unattended automation, the Slack Scope activity only needs a value in the OAuth Access Token property.

       

4. Crie seu projeto

1. Crie um novo projeto de automação.

   1. Abra o UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Clique em Criar.

      

2. Install the UiPath.Slack.Activities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. In the Search bar, enter Slack.
   4. Click, install, and accept the license for the UiPath.Slack.Activities.

      • Para obter mais informações sobre os pacotes do Uipath Studio, consulte o Gerenciamento de 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 obter uma experiência prática de aprendizado e começar rapidamente a usar as atividades, 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 espaço de trabalho do Slack e se familiarizar com as propriedades de entrada/saída.

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