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

> [!NOTE]
>
> 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)

> [!WARNING]
>
> 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.

> [!TIP]
>
> 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.

> [!NOTE]
>
> 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.

> [!TIP]
>
> 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*

> [!NOTE]
>
> 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:

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

> [!WARNING]
>
> 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

> [!TIP]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.