Skip to main content

​
Introdução

O canal Slack conecta seu agente do Brain Studio ao Slack para que sua equipe e seus clientes recebam respostas rápidas e personalizadas por mensagem direta, sem sair do espaço de trabalho. A conexão é feita por meio de um app do Slack que você cria no seu workspace. A Jelou recebe os eventos e as interações do Slack, executa o fluxo publicado e devolve as respostas do agente no mesmo chat.
O canal funciona apenas com mensagens diretas ao bot. Ele não responde em canais públicos nem privados do workspace.

​
Pré-requisitos

Antes de ativar o canal, certifique-se de ter:
  • Uma conta ativa na Jelou e acesso à seção Canais
  • Um app do Slack criado no seu workspace, com estes dados em mãos:
    • Bot User OAuth Token (começa com xoxb-), em OAuth & Permissions
    • Signing Secret, em Basic Information
    • App ID, em Basic Information
  • Um token de configuração do app (começa com xoxe.xoxp-), gerado na página de configuração de apps do Slack
Se você não vir a opção Slack na lista de canais, seu plano não a inclui. Entre em contato com seu administrador ou com a equipe de suporte da Jelou.

​
Ativar o canal

1

Abrir a seção Canais

Faça login na Jelou, acesse Canais e selecione a opção Slack.
2

Nomear o canal e escolher o projeto

Atribua um nome descritivo, por exemplo, Slack - Suporte interno. O nome deve ter entre 4 e 50 caracteres.Em seguida, selecione o projeto do Brain Studio ao qual o canal será conectado.
Use um nome que identifique o ambiente além do canal, por exemplo, Slack - RH Produção, para distingui-lo com facilidade na listagem.
3

Informar as credenciais do app do Slack

Na segunda etapa do modal, preencha os quatro campos, todos obrigatórios:
  • Bot User OAuth Token: o token do bot que começa com xoxb-
  • Signing Secret: o Signing Secret de Basic Information
  • App ID: o App ID de Basic Information
  • Token de configuração do app: o token que começa com xoxe.xoxp-
Se você deixar um campo vazio, o formulário o marca em vermelho com a mensagem Este valor é obrigatório e o botão de criação permanece desabilitado.
O token de configuração é usado uma única vez para definir as Request URLs do seu app e não é armazenado. Ele expira cerca de 12 horas após ser gerado, portanto gere-o pouco antes de ativar o canal.
4

Criar e conectar o canal

Clique em Criar e conectar canal. A Jelou cria o canal, configura as Request URLs no seu app do Slack e exibe a Request URL resultante.
Se o token de configuração foi aceito, você verá a confirmação de que as Request URLs de Events e Interactivity foram definidas no seu app. Não é necessário fazer mais nada do lado do Slack.
O Slack entrega os eventos e as interações na mesma rota, portanto uma única URL serve para ambos os campos.
5

Configurar as Request URLs manualmente (somente se falhar)

Se a configuração automática falhar, o canal já foi criado e o modal exibe a URL para você colar manualmente. Copie a URL e cole nos dois campos do seu app do Slack:
  • Event Subscriptions → Request URL
  • Interactivity & Shortcuts → Request URL
Você pode encontrar essa URL novamente a qualquer momento nas propriedades do canal, portanto não é necessário guardá-la à parte.
6

Verificar a URL de Events se o Slack solicitar

Em alguns casos o Slack precisa de uma verificação manual. Se o modal exibir esse aviso, abra Event Subscriptions no seu app do Slack e clique em Verify uma vez para ativar a URL de Events.
7

Construir a lógica no Brain Studio

Abra o projeto no Brain Studio, selecione o canal Slack na listagem de workflows e comece a construir seu fluxo.

​
Propriedades do canal

Uma vez criado o canal, suas propriedades exibem:
O bot token e o Signing Secret são armazenados de forma encriptada e nunca exibidos novamente. Para substituí-los é preciso criar o canal novamente.

​
Conteúdo suportado

O canal do Slack admite um subconjunto dos blocos disponíveis no WhatsApp: Outros limites aplicados pelo canal:
  • Caption de multimídia: 3000 caracteres
  • Corpo de mensagens com botões: 3000 caracteres
  • Nome de arquivo: 255 caracteres
  • Mensagem de opção não encontrada: 250 caracteres

​
Limitações do canal

No builder, alguns nós e ferramentas não estão disponíveis no canal Slack porque dependem do WhatsApp ou de outras integrações.

​
Nós e blocos não disponíveis

  • Modelo HSM
  • WhatsApp Flows
  • Vídeo
  • Áudio
  • Documento e Arquivo
  • Sticker
  • Carrossel
  • Lista numerada
  • Webview
  • Localização
  • Contato
  • Respostas rápidas
  • Pagamentos
  • Connect (consultor)
  • Biometria
  • Transferência para humano (HubSpot, Genesys ou outros)

​
Ferramentas do Agente IA não disponíveis

  • Call to action (send_call_to_action)
  • Transferir para consultor (transfer_to_agent)
  • Jelou Shop

​
Próximos passos

Uma vez conectado o canal:
  1. Envie uma mensagem direta ao bot pelo Slack para verificar a conexão
  2. Confira os logs de execução no Brain Studio para confirmar que o fluxo é executado
  3. Ajuste o fluxo com os blocos suportados pelo canal
Teste o canal com um usuário real do seu workspace antes de publicá-lo, para confirmar que as Request URLs de Events e Interactivity foram configuradas corretamente.