Integre o Chatbot do EKB ao Slack

​

Pré-requisitos

• Você possui:
  • O project id do seu projeto à mão
  • Um conjunto de Chave de API + Secret para configurar o aplicativo EKB no Slack

​

Instalar e Configurar o Aplicativo EKB no Slack

1. Vá para Slack API Apps. Pode ser necessário fazer login no seu espaço de trabalho do Slack.
2. Clique em Criar um App.
3. Selecione Do zero.
4. Insira o Nome do Aplicativo (por exemplo, “EKB Chatbot”).
5. Selecione o Espaço de Trabalho de Desenvolvimento do Slack onde deseja instalar o aplicativo.
6. Clique em Criar App.
7. Na seção Informações Básicas, anote os seguintes valores: App ID, Client ID, Client Secret, Signing Secret e Verfication Token. Você precisará desses valores para configurar o aplicativo no passo 11 abaixo.
8. Na barra lateral esquerda, clique em OAuth & Permissions:\ a. Clique em Adicionar URL de Redirecionamento e insira a seguinte URL:
   https://ai-api.automationanywhere.com/slack/oauth
   
   b. Clique em Adicionar e depois em Salvar URLs. c. Em Escopos, adicione os seguintes Escopos de Token de Bot:
   • app_mentions:read – para permitir que o bot leia mensagens onde é mencionado em conversas das quais o aplicativo faz parte.
   • channels:history – para permitir que o bot veja mensagens e outros conteúdos em canais públicos dos quais o aplicativo é membro.
   • channels:manage – para permitir que o bot gerencie canais, incluindo criar, arquivar e renomear canais.
   • channels:read – para permitir que o bot veja informações básicas sobre canais públicos em um espaço de trabalho.
   • chat:write – para permitir que o bot envie mensagens como o aplicativo.
   • commands – para permitir que o bot adicione comandos de barra que os usuários podem invocar.
   • groups:read – para permitir que o bot veja informações básicas sobre canais privados dos quais o aplicativo é membro.
   • im:history – para permitir que o bot veja mensagens e outros conteúdos em mensagens diretas das quais o aplicativo é membro.
   • im:write – para permitir que o bot envie mensagens diretas como o aplicativo.
   • users.profile:read – para permitir que o bot veja perfis de usuários.
   • users:read – para permitir que o bot veja pessoas em um espaço de trabalho.
   • users:read.email – para permitir que o bot veja e-mails de usuários.
9. Clique em App Home na barra lateral esquerda. Em Exibir Abas, certifique-se de que Aba de Mensagens esteja habilitada, bem como a caixa de seleção abaixo dela.
10. Na barra lateral esquerda, clique em Slash Commands:\ a. Clique em Criar Novo Comando. b. No campo Comando, insira /setup.\ c. No campo URL de Requisição, insira:
    https://ai-api.automationanywhere.com/slack/events
    
    d. No campo Descrição Curta, insira algo como “Configuração de Canal”.\ e. Opcionalmente, você pode adicionar uma descrição mais longa no campo Dica de Uso.\ f. Clique em Salvar.
11. Complete a seguinte URL do endpoint da API, com os valores coletados no passo 7:
    https://ai-api.automationanywhere.com/slack/custom_install/{client_id}/{client_secret}/{signing_secret}/{verification_token}
    
    Substitua {client_id}, {client_secret}, {signing_secret} e {verification_token} pelos valores do seu aplicativo Slack encontrados na seção Informações Básicas.
12. Abra a URL completa em um novo navegador. Isso o redirecionará para uma página com um botão Adicionar ao Slack. Clique neste botão para instalar o aplicativo no seu espaço de trabalho.
13. Você será redirecionado para uma página solicitando permissão para acessar seu espaço de trabalho. Clique em Permitir para conceder as permissões necessárias.
14. Você deve ver uma mensagem de confirmação indicando que a instalação foi bem-sucedida, e será redirecionado ao seu espaço de trabalho do Slack.
15. Navegue até Permissões de Eventos na barra lateral e faça o seguinte:\ a. Ative Habilitar Eventos.\ b. No campo URL de Requisição, insira:
    https://ai-api.automationanywhere.com/slack/events
    
    d. Em seguida, vá para Inscrever-se em Eventos de Bot abaixo.\ e. Clique em Adicionar Evento de Usuário Bot e adicione estes dois eventos: app_mention e message.im.\ f. Clique em Salvar Alterações.
16. Navegue até Interatividade e Atalhos na barra lateral e faça o seguinte:\ a. Ative Interatividade.\ b. No campo URL de Requisição, insira:
    https://ai-api.automationanywhere.com/slack/events
    
    c. Clique em Salvar Alterações.
17. Vá para o seu espaço de trabalho do Slack e você deve ver o aplicativo EKB na lista de aplicativos na barra lateral esquerda.

​

Configurar um Canal para o Aplicativo EKB

1. Abra seu espaço de trabalho do Slack e navegue até o canal onde deseja configurar o EKB.
2. Na caixa de entrada de mensagens, digite /setup e pressione Enter.
3. Uma janela pop-up aparecerá, solicitando que você insira as seguintes informações:
   • Canal – Selecione o canal que deseja configurar para o EKB.\
     Se você quiser usar o aplicativo em mensagens diretas, selecione seu próprio nome de usuário.
   • ID do Projeto: Insira o ID do seu Projeto EKB.
   • Chave de API: Insira sua Chave de API do EKB.
   • Secret da API: Insira seu Secret da API do EKB.
4. Clique em Enviar para concluir o processo de configuração. O aplicativo validará as informações e configurará o canal.
5. Se a configuração for bem-sucedida, você verá uma mensagem de confirmação no canal indicando que o EKB foi configurado com sucesso.
   
   O EKB agora está configurado no seu canal selecionado! Você pode começar a interagir com o bot mencionando-o nas mensagens ou usando os comandos de barra.