Como Hospedar Bots do Slack

​

Introdução

​

Pré-requisitos

• Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
• Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​

Criando o projeto

​

Aplicação de Bot no Slack

1. Acesse o Slack API - Your Apps e clique em “Create New App”.
2. Escolha “From scratch” (Do zero), dê um nome ao aplicativo e selecione o workspace onde você irá instalá-lo.
3. Anote o Signing Secret (em “Basic Information”) e crie um Bot Token na seção “OAuth & Permissions”, adicionando os escopos apropriados para o seu bot (ex: chat:write, channels:read, commands, app_mentions:read).

​

Desenvolvendo o projeto

npm init -y
npm install @slack/bolt

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 me mencionar!`);
});

// Exemplo de comando de barra (slash command)
app.command('/ola', async ({ ack, respond }) => {
  await ack();
  await respond('Olá da Square Cloud!');
});

(async () => {
  await app.start(process.env.PORT || 3000);
  console.log('⚡️ O app Slack Bolt está rodando!');
})();

pip install slack_bolt

from slack_bolt import App
import os

app = App(
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET'),
    token=os.environ.get('SLACK_BOT_TOKEN')
)

@app.event('app_mention')
def handle_mention(event, say):
    user = event.get('user')
    say(f'<@{user}> Obrigado pela menção!')

@app.command('/ola')
def hello_command(ack, respond):
    ack()
    respond('Olá da Square Cloud!')

if __name__ == '__main__':
    app.start(port=int(os.environ.get('PORT', 3000)))

slack_bolt

​

Realizando o Deploy

​

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.

3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto no Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no painel.

4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador — você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​

Via CLI

npm install -g @squarecloud/cli

squarecloud update

curl -fsSL https://cli.squarecloud.app/install | bash

squarecloud auth login

squarecloud upload

squarecloud upload --file <caminho/para/zip>

squarecloud app status
squarecloud app logs

​

Testando o Bot

1. No painel do Slack App, em “OAuth & Permissions”, instale o aplicativo no workspace.
2. Se o bot expõe endpoints (para eventos ou comandos), configure a Request URL em “Event Subscriptions” e “Slash Commands” para apontar para a URL pública da sua aplicação (A Square Cloud fornece o domínio após o deploy).
3. Teste menções em um canal ou o comando /ola para validar as respostas.

https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​

Recursos Adicionais

• Bolt para JavaScript: https://docs.slack.dev/tools/bolt-js/
• Bolt para Python: https://docs.slack.dev/tools/bolt-python/

​

Contate-nos