Integração Slack
Passo a Passo:
1 - Criação do Bot/App:
Acessar: https://api.slack.com/apps, criar um novo app em "Create New App" e depois clicar em "From Scratch"
Nomear o bot que será responsável por envio de mensagens em "App Name" e após isso selecionar o Workspace desejado.
Lembrando que: O termo WorkSpace refere-se ao "servidor" ou "canal principal" onde todos os usuários/canais ficam.
Após isso clique em "Create App".
2 - Token do Bot/App
Você deverá ser redirecionado para a tela de configurações do seu App/Bot https://api.slack/apps/{ID} onde "ID" seria o "ID" do seu Bot porém, se não for basta acessar a URL https://api.slack.com/apps que o seu bot deverá aparecer em "Your Apps".
Agora, no canto esquerdo, no módulo "Features" clique em "OAuth & Permissions".
Após o clique já deve aparecer de imediato o seu token do bot, esse token é o responsável para fazermos a integração com o Workspace do seu time do Slack. Com ele teremos acessos aos canais, usuários e tudo mais. O formato do token do slack é "xoxb-XXXXX-XXXXX-XXXXXXXXXXXX".
3 - Configurações Necessárias
Com o token em mãos agora nós temos que configurar as permissões do nosso bot no nosso WorkSpace.
No mesmo módulo "OAuth & Permissions" navegue para baixo até achar "Scopes".
Atenção aqui, pois temos que adicionar os escopos em "Bot Token Scopes" e não no "User Token Scopes"
Adicione os módulos:
channels:join
channels:manage
channels:read
chat:write
emoji:read
groups:write
im:write
mpim:write
users:read
users:read.email
Com isso o Slack irá perguntar à você que para aplicar as alterações o app deve ser reiniciado, apenas clique em "Reiniciar".
Pronto, configuramos todas as regras necessárias para nossa integração.
4 - Criação de Uma Nova Ação Slack:
Agora é possível enviar mensagens pelo slack, através do código obtido conforme tópico 2.
Para configurar corretamente, deve-se entrar em Workflow > Meus Fluxos.
Em tipo de ação, agora estão disponíveis 3 opções: Enviar Slack para Responsável, Canal ou Usuário.
Para tarefas em que existam mais de um usuário responsável, a mensagem será enviada para todos os responsáveis da lista.
Só serão enviadas mensagens para usuários cujo e-mail estejam cadastrados e atribuídos ao workspace configurado nos passos anteriores.
Ao adicionar canais, também é necessária a criação de novos BOTS. Para criar um novo bot, clicar no ícone dos usuários (canto direito superior conforme imagem abaixo):
Após, vá até a aba “Integrações”:
E por fim, clique em “Adicionar um App”:
5 - Criação de Novos Gatilhos
Criados 4 novos gatilhos focados em plano de ação e tarefas, ambos para quando as tarefas são criadas e/ou finalizadas.