UiPath Integrations

The UiPath Integrations Guide

Welcome to the UiPath Integrations guide. You will find comprehensive guides and documentation to help you start working with UiPath Integrations, as well as support if you get stuck.

In order to download the solutions mentioned here please visit the official UiPath Go! Marketplace here.

*Note that only integrations built in-house at UiPath are detailed below. For a complete list of UiPath's technology partners, see here.

Slack Scope

Overview

The SlackScope activity follows the OAuth 2.0 protocol to establish an authenticated connection between UiPath and the Slack API.

Before the Slack Scope activity can establish a connection, it needs authorization to take action on your behalf and access your permitted data. To grant authorization, you create and install a new Slack App to your workspace (no coding required). You don't need to publicly distribute this app via the Slack App Directory, you only need to install it to the workspace that you want to automate.

When creating the app, you assign the scopes (i.e., permissions) to define the API methods the app (and subsequently the activities) can call and the information it can access.

  • For step-by-step instructions on how to add scopes, see Add app permissions in the Setup guide.
  • For a complete list of the scopes required for this activity package, see Scopes to add in the Setup guide.

After registering the app, Slack assigns a unique Client ID (ClientID), Client Secret (ClientSecret), and OAuth Access Token (Token) that you enter in the Slack Scope activity to initiate a connection.

How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

  1. Complete the Setup steps.
  2. Add the Slack Scope activity to your project.
  3. Enter values for the Authentication (Attended), Authentication (Unattended) properties.

Connect and Revoke Token

In the Design Panel, the Slack Scope activity has two buttons: Connect and Revoke Token.

Connect button

The Connect button becomes enabled after the (ClientID and ClientSecret) or the (Token) properties are complete. Before you click the button, you must select the applicable Scopes (for attended automation only).

After you enter your (ClientID, ClientSecret, and Scopes) or (Token), you must click the Connect button to enable the rest of the activities. After the connection is established, this button changes to Refresh.

Revoke Token button

The Revoke Token button becomes enabled after a connection is established and the Connect button has changed to Refresh.

Clicking the Revoke Token button deletes the established connection. After the token is revoked, you must reauthorize the app to access the information you specified with the Scopes property.

Unattended vs. Attended Automation

The Slack Scope activity has two different authentication models depending on the automation mode (unattended or attended).

There are two differences between unattended and attended automation as it pertains to Slack Scope activity: scope setting requirements and allowing access.

Scope setting requirements

As noted in the Add app permissions section of the Setup guide, if you plan to run unattended automation, you must set the scopes using the app's OAuth & Permissions feature settings.

If you want to run attended automation, you don't have to set the scopes using the app's OAuth & Permissions feature settings (you can), rather you set the scopes using the Scopes property (described below).

To enable the best user experience when using the activities, it's recommended that you set the using the app's OAuth & Permissions feature settings (as described in the Setup guide). By setting the scopes ahead a time, you can freely switch between unattended and attended automation when you're building and running your project.

Allowing access

When the Slack Scope activity runs during attended automation, a web page opens that prompts you to grant your app access to your selected scopes by clicking an Allow button (example image below).

During unattended automation, access is silently granted to your app in the background (no user action required).

Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

Common

DisplayName

The display name of the activity.

Attributes
Details

Type

String

Required

Yes

Default value

Slack Scope

Allowed values

Enter a String or String variable.

Notes

N/A


Authentication (Attended)

ClientID

The unique ID assigned to your app by Slack.

Attributes
Details

Type

String

Required

Yes

Default value

Empty

Allowed values

Enter a String value.

Notes

  • This property only accepts the String value of your Client ID. It does not support String variables.
  • To find your Client ID, go to your created app's Basic Information page. Under App Credentials you'll see both your Client ID and Client Secret (image shown below).

ClientSecret

The unique ID associated with your ClientID.

Attributes
Details

Type

String

Required

Yes

Default value

Empty

Allowed values

Enter a String value.

Notes

  • This property only accepts the String value of your Client Secret. It does not support String variables.
  • To find your Client Secret, go to your app's Basic Information page. Under App Credentials you'll see both your Client ID and Client Secret (image shown above).

Scopes

A categorized list of the scopes to grant (or previously granted when following the Setup guide) to the app.

Attributes
Details

Type

Drop-down list

Required

Yes (when running attended automation)

Default value

Not Selected

Allowed values

Select all the applicable scopes. There are 7 scopes:

  • PublicChannels
  • PrivateChannels
  • DirectMessages
  • GroupMessages
  • Users
  • Chat
  • Files

Notes

  • For a complete list of scopes and their mapping to the activities and the allowed values above, see Scopes to add in the Setup guide.

Authentication (Unattended)

Token

The app's OAuth Access Token to use for unattended automation only. Slack automatically generates this token when you install the app to your workspace.

Attributes
Details

Type

String

Required

No (unless you run unattended automation)

Default value

Empty

Allowed values

Enter a String value.

Notes

  • This property only accepts the String value of your OAuth Access Token. It does not support String variables.
  • To get your OAuth Access Token, you must first install the app to your workspace. After installing your app, go to your app's Installed App Settings page (image shown above).

Misc

Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

Attributes
Details

Type

Checkbox

Required

No

Default value

Not Selected

Allowed values

Selected or Not Selected

Notes

N/A


Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the Quickstart guides.

Updated 3 months ago


Slack Scope


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.