...
Efetue logon no seu Espaço de trabalho do Slack em https://slack.com/signin. Get Started. Se um espaço de trabalho ainda não existir, crie um.
Depois de efetuar logon no espaço de trabalho, clique no link abaixo para criar um Canal do aplicativos Slack.
https://api.slack.com/apps?new_app=1Na tela Criar um aplicativo Slack, adicione os detalhes do seu aplicativo Slack
Nome do aplicativo e selecione seu Espaço de trabalho.
Clique no botão Criar aplicativo.
Observação: caso você não seja levado diretamente à página Criar um aplicativo Slack. Clique no botão Criar novo aplicativo na página inicial API do Slack.
Seu aplicativo Slack foi criado e você será redirecionado para a seguinte tela:
Role para baixo atéCredenciais do aplicativo. Essa seção contém aID do aplicativo,a ID do cliente, o Segredo do cliente e o Segredo de assinatura exclusivos atribuídos ao aplicativo. As informações são usadas para configurar o Slack como um canal de bate-papo em seu inquilino tenant da Luma VSA e permitir que o inquilino tenant acesse a API do Slack.
Copie a ID do aplicativo, a ID do cliente, o Segredo do cliente e o Segredo de assinatura e guarde as informações em um local de fácil acesso, como o bloco de notas ou qualquer ferramenta de edição de texto. As informações serão usadas posteriormente para configurar e ativar o Slack na Luma VSA.
...
Adicione o URL do terminal em seu aplicativo Slack. O RequestURL da Luma VSA é adicionado ao aplicativo Slack. Para adicionar o URL, siga as etapas abaixo:
Efetue logon no seu inquilino tenant da Luma VSA na interface do usuário do Criador de bot.
Vá para a guia Canal na página Menu do bot → Configurações.
Clique no bloco Slack.
Você é redirecionado para a página Configurar canal. Copie o valor no campo RequestURL/RedirectURL e guarde-o também em um bloco de notas ou em qualquer ferramenta de edição de texto. O URL será adicionado ao seu aplicativo Slack na próxima etapa.
Agora, na página API do Slack, vá para a guia Assinatura do evento.
Alterne o botão Ativar eventos para Ativado.
Adicione o RequestURL copiado na Etapa 2 → 1(d) ao campo URL da solicitação. A API do Slack enviará uma solicitação ao terminal e verificará o URL. Somente após a verificação, o Slack poderá se conectar ao seu inquilinotenant.
Agora, role para baixo até Assinar eventos do bot.
Aqui, assinamos o bot "receber eventos", como novas mensagens no canal. Isso permite que o Slack se comunique com a Luma VSA. Você pode assinar eventos com base nas necessidades da sua organização. Para saber mais sobre todos os tipos de evento, consulte https://api.slack.com/events . Para assinar eventos, siga este procedimento:Clique no botão Adicionar evento de usuário do bot
Pesquise e adicione as assinaturas de evento abaixo, uma por uma.
member_joined_channel
member_left_channel
message.channels
message.groups
message.mpim
Clique em Salvar alterações.
A próxima etapa é adicionar o OAuth e as permissões.
Vá para a guia OAuth e permissões.
Clique em Adicionar novo URL de redirecionamento. O URL de redirecionamento é necessário para autenticação. Os URLs na Luma VSA e no Slack devem corresponder para uma configuração bem-sucedida do aplicativo.
Adicione o RequestURL copiado na Etapa 2 → 1(d) ao campo URLs de redirecionamento e clique em Adicionar.
Clique no botão Salvar URLs
Depois que o URL é adicionado, adicionamos o Escopo. Os recursos e as permissões do seu aplicativo para interagir com a Luma VSA são administrados pelos escopos solicitados.
Na seção Escopos → Escopo do token do bot, clique em Adicionar um escopo do OAuth e adicione os escopos a seguir, um a um.channels:history
channels:read
groups:history
groups:read
im:history
mpim:history
Na seção Escopos → Escopo do token do usuário, clique em Adicionar um escopo de OAuth e adicione o seguinte escopo:
users.profile:read
Observação: users.profile:read permite que a Luma VSA solicite informações de usuário do Slack para autenticar o usuário automaticamente.
A próxima etapa é configurar os componentes interativos, ou seja, ativar as interações entre o Slack e a Luma VSA com componentes interativos, como botões, lista de seleção e muito mais. Para isso, siga as etapas abaixo:
Vá para a guia Interatividade e atalhos.
Alterne o botão Interatividade para Ativado.
Adicione o RequestURL copiado na Etapa 2 → 1(d) ao campo URL da solicitação. O Slack enviará uma solicitação com informações a esse URL quando os usuários interagirem com um componente interativo.
Clique em Salvar alterações.
Agora, vá até a guia Página inicial do aplicativo e ative o seguinte:
Na seção Presença do seu aplicativo no Slack, alterne a opção Sempre mostrar meu bot como online para ativado.
Na seção Mostrar guias, alterne a guia Página inicial para ativada.
| Info |
|---|
Quando as Permissões do escopo do OAuth são atualizadas, a reinstalação do aplicativo é necessária para que as alterações entrem em vigor. Clique em Reinstalar o aplicativo, caso o Slack exiba o prompt a seguir. A Luma VSA solicitará permissão para acessar o Espaço de trabalho do Slack. Você será redirecionado para a página de solicitação de permissão (semelhante à Etapa 3-->ponto 7). Clique no botão Permitirparaaceitar a solicitação de acesso. **Isso pode não ser necessário ao adicionar as permissões pela primeira vez. |
Etapa 3: configurar o Slack na Luma
Agora que seu aplicativo Slack está pronto, a próxima etapa é ativar o Canal de bate-papo do Slack e enviar as credenciais à Luma VSA. Para isso, siga as etapas abaixo:
Efetue logon no seu inquilino tenant da Luma VSA na interface do usuário do Criador de bot.
Vá para a guia Canal na página Menu do bot → Configurações.
Clique no bloco Slack.
Na página Configurar canal, cole os valores deID do aplicativo, ID do cliente, Segredo do cliente e Segredo de assinatura (salvos no bloco de notas na Etapa 1 → 5) em seus respectivos campos.
Role para baixo até a seção Reconciliação do usuário para autenticação de canal para especificar os detalhes do usuário que serão usados pela Luma VSA para reconciliar e autenticar automaticamente os usuários que se conectam pelo Slack. Como a Luma VSA usa o endereço de email para autenticar usuários por meio do Slack, adicione os campos da Luma que podem conter o endereço de email do usuário.
Selecione as informações de usuário necessárias em Campos do usuário
Clique no botão Definir.
Você pode adicionar um ou mais campos. Durante a reconciliação ou autenticação.
Depois que os detalhes forem adicionados, clique no botão Configurar para ativar o canal.
A Luma VSA solicitará permissão para acessar o Espaço de trabalho do Slack. Você será redirecionado para a página abaixo.
Clique no botão Permitirparaaceitar a solicitação de acesso. A página a seguir é exibida com uma mensagem de êxito.
O Slack agora está ativado para seu inquilinotenant. Os usuários finais podem se comunicar com a Luma VSA pelo Slack como um canal de bate-papo.
O Slack agora está configurado para seu inquilino tenant e os usuários registrados podem se comunicar com a Luma VSA por meio do Slack.
...