> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Integre o Chatbot do EKB ao Slack
> Leve o EKB para o Slack
Integrar o EKB ao Slack traz um chat inteligente e context-aware diretamente para o seu espaço de trabalho, permitindo que as equipes interajam com seu agente de IA sem sair do Slack. Este guia orienta você sobre como instalar o aplicativo EKB no Slack, configurar permissões e definir um canal para comunicação contínua com seu agente de IA.
Cada projeto do EKB pode ser vinculado a apenas um aplicativo do Slack. Você precisará criar um novo aplicativo do Slack para cada projeto adicional do EKB que desejar conectar.
## 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](https://api.slack.com/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:
```text theme={null}
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.
O aplicativo foi instalado com sucesso no seu espaço de trabalho do Slack! O próximo passo é executar o comando de configuração para configurar um canal para o EKB.
## Configurar um Canal para o Aplicativo EKB
Para configurar um canal para o EKB, você precisa executar o comando `/setup` no canal desejado. Este comando configurará o canal para trabalhar com o 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.