# Como configurar o Slack no Skyone Studio?

Esta documentação descreve o processo completo para configurar a integração do **Slack** no **Skyone Studio**.\
O objetivo é permitir que fluxos de agentes criados no **Skyone Studio** se comuniquem diretamente com canais e usuários no **Slack**.\
Destina-se a administradores e desenvolvedores responsáveis por configurar integrações e gerenciar fluxos no **Skyone Studio**.

### **Benefícios:** 

* Permite comunicação direta entre o **Skyone Studio** e o **Slack**.
* Automatiza respostas e interações em canais ou mensagens privadas.
* Centraliza fluxos de atendimento e notificações em um único local.
* Facilita o gerenciamento de usuários e permissões.

### Etapas de configuração

Para configurar o **Slack**, você precisará estar simultaneamente no [Skyone Studio](https://studio.skyone.cloud/home) e o [Slack for Developers](https://api.slack.com/developer-program). Além disso, você deve ter um espaço e um canal no **Slack**.

### Passos:

[**\[ Passo 01 \]** Crie um app no Slack](#passo-01-crie-um-app-no-slack): Base da integração e geração de credenciais.

[**\[ Passo 02 \]** Configure as permissões do app](#passo-02-configure-as-permissoes-do-app): Defina os escopos necessários.

[**\[ Passo 03 \]** Crie o Bot User OAuth Token](#passo-03-crie-o-bot-user-oauth-token): Token para autenticar no Studio.

[**\[ Passo 04 \]** Ative a interatividade](#passo-04-ative-a-interatividade): Permite respostas do Slack.

[**\[ Passo 05 \]** Ative eventos](#passo-05-ative-eventos): Envio de menções e mensagens ao Studio.

[**\[ Passo 06 \]** Adicione a conta Slack no Skyone Studio](#passo-06-adicione-a-conta-slack-no-skyone-studio): Cadastre as credenciais do Slack.

[**\[ Passo 07 \]** Insira a URL do Studio no Slack](#passo-07-insira-a-url-do-studio-no-slack): Para receber eventos.

[**\[ Passo 08 \]** Ative a aba Mensagens](#passo-08-ative-a-aba-mensagens): Habilite a aba de mensagens para que os usuários possam interagir diretamente com o bot no Slack.

[**\[ Passo 09 \]** <mark style="color:blue;">Confirme que o bot foi adicionado ao espaço no</mark> <mark style="color:blue;">Slack</mark>](#passo-09-confirme-que-o-bot-foi-adicionado-ao-espaco-no-slack)<mark style="color:blue;">:</mark> Verifique presença no workspace

[**\[ Passo 10 \]** Teste seu Slack](#passo-10-teste-seu-slack): Envie uma mensagem para confirmar que a integração está funcionando corretamente.

***

#### <mark style="color:blue;">Passo 01: Crie um app no Slack</mark>

1. Na página “[Your Apps](https://api.slack.com/apps)”, selecione “**Create New App**”.
2. Selecione a opção “**From scratch**”.

<figure><img src="/files/PguBG2AmSTJl8j6caAzz" alt=""><figcaption></figcaption></figure>

3. Digite o nome do seu app e selecione o “**Workspace**” onde você irá desenvolver seu app.&#x20;

<figure><img src="/files/BcuP02LqKfrTkLJV5sio" alt=""><figcaption></figcaption></figure>

4. Clique em “**Create App”**.
5. Concluída a criação do app, a página *Basic Information* será exibida. Você precisará dela e de outras páginas da área de Features para a configuração. Mantenha-a aberta.

#### <mark style="color:blue;">**Passo 02: Configure as permissões do app**</mark>

No Slack, as permissões são chamadas de “Scopes". Esses escopos definem o que o app pode acessar ou executar, como ler menções, enviar mensagens, acessar arquivos e obter informações de usuários.

<figure><img src="/files/TA7zEggS3jrJfFs2LyC0" alt=""><figcaption><p>Exemplo de escopos adicionados</p></figcaption></figure>

1. No menu lateral, acesse “**OAuth & Permissions**”.
2. Na seção “Scopes", clique em “**Add an OAuth Scope**" para adicionar os seguintes escopos:

* `app_mentions:read`
* `channels:history`
* `chat:write`
* `files:read`
* `im:history`
* `im:read`
* `incoming-webhook`
* `users:read`
* `users:read.email`

#### <mark style="color:blue;">**Passo 03: Crie o Bot User OAuth Token**</mark>

1. Ainda em  “**OAuth & Permissions**", na seção “OAuth Tokens”, clique em “**Install to Docs**".

<figure><img src="/files/TfJAnRUsAeBdLrJtgJV0" alt=""><figcaption></figcaption></figure>

2. Selecione o canal previamente criado onde o app deverá postar.
3. Para finalizar, clique em “**Permitir**”.&#x20;
4. Pronto! O *Bot User OAuth Token* foi criado e será usado posteriormente.

#### <mark style="color:blue;">**Passo 04: Ative a interatividade**</mark>

1. No menu lateral, acesse “**Interactivity & Shortcuts**".
2. Na seção “**Interactivity**", habilite a opção clicando no botão.

<figure><img src="/files/OuDTlrr5tIZ8QpZhGbC9" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">**Passo 05: Ative eventos**</mark>

1. No menu lateral, acesse “**Event Subscriptions**".

<figure><img src="/files/cOTNB79lKI2h5UPv3tWm" alt=""><figcaption></figcaption></figure>

2. Na seção “**Enable Events**", habilite a opção clicando no botão.
3. Ainda na mesma página, na seção “**Subscribe to bot events**", clique em “**Add Bot User Event**” para adicionar os seguintes eventos:

* app\_mention
* message.channels
* message.im

4. Clique em “**Save Changes**".

#### <mark style="color:blue;">**Passo 06: Adicione a conta Slack no Skyone Studio**</mark>

Para conectar o Slack no **Skyone Studio**, temos passos divididos em três seções: **Fluxo do Agente**, **Conta** e **Usuários**.

Acompanhe a seguir:

1. Acesse o **Skyone Studio**.&#x20;
2. Crie ou abra o **Fluxo do Agente** desejado.&#x20;
3. Clique em “**Publicar**".
4. Clique na opção “**Slack**".&#x20;
5. Escolha o fluxo do agente que deseja configurar.
6. Clique em "**Gerenciar contas**".

<figure><img src="/files/FD026wFetsTHh0zRn5DW" alt=""><figcaption></figcaption></figure>

7. Clique em “**Criar conta**".
8. No modal exibido, preencha os seguintes campos:

<figure><img src="/files/kwSQ4bQ7ovayiFw74Kf8" alt=""><figcaption></figcaption></figure>

* **Nome:** nome para identificação da conta
* **Conta pública:** ao ativar esta opção, qualquer pessoa poderá interagir com a publicação vinculada, sem necessidade de autenticação.

{% hint style="info" %}
Uma conta pública pode ser vinculada a apenas uma única publicação.
{% endhint %}

* **Token do bot:** acesse a página *OAuth & Permissions* no Slack, localize a seção *OAuth Tokens*, copie o *Bot User OAuth Token* e cole neste campo.

<figure><img src="/files/IhFutVX0x3h2hyVivkCm" alt=""><figcaption><p><em>Bot User OAuth Token</em></p></figcaption></figure>

* **Signing secret:** acesse a página *Basic Information* no Slack, copie o valor de Signing Secret e cole neste campo.

<figure><img src="/files/XXqx7E7F9wNR90x7xmCf" alt=""><figcaption><p>Dados do Signing Secret no Slack</p></figcaption></figure>

9. Clique em “**Criar**" e feche o modal.&#x20;
10. De volta à tela anterior no **Studio**, selecione a conta criada.
11. Na seção **Usuários e Grupos**, clique em "**Gerenciar usuários e grupos**".&#x20;

<figure><img src="/files/2EU0AWeXp4hphADFs4R3" alt=""><figcaption></figcaption></figure>

12. Clique em “**Criar usuário**".
13. Preencha os seguintes campos:

<figure><img src="/files/XQgsGQ1Au3HHdtv6msId" alt=""><figcaption></figcaption></figure>

* **Nome**
* **E-mail**
* **Tipo:** selecione "**Slack"**

{% hint style="danger" %}
Se o usuário não estiver cadastrado como tipo Slack, a IA não conseguirá enviar uma resposta.
{% endhint %}

* **Configurações do e-mail:** ative a opção “**Usar o mesmo e-mail**” se o e-mail cadastrado no Slack for o mesmo informado acima. Caso contrário, digite o e-mail correspondente.

14. Clique em “**Criar**" e feche o modal.&#x20;
15. O usuário será exibido automaticamente, e também poderá ser adicionado manualmente em “**Selecionar usuários**".&#x20;
16. Por fim, clique em “**Salvar publicação**".&#x20;
17. Observe que é exibida uma **URL de Webhook**. Copie essa URL para utilizar na próxima etapa de configuração.&#x20;

<figure><img src="/files/4K8veRruR05MJCFlDRnJ" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">**Passo 07: Insira a URL do Studio no Slack**</mark>

1. Acesse novamente o Slack API.
2. No menu lateral, acesse “**Event Subscriptions**".
3. Na seção “**Enable Events**" e cole a URL copiada anteriormente no campo “**Request URL**".

<figure><img src="/files/g0Rfo2D4k8TdDc1FeLpW" alt=""><figcaption></figcaption></figure>

4. Em seguida, acesse a página “**Interactivity & Shortcuts**” e cole a URL copiada anteriormente no campo “**Request URL**".&#x20;

<figure><img src="/files/sjBiM1eMkEsNGanAgKFK" alt=""><figcaption></figcaption></figure>

5. Clique em “**Save Changes**” para finalizar.

#### <mark style="color:blue;">**Passo 08: Ative a aba Mensagens**</mark>

1. No menu lateral do Slack API, acesse “**App Home**”.
2. Na seção “**Show Tabs**", ative a opção “**Messages Tab**”.
3. Selecione a opção “**Allow users to send Slash commands and messages from the messages tab**".&#x20;

<figure><img src="/files/JNJjNO0VrRMwAUepVzS4" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">**Passo 09:**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">Confirme que o bot foi adicionado ao espaço no</mark> <mark style="color:blue;">Slack</mark>

1. No chat no Slack, clique em "**Mais ações**" (os três pontos localizados no canto direito).
2. No menu suspenso, clique em "**Editar configurações**".

<figure><img src="/files/Nw8baIKIMcxhlnC4K3By" alt=""><figcaption></figcaption></figure>

3. Acesse a aba "**Integrações**".
4. Em "**Apps**", verifique se o bot aparece nesta seção. Caso não apareça, clique em "**Adicionar apps**" para adicionar. &#x20;

<figure><img src="/files/U4wheH3GvTrxuEtLU7JL" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">**Passo 10: Teste seu Slack**</mark>

Procure o seu canal e teste a integração, digitando uma mensagem de saudação.&#x20;

<figure><img src="/files/l7FfJljhVvoaNknJ1Xjs" alt=""><figcaption></figcaption></figure>

***

### **Vídeo Demonstrativo**

Para facilitar a compreensão, assista ao vídeo abaixo com a demonstração prática de todas as etapas apresentadas nesta documentação. O vídeo mostra cada tela, clique e configuração necessária para concluir a integração do Slack com o Skyone Studio.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F40quNycSU3VOv42EukYd%2FSlack.mp4?alt=media&token=4c87291a-cf8e-448a-a0fe-ec40654ce45f>" %}

***

### FAQ - Configuração do Slack no Skone Studio&#x20;

<details>

<summary>Preciso de permissão de administrador no Slack para configurar?</summary>

Sim. É necessário ter permissão de administrador (ou equivalente) para criar o app, definir permissões, ativar eventos e instalar o bot no Workspace.

</details>

<details>

<summary>Posso usar qualquer Workspace no Slack?</summary>

Não. O app deve ser criado no Workspace que será utilizado na integração com o Skyone Studio.

</details>

<details>

<summary>O que fazer se o bot não responder?</summary>

* Verifique se o bot foi adicionado ao Workspace.
* Confirme se as permissões (scopes) estão configuradas.
* Confira se o **Bot User OAuth Token** e o **Signing Secret** foram cadastrados corretamente no Studio.
* Certifique-se de que a **Request URL** foi inserida e validada no Slack.
* Verifique se o usuário está cadastrado como tipo **Slack** no Studio.

Verifique se ele está adicionado ao canal e se os tokens estão corretos no Studio.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-slack-no-skyone-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.