Como configurar o Slack no Skyone Studio

Para configurar o Slack, você precisará estar simultaneamente no Skyone Studio e o Slack for Developers. Além disso, você deve ter um espaço e um canal no Slack.

Passos:

1. [ Passo 01 ] Crie um app no Slack

2. [ Passo 02 ] Configure as permissões do app

3. [ Passo 03 ] Crie o Bot User OAuth Token

4. [ Passo 04 ] Ative a interatividade

5. [ Passo 05 ] Ative eventos

6. [ Passo 06 ] Adicione a conta Slack no Skyone Studio

7. [ Passo 07 ] Insira a URL do Studio no Slack

8. [ Passo 08 ] Ative a aba Mensagens

9. [ Passo 09 ] Confirme que o bot foi adicionado ao espaço no Slack

10. [ Passo 10 ] Teste seu Slack

Passo 01: Crie um app no Slack

1. Na página “Your Apps”, selecione “Create New App”.

2. Selecione a opção “From scratch”.

1. Digite o nome do seu app e selecione o “Workspace” onde você irá desenvolver seu app.

1. Clique em “Create App”.

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

Passo 02: Configure as permissões do app

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.

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

Passo 03: Crie o Bot User OAuth Token

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

1. Selecione o canal previamente criado onde o app deverá postar.

2. Para finalizar, clique em “Permitir”.

3. Pronto! O Bot User OAuth Token foi criado e será usado posteriormente.

Passo 04: Ative a interatividade

1. No menu lateral, acesse “Interactivity & Shortcuts".

2. Na seção “Interactivity", habilite a opção clicando no botão.

Passo 05: Ative eventos

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

1. Na seção “Enable Events", habilite a opção clicando no botão.

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

1. Clique em “Save Changes".

Passo 06: Adicione a conta Slack no Skyone Studio

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.

2. Crie ou abra o Fluxo do Agente desejado.

3. Clique em “Publicar".

4. Clique na opção “Slack".

5. Escolha o fluxo do agente que deseja configurar.

6. Clique em "Gerenciar contas".

1. Clique em “Criar conta".

2. No modal exibido, preencha os seguintes campos:

• Nome: nome para identificação da conta

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

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

1. Clique em “Criar" e feche o modal.

2. De volta à tela anterior no Studio, selecione a conta criada.

3. Na seção Usuários e Grupos, clique em "Gerenciar usuários e grupos".

1. Clique em “Criar usuário".

2. Preencha os seguintes campos:

• Nome

• E-mail

• Tipo: selecione "Slack"

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

1. Clique em “Criar" e feche o modal.

2. O usuário será exibido automaticamente, e também poderá ser adicionado manualmente em “Selecionar usuários".

3. Por fim, clique em “Salvar publicação".

4. Observe que é exibida uma URL de Webhook. Copie essa URL para utilizar na próxima etapa de configuração.

Passo 07: Insira a URL do Studio no Slack

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

1. Em seguida, acesse a página “Interactivity & Shortcuts” e cole a URL copiada anteriormente no campo “Request URL".

1. Clique em “Save Changes” para finalizar.

Passo 08: Ative a aba Mensagens

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

Passo 09: Confirme que o bot foi adicionado ao espaço no Slack

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

1. Acesse a aba "Integrações".

2. Em "Apps", verifique se o bot aparece nesta seção. Caso não apareça, clique em "Adicionar apps" para adicionar.

Passo 10: Teste seu Slack

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