# 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FamzIkBLfTcIuM5JT1Tx1%2FADCD1490-501B-47F9-A144-1194BE58EC05_1_105_c.jpeg?alt=media&#x26;token=745e702d-6fdf-4f3f-b281-47cb8dc2d2e3" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FRhqQTKidXV1cuSPYZDa6%2F497FB8DF-BF64-43EE-816B-971BDE5DC46C.png?alt=media&#x26;token=38a386b5-5b31-4d75-a656-7106c2546ea0" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2Fupe8mq2Y4acvmkEKa7ml%2F0F6B21C3-4A73-422F-8033-F1DC65700021_1_105_c.jpeg?alt=media&#x26;token=f942b6a1-a3a6-495c-b51f-0cc22634a002" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FhJgEudNVHRZreuuBjyDx%2F63776220-80FD-4982-A905-BED403146016_1_105_c.jpeg?alt=media&#x26;token=f7cbee13-a12e-4cd2-8b74-3791fd25191f" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FWmoKmMSJ3HiLrkiDtgEd%2FF6A7C1C7-D42E-49AA-BB8D-C994A2307336.png?alt=media&#x26;token=7c81f64e-57f5-4741-b867-faa462a73407" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FeASw6rLPPYwuCE0zGAwD%2FC6D7FE5C-1E4C-4414-AEA1-58E6417859B1.png?alt=media&#x26;token=ced49c0c-a4de-4d85-8cea-7151b18d9848" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FYq1FM0KWGNpRn6MVbod7%2FC7AA086F-2FF2-4F5F-9BF0-2DFDB0A25972.png?alt=media&#x26;token=8f2c87c6-ba20-4f57-b1b7-be8e506d625c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FnEidTlPKSYswTEkACrLC%2Fdel%20edicao%20de%20imagem.png?alt=media&#x26;token=06759ab0-3b8b-47d4-8785-92ba4689ce52" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FThwcjpvNqWeGkYjA9yNu%2F2A9BE573-87C9-4D71-9F56-83B7BD238070_1_105_c.jpeg?alt=media&#x26;token=1201c39b-3174-43c2-bb17-6d3e4a6bd1a2" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F8T3jvJcSC49B2SifBNDD%2FB84FDEBF-B448-4F42-9D2A-64A42D605F53.png?alt=media&#x26;token=82615b41-0575-4b1e-8b6d-755a9caeff9a" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2Fo5rYMPFpZbj5bXsKD6eD%2F65461F2A-CA2A-4C13-BAF9-2FE1BA06C255.png?alt=media&#x26;token=6a5e9f66-c78f-4370-8365-a6cf4e0a0069" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F8Pwl9mtfjQQTR1KMwUor%2F97034D9F-370D-4068-8804-C004DA8ECD04.png?alt=media&#x26;token=cfe19a2f-49fc-4d36-a2fa-375fdd42c5c7" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FRgaOGB3nOUAnlZpZATPa%2F0AD1653B-44B5-455A-B31F-CD7FBDD4F2B2.png?alt=media&#x26;token=d5a90ecd-6dc6-4acf-b8ae-0f79a1e522b9" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F4FeAtDhB9NfHvhSrbnWZ%2FF46579B8-89B8-48DA-A6B3-67085162CEDE.png?alt=media&#x26;token=a9c0a0a1-fc4a-455d-8acf-2adbb26a9f9e" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FzPPIstm6LL28GK6tZOME%2FDFAB832F-7769-48E8-8721-CAD057395819.png?alt=media&#x26;token=ceaff67e-8d4f-4807-b5e0-e44013b1aa07" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2Fj5TIIt7VfSqYKlZt23Yb%2FA76475D4-B13A-4219-8B0E-AAB59BA1D2A8.png?alt=media&#x26;token=480a95be-4650-4835-8ba3-610a4a7f0eea" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F0orU2kKPL8csjCOTqAMA%2F3BFBD704-E650-4C59-9289-30DDDF3DF180.png?alt=media&#x26;token=2ea7649f-3212-4a32-b2d4-6e894d3b2587" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FtyaBcC9d5wO5jkjxKUnz%2F7E4F7C26-48BE-4674-96A9-E6C916837F3C.png?alt=media&#x26;token=e55392f5-b5aa-44e4-b5f5-165782f82dff" 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="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FmbS28tQTsSmXpN3WXl2y%2FE6637D78-F18E-4020-A42F-489F9880537D.png?alt=media&#x26;token=76a96615-0ee3-4231-ae22-680343844195" 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>