Skip to main content
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.

​
Pré-requisitos

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

​
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, 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.

​
Permissões solicitadas

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

​
Próximos passos

Entenda o Console

Consulte a lista, as páginas do App e os estados apresentados.

Configure o comportamento

Ajuste continuidade, retenção, agente e publicação em canais.