Einrichten

Einleitung

Um die Slack-Aktivitäten zu aktivieren, müssen Sie Authentifizierungsdetails in die Aktivität Slack Scope eingeben. Diese Authentifizierungsdetails geben einem Roboter die Möglichkeit, in Ihrem Namen aktiv zu werden und auf Ihre erlaubten Daten zuzugreifen.

Führen Sie die folgenden Schritte aus, um die Authentifizierungsdetails zu generieren und zu gewähren und mit der Erstellung Ihres Automatisierungsprojekts zu beginnen:

1. Neue Slack-App erstellen (keine Programmierung erforderlich)
2. App-Berechtigungen hinzufügen
3. Installieren Sie Ihre App in Ihrem Workspace
4. Erstellen Sie Ihr Projekt

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.

Schritte

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

1. Erstellen Sie eine Slack-App

Um die Slack-Aktivitäten zu verwenden, können Sie eine einfache App mit einem Arbeitsbereich erstellen. Bei den folgenden Schritten und dem Beispiel wird davon ausgegangen, dass Sie über einen vorhandenen Arbeitsbereich verfügen und diesem angehören.

1. Melden Sie sich bei Ihrem Slack-Arbeitsbereich an oder öffnen Sie die Slack-Desktopanwendung.

   • Wenn Sie sich mit der obigen URL anmelden, benötigen Sie die Slack-URL Ihres Arbeitsbereichs.

2. Wechseln Sie zu Ihre Apps und klicken Sie auf die Schaltfläche Neue App erstellen .

   

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.

Hinweis:

Obwohl Sie technisch können, wird es nicht empfohlen, da Sie Ihren geheimen Clientschlüssel mit ihnen teilen müssten. Wenn Sie Ihre App für Teammitglieder freigeben möchten, können Sie den unbeaufsichtigten Automatisierungsmodus verwenden, da er auf einem gemeinsam nutzbaren OAuth-Zugriffstoken basiert.

2. App-Berechtigungen hinzufügen

Das Hinzufügen von Berechtigungen zu Ihrer App erfolgt mithilfe von Scopes. Scopes definieren die API-Methoden, die diese App aufrufen kann, und die Informationen, auf die sie im Arbeitsbereich, auf dem sie installiert ist, zugreifen kann. Viele Scopes sind auf bestimmte Ressourcen wie Kanäle oder Dateien beschränkt.

Hinweis:

Das direkte Hinzufügen von Scopes zu Ihrer App ist nicht erforderlich, wenn Sie nur die Attended-Automatisierung ausführen möchten. Wenn Sie eine Attended-Automatisierung ausführen, wählen Sie Ihre Scopes mit der Eigenschaft „Scopes“ in der Aktivität Slack Scope aus. Da das Festlegen von Scopes in Ihrer App sowohl eine unbeaufsichtigte als auch eine beaufsichtigte Automatisierung ermöglicht, empfehlen wir, die folgenden Schritte auszuführen, bevor Sie mit der Verwendung des Aktivitätspakets beginnen; Auf diese Weise können Sie frei zwischen den Modi wechseln.

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.

   • Wenn Sie die URL, die Sie eingeben sollten, nicht kennen, können Sie sie vorerst leer lassen.

   • 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. Fügen Sie im Abschnitt Scopes die Berechtigungs-Scopes hinzu, die Sie Ihrer App zuweisen möchten, und klicken Sie auf die Schaltfläche Änderungen speichern (siehe die vollständige Liste der hinzuzufügenden Scopes im nächsten Abschnitt).

   

Scopes, die hinzugefügt werden sollen

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.

Umfang	Aktivität	Scopes-Eigenschaft
channels:write Ändern Sie Ihre öffentlichen Kanäle	Create Channel Invite to Channel Join Channel Leave Channel Remove from Channel Send Message	PublicChannels
Gruppen:schreiben Ändern Sie Ihre privaten Kanäle	Invite to Channel Leave Channel Remove from Channel Send Message	PrivateChannels
im:write Direktnachrichten des Benutzers ändern	Invite to Channel Leave Channel Remove from Channel Send Message	DirectMessages
mpim:write Gruppennachrichten des Benutzers ändern	Invite to Channel Leave Channel Remove from Channel Send Message	GroupMessages
Dateien:write:user Dateien als Benutzer hochladen und ändern	Send Message	Dateien
Dateien:lesen Auf die Dateien, Kommentare und zugehörigen Informationen des Arbeitsbereichs zugreifen	Download File Send Message	Dateien
channels:read Zugriff auf Informationen über den öffentlichen Kanal des Benutzers	Get Messages	PublicChannels
Gruppen:lesen Zugriff auf Informationen über die privaten Kanäle des Benutzers	Get Messages	PrivateChannels
im:read Zugriff auf Informationen über Direktnachrichten des Benutzers	Get Messages	DirectMessages
mpim:read Zugriff auf Informationen zu Gruppennachrichten des Benutzers	Get Messages	GroupMessages
channels:history Auf öffentliche Kanäle des Benutzers zugreifen	Get Replies	PublicChannels
Gruppen:Verlauf Auf Inhalte in den privaten Kanälen des Benutzers zugreifen	Get Replies	PrivateChannels
im:history Auf Inhalte in den Direktnachrichten des Benutzers zugreifen	Get Replies	DirectMessages
mpim:history Auf Gruppennachrichten des Benutzers zugreifen	Get Replies	GroupMessages
chat:write:user Nachrichten als Benutzer senden	Reply Send Message	Chat
Suche:lesen Inhalt Ihres Arbeitsbereichs durchsuchen	Suche	(enthalten in DirectMessages und/oder GroupMessages)
users.profile:write Benutzerprofil ändern	Update Status	Benutzer
Benutzer:read.email E-Mail-Adressen der Workspace-Mitglieder anzeigen	Invite to Channel Remove from Channel	Benutzer
users:read Liste der Mitglieder des Arbeitsbereichs und deren Kontaktinformationen anzeigen	Invite to Channel Remove from Channel	Benutzer

Nachdem Sie Ihre Scopes ausgewählt haben, können Sie Ihre App in Ihrem Arbeitsbereich installieren, indem Sie die Schritte im nächsten Abschnitt ausführen.

3. Installieren Sie Ihre App in Ihrem Workspace

Je nachdem, wie Ihr Arbeitsbereich verwaltet wird, müssen Sie möglicherweise die Installation der App anfordern.

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. Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.

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

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

   4. Klicken Sie auf Erstellen (Create).

      

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.

      • Weitere Informationen zu UiPath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

        

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit dem Hinzufügen der Slack-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Eine praxisnahe Lernerfahrung und eine schnelle Verwendung der Aktivitäten finden Sie in den Schnellstartanleitungen . Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, mit denen Sie funktionierende Beispiele für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung zu Ihrem Slack-Arbeitsbereich überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu den Slack-Aktivitäten (einschließlich Beispiele für die Ein- und Ausgabe von Eigenschaften), finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Seiten mit Aktivitätsdetails.