Autenticação para o Slack

Conecte o UiPath ao Slack usando o Código de Autorização do OAuth 2.0, um aplicativo OAuth 2.0 personalizado ou um token de acesso à chave de API.

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisará de uma das seguintes credenciais:

• Código de autorização do OAuth 2.0: escopos do usuário, escopos do robô e suas credenciais do Slack.
• Traga seu próprio aplicativo OAuth 2.0: ID do cliente, Segredo do cliente, Escopos de usuários, Escopos de robôs.
• Chave de API: Token de acesso (por exemplo, Token de robô, Token de usuário, etc.). Para mais detalhes, consulte a documentação do Slack.

Para criar um aplicativo OAuth2 privado, siga as etapas descritas na documentação do Slack.

Observação:

Ao registrar seu aplicativo OAuth no Slack, certifique-se de definir o URL de retorno de chamada como o valor exibido na página de criação de conexão, como por exemplo, https://cloud.uipath.com/provisioning_/callback para o Automation Cloud.

Para criar uma conexão, você precisa ser membro ou convidado de um espaço de trabalho do Slack.

Observação:

Se você criar uma conexão usando seu próprio aplicativo OAuth 2.0, há algumas etapas adicionais que você deve seguir ao usar o evento Botão clicado . Consulte Usando o Botão clicado com Trazer sua própria autenticação de aplicativo OAuth 2.0 para obter mais detalhes.

Adicione a conexão para o Slack

Para criar uma conexão com sua instância do Slack, siga as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.

2. Na lista Conectores , selecione Slack. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione o botão Conectar-se ao Slack .

4. Insira as credenciais necessárias para seu método de autenticação preferido. Você pode escolher entre três tipos de autenticação: Código de autorização do OAuth 2.0, Traga seu próprio aplicativo OAuth 2.0 ou Chave de API.

   1. Se você selecionar o método Trazer seu próprio aplicativo OAuth 2.0, insira as credenciais necessárias e selecione Conectar.

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly.

   Para obter mais informações, consulte Usar ativos de credenciais para conexões.

   2. Se você selecionar o método Chave de API, insira a chave de API e selecione Conectar.

      Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly.

      Para obter mais informações, consulte Usar ativos de credenciais para conexões.

   3. Se você selecionar o método de código de autorização padrão OAuth 2.0, continue para a etapa 4.

5. Revise ou altere os escopos do robô e/ou os escopos do usuário de acordo com seus requisitos ou caso de uso. O escopo do bot chat:write é obrigatório e não pode ser removido — removê-lo faz com que a criação da conexão falhe. Todos os outros escopos são opcionais.

6. Select Connect.

7. Selecione o espaço de trabalho correto no canto superior direito da tela. A conexão executa ações apenas para esse espaço de trabalho selecionado e seus respectivos canais.

   

8. Select Allow. With access to your Slack account, UiPath can do the following:

   • Veja o conteúdo e as informações sobre você.
   • Veja conteúdo e informações sobre canais e conversas.
   • Visualize conteúdo e informações sobre seu espaço de trabalho.
   • Execute ações como você.
   • Executar ações em canais e conversas.
   • Execute ações em seu espaço de trabalho.

9. Sua conexão foi adicionada.

Escopos e permissões

Você pode usar a conexão para habilitar as atividades do Slack no UiPath Studio para criar automações para gerenciamento de usuários e canais, mensagens agendadas e outras formas de trabalhar em equipe.

Escopos de bots obrigatórios

O escopo de bot a seguir é obrigatório para todas as conexões do Slack, independentemente do método de autenticação. Removê-la impede que a criação da conexão seja concluída.

Escopo	Finalidade
chat:write	Necessário para publicar a mensagem de confirmação de conexão no seu espaço de trabalho Slack após a criação

Observação:

Remover chat:write dos escopos do robô faz com que a criação da conexão falhe.

HTTP Request activity token selection

The generic HTTP Request activity uses the bot token by default, falling back to the user token if no bot token is present on the connection. This means the activity works on bot-only connections, the same as the curated Slack activities.

Todos os escopos

Use a tabela a seguir para verificar os vários casos de uso baseados em permissão que você pode alcançar usando as atividades do Slack:

Tabela 1. Permissões do Slack necessárias para cada atividade

Escopo/Permissão	Use case	Atividade
chat:write (Token de usuário e de robô)	Envie uma mensagem em um canal como um Bot ou Usuário. Envie uma resposta a uma mensagem no canal como um Bot ou Usuário. Quando um botão for clicado em um canal, envie uma mensagem efêmera ou uma mensagem eu para o usuário.	Enviar mensagem para canal Enviar resposta
chat:write:customize (Apenas para o token do robô)	Envie uma mensagem em um canal ou para um usuário usando um nome e um ícone de robô personalizados.	Enviar mensagem para canal Enviar mensagem para o usuário
chat:write:public (Apenas para o token do robô)	Envie notificações/aplicativos para canais públicos como um robô, mesmo que o robô não seja um membro do canal.	Enviar mensagem para canal
links:write (Tanto do Usuário quanto do Token do Bot)	Envie mensagens com visualização de links, como ticket do Jira, problema do GitHub etc. como um Robô ou Usuário.	Enviar mensagem para canal Enviar mensagem para o usuário
Channels:write (Apenas token de usuário)	Crie canais públicos para diferentes equipes e usuários com base na necessidade/tema/objetivo como usuário. Arquivar dinamicamente ou desarquivar ou fechar o canal/conversa temporária como usuário quando o ticket de suporte for fechado ou reaberto.	Arquivar canal definir tópico do canal
Channels:manage (Apenas para o token de robô)	Crie canais públicos para diferentes equipes e usuários com base na necessidade/tema/objetivo como um bot. Arquivar dinamicamente ou desarquivar ou fechar o canal/conversa temporária como usuário quando o ticket de suporte for fechado ou reaberto.	Criar canal Arquivar canal definir tópico do canal
channels:join (Apenas para o token do robô)	Carregue um arquivo de mídia como uma mensagem do Slack em um canal como um robô primeiro ingressando no canal.	Entrar no canal
Groups:write (Token do Usuário e de Bot)	Crie canais privados para diferentes equipes e usuários com base na necessidade/tópico/objetivo como um robô ou usuário.	Criar canal
im:write (tanto do usuário quanto do token do robô)	Enviar mensagem individual (IM) como um robô ou usuário.	Enviar mensagem ao usuário
mpim:write (Token de usuário e de robô)	Envie uma mensagem em um grupo MPIM como um Bot ou Usuário. Envie uma resposta a uma mensagem no grupo MPIM como um Bot ou Usuário. Abra uma conversa MPIM adicionando vários usuários para enviar mensagens como um Bot ou Usuário.	Enviar mensagem para canal Enviar resposta
channels:read (tanto do usuário quanto do token de bot)	Recupera a lista de canais públicos do espaço de trabalho conectado para enviar mensagens ou gerenciar usuários como um Robô ou Usuário. Leia as informações do canal público como um Bot ou Usuário para enviar mensagens ou gerenciar usuários.	Enviar mensagem para o canal Enviar mensagem para o usuário Enviar arquivo para o canal Enviar resposta Convidar usuários para o canal Remover usuário do canal Listar todos os canais Obter informações do canal Listar todos os membros do canal
Groups:read (Token do Usuário e do Bot)	Recupera a lista de canais privados do espaço de trabalho conectado para enviar mensagens ou gerenciar usuários como um Bot ou Usuário. Leia as informações do canal privado como um Bot ou Usuário para enviar mensagens ou gerenciar usuários.	Enviar mensagem para o canal Enviar mensagem para o usuário Enviar arquivo para o canal Enviar resposta Convidar usuários para o canal Remover usuário do canal Listar todos os canais Obter informações do canal Listar todos os membros do canal
im:read (tanto do usuário quanto do token de bot)	Recupera a lista de conversas de IM do espaço de trabalho conectado para enviar mensagens como um Bot ou Usuário. Recupera a lista de conversas de IM das quais o usuário faz parte.	Listar todos os canais Obter informações do canal
mpim:read (Token do usuário e de bot)	Recupere a lista de grupos MPIM do espaço de trabalho conectado para enviar mensagens como um Bot ou Usuário. Recupere a lista de conversas MPIM da qual o usuário faz parte.	Listar todos os canais Obter informações do canal
files:read (Apenas para o token de Bot)	Recuperar as informações do arquivo, como URL público, e baixar arquivos importantes, como resultados trimestres, de um URL por meio de uma mensagem do Slack como um Robô ou Usuário.	Get File Info
files:write (Token do usuário e de robô)	Notificar todos os usuários de um grupo de usuários sobre uma atualização importante. Por exemplo, notificando como um Bot ou Usuário, os resultados de vendas trimestrais para todo o grupo da equipe de Vendas/Marketing. Carregue um arquivo de mídia como uma mensagem do Slack em um canal como um Bot ou Usuário.	Enviar arquivo para o canal
usergroups:read (Apenas token de usuário)	Recupere a lista de usuários em um grupo de usuários para atualizar ou adicionar usuários como Robô ou Usuário.	Listar todos os grupos de usuários
usergroups:write (Somente token de usuário)	Crie um grupo de usuários para vários canais como um Bot ou Usuário. Adicione usuários a um grupo de usuários existente como um Bot ou Usuário sempre que um novo usuário for adicionado a um canal. Habilite ou desabilite dinamicamente o grupo de usuários para o canal temporário sempre que o canal temporário for arquivado/desarquivado.	Criar grupo de usuários Adicionar usuários ao grupo de usuários
users:read (Token do usuário e de bot)	Recupere a lista de usuários do espaço de trabalho conectado como um Robô ou Usuário para enviar mensagens.	Listar todos os usuários Convidar usuários para o canal Remover usuário do canal Enviar mensagem para o usuário
users:read.email (Token de usuário e de robô)	Leia as informações do usuário, como nome, e-mail etc. como um Robô ou Usuário para enviar notificações.	Obter usuário por email
Reações:read (apenas token de bot)	Ouça a eventos de reação em mensagens nos canais aos quais o aplicativo tem acesso. Necessário ao usar o gatilho Reação adicionada com autenticação de aplicativo próprio OAuth 2.0.	Reação adicionada