Slack
O broker do Slack segue o padrão de cadastrar webhook para recebimento de mensagens e receber um link para envio de mensagens. A API do slack fornece certos identificadores para o cadastro do broken, como id da conta, token, signing secret e oath do usuário.
1. Criar uma conta
Através do link abaixo, se inscreva no Slack API
2. Criar um novo workspace
Workspace é um espaço onde se pode fazer a comunicação entre canais, mensagens diretas etc.
3. Criar um novo aplicativo de desenvolvedor
O aplicativo serve para usar e configurar ferramentas da API do slack. Na criação do aplicativo, deve selecionar o workspace criado. Para criar selecione Seus Aplicativos e Criar Novo Aplicativo.
4. Configurar webhook e inscrição em eventos
Na aba de inscrição de eventos, permita os eventos. Depois, cadastre uma url para o webhook https://{endereço_do_lunaris}/post/slack/webhook. e também se inscreva em evento no recebimento de mensagens (Subscribe to bot events e Subscribe to events on behalf of users).
5. Receber link para envio de mensagem
Na aba de webhook de recebimento, ative tal funcionalidade e clique na opção de Adicionar um Novo Webhook ao Workspace. Na imagem abaixo é mostrado o link em que é possível enviar requisições de envio de mensagem. A url tem o padrão de endereço fixo (https://hooks.slack.com/services/) seguido do token, no caso, o token da imagem seria T07AKPV415W/B07A3P3FF39/Ta6EqeECKRHnJzqmcTdAIEaE.
6. Ativar Interatividade de Botões
Na aba de Interatividade e Atalhos de Texto, ative a Interatividade e ponha o link do webhook parecido com o passo 4, com endereço https://{endereço_do_lunaris}/post/slack/webhook_interaction.
7. Obter ID da conta
Na aba de informações básicas é mostrado o ID do aplicativo, como no caso, A07AKQV7AUQ.
O campo Signing Secret é a Chave Secreta que deve ser cadastrado no AURA BLOCKS.
8. Obter OAuth do Usuário
Nesta página do OAuth como pode ser pode vista na imagem abaixo, em User Token Scopes ative a opção im:read e files:read. Isso permitirá que arquivos e imagens sejam recebidos pelo nosso servidor do broker slack. Por último guarde o campo, User OAuth Token conforme mostra a imagem em que se inicia com "xoxp..."
