Pour activer les notifications de Canvas pour tous les utilisateurs d'un espace de travail Slack, un utilisateur disposant des droits d'administrateur de Slack doit créer et installer l'application Slack pour créer un jeton d'accès de bot. Une fois le bot créé et vérifié, les utilisateurs individuels de Canvas peuvent activer Slack comme méthode de contact de Canvas pour recevoir des notifications.
Remarque : Les comptes de consortium enfants ne peuvent pas gérer les paramètres Slack.
Ouvrir les applications Slack
Ouvrez api.slack.com/apps dans votre navigateur Internet.
Si nécessaire, connectez-vous à votre compte Slack.
Créer une nouvelle application Slack
Cliquez sur le bouton Créer une nouvelle application (Create New App) [1].
Donnez un nom à l'application dans le champ Nom de l'application (App Name) [2]. Le nom de l'application s'affichera pour les utilisateurs dans l'espace de travail Slack.
Sélectionnez l'espace de travail de votre institution ou l'espace de travail auquel l'application doit appartenir dans le menu déroulant Espace de travail Slack de développement (Development Slack Workspace) [3].
Pour créer l'application, cliquez sur le bouton Créer une application (Create App) [4].
Ajouter une portée OAuth
Ouvrez la page OAuth et autorisations (Oauth & Permissions) [1].
Dans la section Portées (Scopes) [2], cliquez sur le bouton Ajouter une portée Oauth (Add an OAuth Scope) [3].
Sélectionner des portées
Cliquez sur le menu déroulant Ajouter une autorisation par portée ou par méthode API (Add permission by Scope or API method) [1] et sélectionnez les options de portée OAuth suivantes :
- channels:manage [2]: pour gérer les chaînes publiques auxquelles votre application Slack a été ajoutée et en créer de nouvelles
- chat:write [3]: pour envoyer des messages en tant que votre application Slack
- groups:write [4]: pour gérer les canaux privés auxquels votre application Slack a été ajoutée et en créer de nouveaux
- im:write [5]: pour démarrer des messages directs avec des personnes
- mpim:write [6]: pour démarrer des messages directs de groupe avec des personnes
- users:read [7]: pour afficher les personnes dans l'espace de travail
- users:read.email [8]: pour afficher les adresses e-mail des personnes dans l'espace de travail
Installer l'application
Pour enregistrer et installer l'application, cliquez sur le bouton Installer l'application dans l'espace de travail (Install App to Workspace).
Autoriser l'application à accéder l'espace de travail
Un message s'affiche demandant l'autorisation pour l'application d'accéder à l'espace de travail de Slack.
Cliquez sur le bouton Autoriser (Allow).
Copier le jeton d'accès de bot de Slack
Une fois l'application créée dans Slack, cliquez sur le lien Installer l'application (Install App) [1].
Localisez le jeton d'accès OAuth de l'utilisateur du bot et cliquez sur le bouton Copie (Copy) [2].
Ajouter un jeton de l'API Slack
Sur la page Paramètres du compte dans Canvas, localisez la section Jeton de l'API Slack et collez le jeton copié dans le champ Nouvelle clé de l'API Slack [1].
Pour l'enregistrer, cliquez sur le bouton Mettre à jour les paramètres (Update Settings) [2].
Remarque : Si l'en-tête de la clé de l'API Slack ne s'affiche pas, actualisez la fenêtre de votre navigateur.
Créer une méthode de contact
Dans la page de vos paramètres utilisateur, cliquez sur le lien Ajouter une méthode de contact (Add Contact Method) [1].
Cliquez sur l'onglet E-mail de Slack (Slack Email) [2] et saisissez l'adresse e-mail de votre compte Slack dans le champ E-mail de Slack (Slack Email) [3].
Ensuite, cliquez sur le bouton Enregistrer l'e-mail de Slack (Register Slack Email) [4].
Confirmer le canal de communication
Dans Slack, recherchez une notification envoyée à l'application Slack nouvellement créée avec un code d'enregistrement de Canvas à quatre chiffres [1].
Dans Canvas, saisissez le code à quatre chiffres dans le champ Confirmer le canal de communication (Confirm Communication Channel) [2]. Cliquez ensuite sur le bouton Confirmer (Confirm) [3].
Une fois le canal confirmé, tous les utilisateurs de votre compte Slack peuvent ajouter la méthode de contact E-mail de Slack (Slack Email) et gérer leurs paramètres de notification de Slack dans la page Paramètres de l'utilisateur (User Settings).
