> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack
> Ative e configure o canal do Slack para conectar seu agente do Brain Studio ao espaço de trabalho da sua equipe.
## 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](https://api.slack.com/apps)
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
Faça login na Jelou, acesse **Canais** e selecione a opção **Slack**.
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.
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.
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.
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.
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.
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:
| Campo | Descrição |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **App ID do Slack** | O App ID que você informou ao ativar o canal |
| **Bot User ID** | O id de usuário do próprio bot no Slack. A Jelou o resolve automaticamente a partir do bot token e o usa para ignorar as mensagens do próprio bot |
| **Bot User OAuth Token** | Mascarado e não copiável |
| **Signing Secret** | Mascarado e não copiável |
| **Request URL** | A URL para a qual seu app do Slack envia eventos e interações, com botão para copiá-la |
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:
| Bloco | Disponível | Limite |
| ------- | ---------- | ------------------------- |
| Texto | Sim | 3000 caracteres |
| Imagem | Sim | JPEG e PNG, até 5 MB |
| Botões | Sim | Máximo de 10 por mensagem |
| Lista | Sim | Máximo de 10 opções |
| CTA URL | Sim | Enviado como link |
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.