> ## Documentation Index > Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt > Use this file to discover all available pages before exploring further. # Disponibilize o Slack > Prepare o ambiente, crie ou importe um App, autorize a instalação e confira uma conversa real no Slack. A aplicação **Slack** da Strattum é disponibilizada como um **App instalado no Slack** da empresa. Sua disponibilização combina os serviços da plataforma e a criação de cada App pelo Console. Ao concluir este guia, você terá um App autorizado e uma conversa conferida no Slack. Para quem vai apenas conversar com o App, encaminhe [Conecte sua conta](https://docs.strattum.ai/applications/slack/connect.md). ## Pré-requisitos | Requisito | Quem prepara | | - | - | | Acesso de administrador ao Console Strattum | Responsável pelo acesso da empresa | | Permissão para criar e instalar Apps no espaço de trabalho Slack escolhido | Administrador do Slack | | Gateway público por HTTPS, alcançável pelo Slack e pelos navegadores | Responsável técnico pela implantação | | Identity, serviço de IA, banco de dados e cofre de credenciais disponíveis | Responsável técnico pela implantação | | Modelo, ferramentas e fontes necessários às perguntas | Administrador da plataforma | | Conta Strattum e conta Slack para conferir o uso | Pessoa que fará o teste | O Console permite administrar Apps com uma conta que tenha o papel `owner`, `admin` ou `superadmin` reconhecido pela plataforma. ## Prepare o ambiente da plataforma As aplicações Slack e Anywhere compartilham o serviço `strattum-anywhere-gateway`. Esse nome técnico também é usado em uma instalação que disponibiliza somente a aplicação Slack. Os usuários conectam a conta pelo próprio App no Slack. No Starter, o interruptor técnico do serviço é `ANYWHERE_ENABLED`: | Valor | Efeito na implantação | | - | - | | `true` | Inclui o perfil do Gateway e o serviço de IA necessário ao atendimento | | `false` | Não inclui esse perfil por essa opção | Depois de ativar o serviço, crie o App pelo Console. Nome, comando, agente, credenciais e política de cada App são administrados por ele. | Configuração | Onde conferir | Finalidade | | - | - | - | | `GATEWAY_PUBLIC_URL` | Gateway / implantação | Endereço HTTPS alcançado pelo Slack e pelos usuários | | `GATEWAY_INTERNAL_URL` | Console | Comunicação interna do Console com a administração do Gateway | | `ANYWHERE_RUNTIME_URL` | Gateway | Comunicação com o serviço de IA | | `ANYWHERE_PG_DSN` | Gateway | Banco dos vínculos, perguntas e entregas | | `ANYWHERE_IDENTITY_API_URL` e `ANYWHERE_SERVICE_API_KEY` | Gateway | Consulta das conexões e operações de serviço protegidas | | Cliente e verificação de identidade `ANYWHERE_OIDC_*`, `ANYWHERE_JWKS_URL`, `ANYWHERE_JWT_ISSUER` e `ANYWHERE_JWT_AUDIENCE` | Gateway / Identity | Entrada dos usuários e verificação das contas | | Backend e permissões do cofre de credenciais | Implantação | Armazenamento das configurações e segredos de cada App | No Starter gerenciado, o endereço público deriva do domínio da instalação, como `https://anywhere.empresa.example`. Use os valores da sua implantação. Confira o DNS, o certificado e o acesso de rede antes de criar o App. ### Confira os retornos da identidade O cliente Strattum utilizado pelo Gateway precisa aceitar estes retornos, com a origem HTTPS real: ```text theme={null} https://anywhere.empresa.example/v1/slack/connect/identity/callback https://anywhere.empresa.example/v1/slack/connections/identity/callback ``` Eles fazem parte da lista `OAUTH_ANYWHERE_REDIRECT_URIS` do Identity. Preserve também os retornos já utilizados por esse cliente. No Identity, `SLACK_LINK_RETURN_URL` aponta para `https://anywhere.empresa.example/v1/slack/connections/return`. Esse é o retorno da conexão de fontes, separado dos retornos de login acima. O Starter deriva esses endereços do domínio. Uma alteração em uma implantação existente também precisa ser refletida no cliente de identidade registrado. ## Crie o App pelo Console Abra **Configurações → Aplicativos → Slack → Criar App**. O fluxo possui quatro etapas. **1. Identificar e criar** Preencha o nome no Slack, confira o comando e escolha um ícone, se desejar. Informe a **Credencial de configuração** e clique em **Criar App**. Aguarde a confirmação da criação antes de prosseguir. **2. Autorizar no Slack** Clique em **Autorizar no Slack**. Na aba aberta, confira o espaço de trabalho e as permissões solicitadas. Autorize e aguarde a confirmação no Console. O token do bot é recebido nessa autorização. **3. Associar agente, se necessário** Selecione um agente disponível para todo o espaço de trabalho Strattum ou use **Continuar sem agente** para manter o Company Brain padrão. **4. Testar conversa** Abra a conversa no Slack e envie uma pergunta real ao App. Conecte sua conta Strattum quando solicitado. No Console, confira o recebimento da pergunta, a resposta do agente e a publicação. Conclua depois da confirmação. | Campo de criação | Regra | | - | - | | **Nome no Slack** | Obrigatório; até 35 caracteres | | **Comando** | Obrigatório; prefixo `/company-brain-` e final de até 17 caracteres, com letras minúsculas sem acento, números e hífens internos | | **Ícone** | Opcional; pode usar o padrão ou uma imagem aceita pelo formulário | | **Credencial de configuração** | Necessária para a criação automática; emitida pelo Slack para a pessoa e o espaço de trabalho | O comando precisa estar disponível naquele espaço de trabalho. Confira o final antes de criar: depois da criação no Slack, ele fica fixo nesse cadastro. ### Obtenha a credencial de configuração 1. Abra [Your Apps no Slack](https://api.slack.com/apps). 2. Localize **Your App Configuration Tokens** e clique em **Generate Token**. 3. Escolha o espaço de trabalho em que o App será criado. 4. Copie o **Access Token** e informe-o no campo do Console. Essa credencial costuma começar com `xoxe.` e expira 12 horas após a geração. Ela é diferente do token do bot. Consulte a [referência de configuração de Apps do Slack](https://docs.slack.dev/app-manifests/configuring-apps-with-app-manifests/#managing-configuration-tokens). ## Alternativa: crie pelo manifesto e importe O **manifesto** é o arquivo com o nome, as permissões e os endereços que o Slack utilizará para o App. 1. Na primeira etapa, use **Criar manualmente pelo manifesto** para salvar o cadastro. 2. Copie ou baixe o manifesto desse cadastro. A prévia anterior ao salvamento ainda possui identificadores substituíveis. 3. Em [Your Apps no Slack](https://api.slack.com/apps), crie um App a partir desse manifesto no espaço de trabalho correto. 4. No Console, abra **Importar App criado manualmente**. 5. Preencha **App ID**, **Client ID**, **Client Secret** e **Signing Secret** do App criado. Esses dados ficam na área **Basic Information** do App no Slack. 6. Aguarde a importação e prossiga para **Autorizar no Slack**. Use o manifesto do próprio cadastro para manter os endereços de eventos, comandos e interatividade correspondentes. O Slack descreve a criação por arquivo em [Apps com manifesto](https://docs.slack.dev/app-manifests/configuring-apps-with-app-manifests/#creating-apps-using-manifests). ## Permissões solicitadas | Permissão do bot | Finalidade | | - | - | | `app_mentions:read` | Receber mensagens que mencionam o App | | `im:history` | Receber as mensagens diretas enviadas ao App | | `im:write` | Abrir mensagens diretas com as pessoas | | `chat:write` | Publicar mensagens e respostas | | `commands` | Receber o comando do App | | `reactions:write` | Mostrar o andamento na mensagem da pergunta | | `files:write` | Anexar os arquivos CSV gerados | | `channels:read` | Conferir informações básicas dos canais públicos | | `groups:read` | Conferir informações básicas dos canais privados em que o App participa | O login individual solicita `openid` para identificar a pessoa no Slack, em um processo separado da instalação do bot. As fontes consultadas na Strattum seguem suas próprias conexões e permissões. ## Antes de entregar à equipe Confira uma pergunta real por mensagem direta. Para disponibilizar canais, revise também a política e os documentos recebidos pelo cadastro e publique uma versão nova se precisar alterá-los. Consulte [Configure o comportamento do App](https://docs.strattum.ai/admin/slack/configuration.md). **Testar depois** mantém a instalação e permite retomar a verificação. Um diagnóstico de envio publica uma mensagem fixa e não substitui a pergunta real. Entregue à equipe o nome e o comando do App, o espaço de trabalho, a conta Strattum a utilizar e as orientações de rede. Encaminhe [Faça sua primeira pergunta](https://docs.strattum.ai/applications/slack/quickstart.md). ## Próximos passos > **[Entenda o Console](https://docs.strattum.ai/admin/slack/console.md)** > > Consulte a lista, as páginas do App e os estados apresentados. > **[Configure o comportamento](https://docs.strattum.ai/admin/slack/configuration.md)** > > Ajuste continuidade, retenção, agente e publicação em canais. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.