Um Canvas-Benachrichtigungen für alle Benutzer*innen in einem Slack-Arbeitsbereich zu aktivieren, muss ein/e Benutzer*in mit Slack-Admin-Rechten die Slack-App erstellen und installieren, um ein Bot-Zugangs-Token zu erstellen. Nachdem der Bot erstellt und verifiziert wurde, können einzelne Benutzer*innen Slack als Canvas-Kontaktmethode aktivieren, um Benachrichtigungen zu erhalten.
Hinweis: Untergeordnete Konsortialkonten können keine Slack-Einstellungen verwalten.
Slack-Apps öffnen
Öffnen Sie api.slack.com/apps in Ihrem Internetbrowser.
Melden Sie sich ggf. bei Ihrem Slack-Konto an.
Neue Slack-App erstellen
Klicken Sie auf die Schaltfläche Create New App (Neue App erstellen) [1].
Geben Sie der App einen Namen im Feld App Name (App-Name) [2]. Der App-Name wird den Benutzer*innen im Slack-Arbeitsbereich angezeigt.
Wählen Sie den Arbeitsbereich Ihrer Institution oder den Arbeitsbereich, zu dem die App gehören soll, in der Dropdown-Liste Development Slack Workspace (Slack-Arbeitsbereich entwickeln) [3].
Um die App zu erstellen, klicken Sie auf die Schaltfläche Create App (App erstellen) [4].
OAuth-Bereich hinzufügen
Öffnen Sie die Seite OAuth & Permissions (Oauth & Berechtigungen) [1].
Klicken Sie im Abschnitt Scopes (Geltungsbereiche) [2] auf die Schaltfläche Add an OAuth Scope (OAuth-Geltungsbereich hinzufügen) [3].
Geltungsbereich auswählen
Klicken Sie auf das Dropdown-Menü Add permission by Scope or API method (Berechtigung nach Bereich oder API-Methode hinzufügen) [1] und wählen Sie die folgenden OAuth-Bereichsoptionen:
- channels:manage [2]: Verwalten Sie öffentliche Kanäle, denen Ihre Slack-App hinzugefügt wurde, und erstellen Sie neue Kanäle
- chat:write [3]: Senden Sie Nachrichten als Ihre Slack-App
- groups:write [4]: Verwalten Sie private Kanäle, denen Ihre Slack-App hinzugefügt wurde, und erstellen Sie neue.
- im:write [5]: Starten Sie direkte Nachrichten mit Personen
- mpim:write [6]: Starten Sie direkte Gruppenachrichten mit Personen
- users:read [7]: Personen im Arbeitsbereich anzeigen
- users:read.email [8]: E-Mail-Adressen von Personen im Arbeitsbereich anzeigen
App installieren
Um die App zu speichern und zu installieren, klicken Sie auf die Schaltfläche Install App to Workspace (App im Arbeitsbereich installieren).
App-Zugriff auf Arbeitsbereich zulassen
Es wird eine Meldung angezeigt, in der Sie um die Erlaubnis gebeten werden, dass die App auf den Slack-Arbeitsbereich zugreifen darf.
Klicken Sie auf die Schaltfläche Allow (Zulassen).
Slack Bot-Zugangs-Token kopieren
Sobald die App in Slack erstellt wurde, klicken Sie auf den Link Install All (App installieren) [1].
Suchen Sie das Bot User OAuth Access Token und klicken Sie auf die Schaltfläche Copy (Kopieren) [2].
Slack-API-Token hinzufügen
Suchen Sie auf der Seite Kontoeinstellungen in Canvas den Abschnitt Slack-API-Token und fügen Sie das kopierte Token in das Feld New Slack API Key (Neuer Slack API-Schlüssel) ein [1].
Zum Speichern klicken Sie auf die Schaltfläche Update Settings (Einstellungen aktualisieren) [2].
Hinweis: Wenn die Überschrift Slack API-Schlüssel nicht angezeigt wird, aktualisieren Sie Ihr Browserfenster.
Kontaktmethode erstellen
Klicken Sie auf Ihrer Seite „Benutzereinstellungen“ auf den Link Add Contact Method (Kontaktmethode hinzufügen) [1].
Klicken Sie auf die Registerkarte Slack Email (Slack-E-Mail) [2] und geben Sie die E-Mail-Adresse Ihres Slack-Kontos in das Feld Slack Email (Slack E-Mail) [3] ein.
Klicken Sie dann auf die Schaltfläche Register Slack Email (Slack-E-Mail registrieren) [4].
Kommunikationskanal bestätigen
Achten Sie in Slack auf eine Benachrichtigung, die an die neu erstellte Slack-App mit einem vierstelligen Canvas-Registrierungscode [1] gesendet wird.
Geben Sie in Canvas den vierstelligen Code in das Feld Confirm Communication Channel (Kommunikationskanal bestätigen) [2] ein. Klicken Sie dann auf die Schaltfläche Confirm (Bestätigen) [3].
Nach der Bestätigung können alle Benutzer*in Ihres Slack-Kontos die Kontaktmethode „Slack-E-Mail hinzufügen“ und ihre Slack-Benachrichtigungseinstellungen auf der Seite Benutzereinstellungen verwalten.
