Para habilitar notificações do Canvas para todos os usuários em um espaço de trabalho do Slack, um usuário com direitos de administrador do Slack deve criar e instalar o aplicativo Slack para criar um Token de Acesso do Bot. Depois que o bot é criado e verificado, os usuários individuais do Canvas podem habilitar o Slack como um método de contato do Canvas para receber notificações.
Nota: As contas do consórcio secundário não podem gerenciar as configurações do Slack.
Abrir os aplicativos do Slack
Abra api.slack.com/apps no seu navegador de internet.
Se necessário, faça login em sua conta do Slack.
Criar novo aplicativo Slack
Clique no botão Criar novo aplicativo (Create New App) [1].
Dê um nome ao aplicativo no campo Nome do aplicativo (App Name) [2]. O nome do aplicativo será exibido para os usuários no espaço de trabalho do Slack.
Selecione o espaço de trabalho da sua instituição ou o espaço de trabalho ao qual o aplicativo deve pertencer na lista suspensa Espaço de trabalho de desenvolvimento do Slack (Development Slack Workspace) [3].
Para criar o aplicativo, clique no botão Criar aplicativo (Create App) [4].
Adicionar escopo OAuth
Abra a página OAuth e permissões (OAuth & Permissions) [1].
Na seção Escopos (Scopes) [2], clique no botão Adicionar um escopo OAuth (Add an OAuth Scope) [3].
Selecionar escopos
Clique no menu suspenso Adicionar permissão por escopo ou método de API (Add permission by Scope or API method) [1] e selecione as seguintes opções de escopo OAuth:
- canais:gerenciar (channels:manage) [2]: Gerenciar canais públicos aos quais seu aplicativo Slack foi adicionado e criar novos
- chat:escrever (chat:write) [3]: Enviar mensagens como seu aplicativo Slack
- grupos:escrever (groups:write) [4]: Gerenciar canais privados aos quais seu aplicativo Slack foi adicionado e criar novos
- im:escrever (im:write) [5]: Começar mensagens diretas com as pessoas
- mpim:escrever (mpim:write) [6]: Começar mensagens diretas em grupo com as pessoas
- usuários:ler (users:read) [7]: Ver as pessoas na área de trabalho
- usuários:ler.e-mail (users:read.email) [8]: Ver endereços de e-mail de pessoas na área de trabalho
Instalar aplicativo
Para salvar e instalar o aplicativo, clique no botão Instalar aplicativo no espaço de trabalho (Install App to Workspace).
Permitir acesso ao espaço de trabalho do aplicativo
Uma mensagem é exibida solicitando permissão para o aplicativo acessar o espaço de trabalho do Slack.
Clique no botão Permitir (Allow).
Copiar o token de acesso do Slack Bot
Depois que o aplicativo for criado no Slack, clique no link Instalar aplicativo (Install App) [1].
Localize o token de acesso OAuth do usuário do bot e clique no botão Copiar (Copy) [2].
Adicionar token da API Slack
Na página Configurações da Conta no Canvas, localize a seção Slack API Token e cole o token copiado no campo Nova chave API do Slack API (New Slack API Key) [1].
Para salvar, clique no botão Atualizar configurações (Update Settings) [2].
Nota: Se o título Chave API do Slack não for exibido, atualize a janela do navegador.
Criar método de contato
Na página de configurações do usuário, clique no link Adicionar método de contato (Add Contact Method) [1].
Clique na guia E-mail do Slack (Slack Email) [2] e insira o endereço de e-mail de sua conta do Slack no campo E-mail do Slack (Slack Email) [3].
Em seguida, clique no botão Registrar e-mail do Slack (Register Slack Email) [4].
Confirmar canal de comunicação
No Slack, procure uma notificação enviada ao aplicativo Slack recém-criado com um código de registro do Canvas de quatro dígitos [1].
No Canvas, insira o código de quatro dígitos no campo Confirmar canal de comunicação (Confirm Communication Channel) [2]. Em seguida, clique no botão Confirmar (Confirm) [3].
Depois de confirmado, todos os usuários em sua conta do Slack podem adicionar o método de contato Slack Email e gerenciar suas configurações de notificação do Slack na página Configurações do Usuário.
