For at aktivere Canvas-meddelelser for alle brugere i et Slack-arbejdsområde skal en bruger med Slack-administratorrettigheder oprette og installere Slack-appen for at oprette et bot-adgangs-token. Når botten er blevet oprettet og verificeret, kan individuelle Canvas-brugere aktivere Slack som en Canvas-kontaktmetode til at modtage meddelelser.
Bemærk: Underkonsortiumkonti kan ikke administrere Slack-indstillinger.
Åbn Slack-apps
Åbn api.slack.com/apps i din internetbrowser.
Log om nødvendigt ind på din Slack-konto.
Opret ny Slack-app
Klik på knappen Opret ny app (Create New App) [1].
Giv appen et navn i feltet App-navn (App Name) [2]. Appens navn vises til brugere i Slack-arbejdsområdet.
Vælg din institutions arbejdsområde eller det arbejdsområde, appen skal tilhøre i rullemenuen Udvikling Slack-arbejdsområde (Development Slack Workspace) [3].
For at oprette appen skal du klikke på knappen Opret app (Create App) [4].
Tilføj OAuth-omfang
Åbn siden OAuth og tilladelser (Oauth & Permissions) 1].
I sektionen Anvendelsesområder (Scope) [2] skal du klikke på knappen Tilføj et OAuth-anvendelsesområde (Add an OAuth Scope) [3].
Vælg anvendelsesområde
Klik på rullemenuen Tilføj tilladelse fra Scope eller API-metode (Add permission by Scope or API method) [1], og vælg følgende muligheder for OAuth-anvendelsesområder:
- channels:manage [2]: Administrer offentlige kanaler, som din Slack-app er blevet tilføjet til, og opret nye
- chat:write [3]: Send beskeder som din Slack-app
- groups:write [4]: Administrer private kanaler, som din Slack-app er blevet tilføjet til, og opret nye
- im:write [5]: Begynd at skrive direkte beskeder til andre
- mpim:write [6]: Start direkte gruppebeskeder med andre
- users:read [7]: Se personer i arbejdsområdet
- users:read.email [8]: Se e-mailadresser på personer i arbejdsområdet
Installer app
For at gemme og installere appen skal du klikke på knappen Installer app i arbejdsområdet (Install App to Workspace).
Tillad adgang til app-arbejdsområde
Der vises en besked, som anmoder om tilladelse til, at appen får adgang til Slack-arbejdsområdet.
Klik på knappen Tillad (Allow).
Kopier Slack-bot adgangs-token
Når appen er blevet oprettet i Slack, skal du klikke på linket Installer app (Install App) [1].
Find bot-bruger OAuth-adgangs-tokenet, og klik på knappen Kopier (Copy) [2].
Tilføj Slack API-token
På siden Kontoindstillinger i Canvas skal du finde afsnittet Slack API Token og indsætte det kopierede token i feltet Ny Slack API-nøgle (New Slack API Key) [1].
For at gemme skal du klikke på knappen Opdater indstillinger (Update Settings) [2].
Bemærk: Hvis Slack API-nøgle-overskriften ikke vises, skal du opdatere dit browservindue.
Opret kontaktmetode
På siden med brugerindstillinger skal du klikke på linket Tilføj kontaktmetode (Add Contact Method) [1].
Klik på fanebladet Slack e-mail (Slack Email) [2], og indtast e-mailadressen på din Slack-konto i feltet Slack e-mail (Slack Email) [3].
Klik derefter på knappen Registrer Slack e-mail (Register Slack Email) [4].
Bekræft kommunikationskanal
I Slack finder du en meddelelse sendt til den nyoprettede Slack-app med en firecifret Canvas-registreringskode [1].
I Canvas skal du indtaste den firecifrede kode i feltet Bekræft kommunikationskanal (Confirm Communication Channel) [2]. Klik derefter på knappen Bekræft (Confirm) [3].
Når bekræftet, kan alle brugere på din Slack-konto tilføje Slack e-mail-kontaktmetoden og administrere deres Slack-meddelelsesindstillinger på siden Brugerindstillinger.
