​
Introdução

Este guia explica passo a passo como desenvolver, configurar e hospedar um bot do Slack na Square Cloud. Usaremos boas práticas de segurança e mostraremos exemplos em Node.js (Bolt) e Python (Bolt for Python).

​
Pré-requisitos Essenciais

  • Conta no Slack: Você precisará de uma conta e de permissões para criar apps no Slack. Crie ou acesse sua conta em https://slack.com/.
  • Conta na Square Cloud: Registre-se via https://squarecloud.app/pt-br/signup para hospedar seu bot.
  • Plano pago ativo: Bots que exigem recursos contínuos normalmente precisam de um plano pago. Verifique nossos planos.

​
Criando o App no Slack

  1. Acesse o API do Slack - Your Apps e clique em “Create New App”.
  2. Escolha “From scratch”, dê um nome ao app e selecione o workspace onde irá instalá-lo.
  3. Anote o Signing Secret (em “Basic Information”) e crie um Bot Token na seção “OAuth & Permissions” obtendo o scope apropriado para o que seu bot fará (ex.: chat:write, channels:read, commands, app_mentions:read).
Segurança: Nunca exponha o Signing Secret ou o Bot Token publicamente. Trate-os como credenciais sensíveis.

​
Exemplos de Implementação

Use as seções abaixo conforme a linguagem escolhida. Ambos os exemplos demonstram um bot que responde a menções ou comandos simples.
Configuração do Ambiente Node.js
  1. Verifique se o Node.js está instalado.
  2. Inicialize um projeto e instale dependências:
Terminal
npm init -y
npm install @slack/bolt
  1. Crie um arquivo index.js com o seguinte conteúdo:
index.js
const { App } = require('@slack/bolt');

const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  token: process.env.SLACK_BOT_TOKEN,
});

// Responde quando mencionado
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Obrigado por mencionar!`);
});

// Comando slash exemplo
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start(process.env.PORT || 3000);
  console.log('⚡️ Slack Bolt app is running!');
})();
Observação: na Square Cloud, defina as variáveis de ambiente SLACK_SIGNING_SECRET e SLACK_BOT_TOKEN no painel da aplicação.

​
Configuração do Arquivo Square Cloud

Aprenda sobre: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é utilizado para definir nome, versão, arquivo principal e variáveis de ambiente da sua aplicação. Inclua as variáveis SLACK_SIGNING_SECRET e SLACK_BOT_TOKEN no painel ou no arquivo de configuração conforme necessário.

​
Campo START

Em geral o campo START não é necessário se seu aplicativo iniciar a partir do arquivo padrão (index.js ou app.py) e utilizar as variáveis de ambiente. Use START apenas para scripts de inicialização personalizados.

​
Upload do Projeto para a Square Cloud

Depois de preparar os arquivos, compacte o projeto (incluindo package.json ou requirements.txt e squarecloud.app) e faça o upload pelo Dashboard ou CLI.
Acesse o Dashboard da Square Cloud e envie o ZIP do projeto.

​
Testando o Bot

  1. No painel do Slack App, em “OAuth & Permissions”, instale o app no workspace.
  2. Se o bot expõe endpoints (por exemplo, para eventos ou comandos), configure a URL de Request URL nas seções “Event Subscriptions” e “Slash Commands” apontando para a URL pública da sua aplicação (Square Cloud fornece o domínio após deploy).
  3. Teste menções no canal ou o comando /hello para validar respostas.
Exemplo de link de instalação (substitua o client_id): 
https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​
Recursos Adicionais

Para aprofundar, consulte a documentação oficial do Slack: Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão.