Token da API¶
Para poder acessar o token da API do Slack e usar os recursos deste plugin, você deve primeiro criar um aplicativo na área de trabalho desejada, conforme mostra as etapas abaixo:
Configurando um aplicativo Slack¶
1. Crie aplicativo¶
A primeira etapa é criar um aplicativo Slack através deste link.
Ao selecionar a opção Criar nova aplicativo, você será solicitado a fornecer um nome para o novo aplicativo e um espaço de trabalho para vincular a ele, como abaixo.
2. Adicione escopos no aplicativo¶
O segundo passo é adicionar escopos ao aplicativo.
Os escopos dão permissão ao seu aplicativo para fazer as coisas (por exemplo, postar mensagens) no Slack. Eles são um componente essencial de qualquer aplicativo funcional do Slack.
Para escolher os escopos a serem adicionados ao seu aplicativo:
- Vá para a página de configuração do aplicativo.
- Navegue até a página OAuth & Permissões.
- Role para baixo até a seção Escopos de token de bot.
- Clique em Adicionar um escopo OAuth.
- Adicione os escopos.
Veja abaixo os escopos necessários para cada método e observe que eles são os mesmos adicionados acima:
| Method | Required |
|---|---|
enviar mensagem |
chat:write, users:read |
Enviar mensagem simples |
chat:write, users:read |
Atualizar mensagem |
chat:write, users:read |
excluir mensagem |
chat:write, users:read |
carregar arquivo |
files:write |
excluir arquivo |
files:write |
Atenção
Em alguns casos, dependendo das suas permissões de espaço de trabalho, você precisará adicionar outros escopos. Mas não se preocupe, a API responderá com os escopos necessários para a interação.
3. Permissão de espaço de trabalho¶
A terceira etapa é instalar tokens OAuth em seu espaço de trabalho e permitir que os escopos sejam usados no seu aplicativo.
Ainda na página OAuth & Permissões, role até os tokens OAuth para o seu espaço de trabalho e clique em "Reinstalar no espaço de trabalho", veja isso abaixo:
Após esse procedimento, o Slack pede permissão para acessar sua área de trabalho, permitindo que você use os escopos que você adicionou anteriormente.
4. Pegue seu token de acesso¶
Ao finalizar as permissões, o Slack retorna automaticamente à página OAuth & Permissões, e agora é possível visualizar e usar seu token:
5. Vincule o aplicativo ao canal¶
Agora, com o aplicativo criado e o token em mãos, basta vincular o aplicativo ao canal com o qual deseja interagir, como abaixo:
Usando seu novo aplicativo¶
Copie seu token da etapa 4 acima e use-o como um parâmetro no BotPluginSlack.