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.

Termos importantes (Glossário)

• Slack API: Interface que permite criar e configurar apps para integração.

• Bot User OAuth Token: Token de autenticação para o bot interagir no Slack.

• Signing Secret: Chave de segurança para validar comunicações.

• Scopes: Permissões atribuídas a um app no Slack.

• Webhook URL: Endereço usado pelo Slack para enviar eventos ao Studio.

Etapas de configuração

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:

[ Passo 01 ] Crie um app no Slack: Base da integração e geração de credenciais.

[ Passo 02 ] Configure as permissões do app: Defina os escopos necessários.

[ Passo 03 ] Crie o Bot User OAuth Token: Token para autenticar no Studio.

[ Passo 04 ] Ative a interatividade: Permite respostas do Slack.

[ Passo 05 ] Ative eventos: Envio de menções e mensagens ao Studio.

[ Passo 06 ] Adicione a conta Slack no Skyone Studio: Cadastre as credenciais do Slack.

[ Passo 07 ] Insira a URL do Studio no Slack: Para receber eventos.

[ 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 ] Confirme que o bot foi adicionado ao espaço no Slack: Verifique presença no workspace

[ Passo 10 ] Teste seu Slack: Envie uma mensagem para confirmar que a integração está funcionando corretamente.

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.

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.

FAQ - Configuração do Slack no Skone Studio