Crie um Agente Slack em 10 Minutos com o Novo Slack Agent Skill da Vercel

Por Que Isso Importa: O Estado Atual dos Bots no Slack

Se você já tentou criar um bot pro Slack, sabe o drama: configurar OAuth, lidar com event subscriptions, endpoints de webhook, e ainda pensar em deploy. A infraestrutura muitas vezes tomava mais tempo que a lógica do bot em si.

O novo Slack Agent Skill da Vercel muda isso. É um wizard CLI que funciona com qualquer assistente de código (Claude Code, Cursor, etc.) pra criar, configurar e fazer deploy de um agente Slack em uma única sessão. Chega de ficar editando manifest, secrets e tunel ngrok manualmente.

Isso faz parte de uma tendência maior: plataformas estão embutindo inteligência de deploy diretamente no fluxo de desenvolvimento. Se você acompanhou a evolução do React Compiler v1.0 e memorização automática, vai notar a mesma filosofia — reduzir a carga cognitiva movendo complexidade pra ferramenta.

Como o Slack Agent Skill Funciona

O wizard te guia por cinco estágios, tudo automatizado:

1. Project Setup – Escolha seu provedor de LLM e inicialize a partir do Slack Agent Template.
2. Slack App Creation – Gere um manifest personalizado e crie o app no console do Slack.
3. Environment Configuration – Configure secrets, tokens e chaves de API com validação.
4. Local Testing – Rode localmente com ngrok e verifique a integração.
5. Production Deployment – Faça deploy na Vercel com variáveis de ambiente configuradas automaticamente.

Pra começar, instale o skill e rode o wizard:

npx skills add vercel-labs/slack-agent-skill
# Depois invoque no seu assistente de código, ex: /slack-agent new

// Exemplo: Um agente Slack simples que responde a menções
// Esse código é gerado automaticamente pelo wizard
import { SlackAgent } from '@vercel/slack-agent';

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

agent.on('mention', async ({ event, say }) => {
  // Sua lógica aqui — o skill cuida de todo OAuth e webhook
  await say(`Olá <@${event.user}>! Sou seu assistente automatizado.`);
});

export default agent;

Limitações & Cuidados

• Dependência de Provedor LLM: O wizard suporta um conjunto limitado de provedores. Se você usa um modelo menos comum, talvez precise customizar o template.
• ngrok para Teste Local: O estágio de teste local depende do ngrok. Se você está atrás de um firewall corporativo rígido, pode precisar de uma alternativa.
• Preparação para Produção: O deploy na Vercel é simples, mas você ainda precisa monitorar rate limits, tratar erros e implementar logging.

Próximos Passos

Depois do deploy, considere:

• Adicionar comandos slash para workflows interativos.
• Integrar com APIs externas (CRM, tickets, etc.) usando Vercel Edge Functions.
• Usar o agente para disparar pipelines CI/CD ou executar queries no banco.

Pra entender melhor por que separar preocupações no seu tech stack é importante — especialmente quando combinando personalização e experimentação — veja nossa análise sobre por que stacks separadas para personalização e experimentação.

Passo a Passo com Código

Vamos ver o código gerado pelo wizard. Depois de rodar /slack-agent new no Claude Code, você terá uma estrutura assim:

slack-agent/
├── src/
│   ├── agent.js          # Lógica principal do agente
│   ├── handlers/         # Handlers de eventos (menções, mensagens, etc.)
│   └── config.js         # Variáveis de ambiente e secrets
├── vercel.json            # Configuração da Vercel
├── slack-manifest.yml     # Manifest do app Slack
└── package.json

// src/agent.js — Lógica principal do agente
// Esse arquivo é gerado automaticamente pelo Slack Agent Skill
import { App } from '@slack/bolt';

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  socketMode: false, // Usa modo HTTP para Vercel
  port: process.env.PORT || 3000,
});

// Lida com eventos de mensagem
app.message('olá', async ({ message, say }) => {
  // Responde quando alguém diz "olá" em um canal que o bot está
  await say(`E aí <@${message.user}>! Tudo bem?`);
});

// Inicia o app
(async () => {
  await app.start();
  console.log('⚡️ Agente Slack está rodando!');
})();

# slack-manifest.yml — Configuração do app Slack gerada automaticamente
# Você não precisa editar isso manualmente a menos que adicione novas permissões
display_information:
  name: Meu Agente
features:
  bot_user:
    display_name: Meu Agente
    always_online: true
  slash_commands:
    - command: /perguntar
      description: Faça uma pergunta ao agente
      usage_hint: "[sua pergunta]"
      should_escape: false
oauth_config:
  scopes:
    bot:
      - chat:write
      - commands
      - app_mentions:read
settings:
  event_subscriptions:
    request_url: https://seu-app.vercel.app/slack/events
    bot_events:
      - app_mention
      - message.channels
  interactivity:
    is_enabled: true
    request_url: https://seu-app.vercel.app/slack/events

Por Que Essa Abordagem Funciona

O wizard elimina as partes mais propensas a erro do desenvolvimento de bots Slack:

• Fluxo OAuth: O skill gera o manifest exato e lida com o redirect OAuth.
• Endpoints de Webhook: Configura as rotas corretas no deploy da Vercel.
• Secrets de ambiente: Valida tokens antes do deploy, prevenindo crashes em runtime.

Isso é parecido com a filosofia do React Compiler e memorização automática — deixe a ferramenta cuidar do boilerplate pra você focar no valor único da sua aplicação.

Dicas Práticas & Melhores Práticas

1. Comece pelo Template: Use o Slack Agent Template pra deployar um agente funcional imediatamente, depois customize.
2. Teste Local Primeiro: O estágio de teste local com ngrok pega 90% dos erros de configuração.
3. Monitore os Logs: Depois do deploy, veja os logs de função da Vercel pra capturar erros da API do Slack.
4. Segurança: Nunca commite seu arquivo .env. O wizard adiciona ao .gitignore automaticamente.

Limitações & Considerações

• Socket Mode Não Suportado: O skill atual usa modo HTTP, o que requer um endpoint público. Para grids Slack privados, talvez precise adaptar.
• Provedor LLM Único: O wizard atualmente padroniza pra OpenAI. Se prefere Anthropic ou modelos locais, vai precisar modificar o template.
• Custo de Deploy: As serverless functions da Vercel têm um tier gratuito, mas agentes com alto tráfego podem gerar custos.

O Que Vem Por Aí?

A Vercel está dando sinais de mais "skills" pra outras plataformas (Discord, Teams, WhatsApp). O padrão é claro: o futuro do desenvolvimento de bots é infraestrutura conversacional. Até 2026, espere que assistentes de código lidem com 80% do boilerplate pra qualquer integração de plataforma.

Se você se interessa por como isso se encaixa na conversa maior sobre separar preocupações no seu tech stack, leia nosso mergulho profundo sobre por que stacks separadas para personalização e experimentação.

Conclusão

O Slack Agent Skill da Vercel é um exemplo perfeito de infraestrutura como conversa. Em vez de ler docs e copiar-e-colar configurações, você simplesmente diz pro seu assistente de código o que quer, e o wizard cuida do resto.

Principais lições:

• O wizard reduz o tempo de setup de bot Slack de horas para minutos.
• É ideal para prototipagem, hackathons e ferramentas internas.
• Para produção, você ainda precisa tratar edge cases e monitoramento.

Ação prática: Teste hoje. Instale o skill com npx skills add vercel-labs/slack-agent-skill, rode /slack-agent new no Claude Code, e faça deploy do seu primeiro agente Slack antes do almoço.

Este artigo foi baseado no anúncio do changelog da Vercel.