Configurar o Slack

O Slack é um dos aplicativos de colaboração e mensagens instantâneas mais populares. A Agente virtual Luma oferece suporte ao Slack como um canal de bate-papo para as organizações que o usam para comunicação com seus usuários. O artigo descreve como podemos configurar o Slack para conversar com a Luma.

Siga as etapas abaixo para configurar o bot para se comunicar com os usuários finais por meio do aplicativo de mensagens Slack:

Etapa 1: criar um aplicativo

1. Efetue logon no seu Espaço de trabalho do Slack em Get Started. Se um espaço de trabalho ainda não existir, crie um.

   Open

   

    

2. 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=1

3. Na tela Criar um aplicativo Slack, adicione os detalhes do seu aplicativo Slack

   1. Nome do aplicativo e selecione seu Espaço de trabalho.

   2. Clique no botão Criar aplicativo.

      Open

      

      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.

4. Seu aplicativo Slack foi criado e você será redirecionado para a seguinte tela:

    

5. Role para baixo até Credenciais do aplicativo. Essa seção contém a ID 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 tenant da Luma VSA e permitir que o 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.

Etapa 2: configurar o aplicativo Slack

Depois que o aplicativo é criado, a próxima etapa é configurá-lo e fornecer a permissão necessária para permitir que ele interaja com o bot da Luma. Veja a seguir as configurações necessárias:

1. 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:

   1. Efetue logon no seu tenant da Luma VSA na interface do usuário do Criador de bot.

   2. Vá para a guia Canal na página Menu do bot → Configurações.

   3. Clique no bloco Slack.

   4. 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.

   5. Agora, na página API do Slack, vá para a guia Assinatura do evento.

       

   6. Alterne o botão Ativar eventos para Ativado.

   7. 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 tenant.

       

2. 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:

   1. Clique no botão Adicionar evento de usuário do bot

   2. Pesquise e adicione as assinaturas de evento abaixo, uma por uma.

      • member_joined_channel

      • member_left_channel

      • message.channels

      • message.groups

      • http://message.im

      • message.mpim

         

   3. Clique em Salvar alterações.

3. A próxima etapa é adicionar o OAuth e as permissões.

   1. Vá para a guia OAuth e permissões.

   2. 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.

       

   3. Adicione o RequestURL copiado na Etapa 2 → 1(d) ao campo URLs de redirecionamento e clique em Adicionar.

   4. Clique no botão Salvar URLs

   5. 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
        
        

         

4. 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.

5. 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:

   1. Vá para a guia Interatividade e atalhos.

   2. Alterne o botão Interatividade para Ativado.

   3. 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.

   4. Clique em Salvar alterações.

6. Agora, vá até a guia Página inicial do aplicativo e ative o seguinte:

   1. Na seção Presença do seu aplicativo no Slack, alterne a opção Sempre mostrar meu bot como online para ativado.

   2. Na seção Mostrar guias, alterne a guia Página inicial para ativada.

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:

1. Efetue logon no seu tenant da Luma VSA na interface do usuário do Criador de bot.

2. Vá para a guia Canal na página Menu do bot → Configurações.

3. Clique no bloco Slack.

4. Na página Configurar canal, cole os valores de ID 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.

5. 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.

   1. Selecione as informações de usuário necessárias em Campos do usuário

   2. Clique no botão Definir.
      Você pode adicionar um ou mais campos. Durante a reconciliação ou autenticação.

6. Depois que os detalhes forem adicionados, clique no botão Configurar para ativar o canal.

    

7. A Luma VSA solicitará permissão para acessar o Espaço de trabalho do Slack. Você será redirecionado para a página abaixo.

8. Clique no botão Permitir para aceitar a solicitação de acesso. A página a seguir é exibida com uma mensagem de êxito.

9. O Slack agora está ativado para seu tenant. 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 tenant e os usuários registrados podem se comunicar com a Luma VSA por meio do Slack.

No Slack, seu bot agora aparece em Aplicativos no painel esquerdo para todos os integrantes do espaço de trabalho.

Para começar a interagir com o bot, os usuários finais podem digitar uma mensagem na caixa de texto. Se o usuário conectado já estiver disponível na Luma (com o mesmo endereço de email do perfil do usuário no Slack), ele será autenticado automaticamente pelo sistema. Nenhum registro manual é necessário.