Como Conectar o HappyCapy ao Slack: O Poder de um Agente de IA em Cada Canal
Socket Mode, acesso total a ferramentas, memória por thread — o HappyCapy se torna o agente de IA da sua equipe dentro do Slack.
O Slack tem 32 milhões de usuários ativos diários. A maioria dos bots do Slack responde perguntas. A integração do HappyCapy com o Slack faz algo fundamentalmente diferente: ela executa tarefas. Quando você o menciona com @, ele pode escrever e executar código, gerar imagens, pesquisar na web, criar arquivos e entregar resultados prontos — tudo dentro de uma thread do Slack. Sem trocar de aba. Sem copiar e colar resultados. Apenas uma mensagem enviada e um resultado entregue.
A Diferença de Arquitetura
A maioria das integrações do Slack exige que você exponha uma URL de webhook pública, configure certificados SSL e execute um servidor que o Slack possa alcançar pela internet. Isso já são três problemas de infraestrutura antes mesmo de você escrever uma única linha de lógica de negócio.
O HappyCapy usa o Socket Mode. Em vez de o Slack acessar seu servidor, o bot abre uma conexão WebSocket de saída para a infraestrutura do Slack. Não há URL pública para configurar. Nenhum certificado SSL para gerenciar. Nenhuma regra de firewall para abrir. Você executa a skill, ela se conecta e permanece conectada.
A segunda diferença é onde o bot vive. O HappyCapy roda em um sandbox Linux persistente na Fly.io — acesso root, Python 3.11, Node.js v24, sempre ativo. Quando seu bot recebe uma mensagem, ele não está iniciando uma função serverless que expira em 10 segundos. Ele tem um ambiente completo disponível: sistema de arquivos persistente, acesso à rede, processos de longa duração.
A terceira diferença é como ele responde. Toda resposta do HappyCapy volta para a mesma thread do Slack onde a mensagem se originou. Os canais permanecem limpos. As equipes não se afogam em ruído de bot. O histórico de conversa por thread é armazenado e encaminhado a cada nova mensagem, de modo que o bot mantém o contexto ao longo de toda uma sessão em uma thread — ele sabe o que foi discutido 20 mensagens atrás.
| Capacidade | Bot típico do Slack | Bot do Slack do HappyCapy |
|---|---|---|
| Requer URL pública | Sim | Não (Socket Mode) |
| Ambiente de execução | Serverless / limitado | Sandbox Linux sempre ativo |
| Contexto de thread | Geralmente nenhum | Histórico por thread |
| Pode executar código | Não | Sim, Bash completo |
| Ferramentas disponíveis | Integrações fixas | Mais de 300.000 Skills |
| Acesso a modelos de IA | Um modelo | Todos os principais modelos |
O Que Você Pode Fazer
Dizer que um bot do Slack "tem acesso completo a ferramentas" é fácil. Aqui está o que isso realmente significa na prática.
Escrever e executar código, retornar resultados. Peça ao bot para processar um arquivo CSV que você soltou no canal, executar um script de análise em Python e postar os resultados de volta como uma tabela formatada. Ele escreve o código, executa no sandbox e responde com o resultado.
Gerar imagens em uma thread. Solicite um mockup de produto gerado por IA diretamente de uma mensagem do Slack. O bot chama a geração de imagem, faz o upload do arquivo e o publica na thread — sem sair do Slack para usar uma ferramenta separada.
Pesquisar na web e resumir. Peça para ele buscar os preços mais recentes da página de um concorrente e resumir as diferenças em relação ao que você cobra. Ele acessa a página, lê e responde com uma comparação estruturada.
Acionar qualquer uma das mais de 300.000 Skills. O HappyCapy vem com mais de 300.000 Skills — capacidades especializadas cobrindo revisão de código, geração de conteúdo, análise de dados, SEO, pesquisa de mercado e centenas de outros fluxos de trabalho. Todas elas estão disponíveis a partir de uma mensagem do Slack.
Usar DMs para sessões privadas de agente. O bot funciona em mensagens diretas da mesma forma que funciona em canais. Uma DM privada com o bot se torna um espaço de trabalho pessoal de IA dentro do Slack — histórico de conversa, acesso completo a ferramentas, sem plateia.
Invocar a partir de qualquer canal. Não há configuração por canal. Adicione o bot a #engineering, #marketing e #data simultaneamente. Cada equipe recebe as mesmas capacidades completas.
Prós
- Nenhuma URL pública ou infraestrutura necessária — o Socket Mode cuida da conexão
- Acesso completo a Bash e sistema de arquivos dentro do sandbox do HappyCapy
- A memória por thread mantém as conversas de múltiplas interações coerentes
- Acesso a todos os principais modelos de IA, não apenas um
- Mais de 300.000 Skills disponíveis a partir de qualquer @menção
- Funciona em canais, DMs em grupo e DMs individuais
- As respostas vão para as threads, mantendo os canais legíveis
- Sem limite de tamanho de mensagem nas respostas — os resultados voltam completos
Casos de Uso Reais
Equipe de engenharia — revisão de código e depurador de CI em #dev. Uma equipe de engenharia cola um log de CI com falha na thread e menciona o HappyCapy com @. Ele lê o stack trace, identifica o teste que falhou, sugere uma correção e escreve o bloco de código corrigido. A equipe tem uma resposta revisável na mesma thread onde levantou o problema, sem abrir outra aba ou trocar de contexto.
Equipe de marketing — geração de conteúdo a partir do Slack. Um gerente de marketing cola uma lista de recursos do produto em uma thread e pede ao HappyCapy para escrever cinco rascunhos de posts para o LinkedIn. Ele os retorna na mesma thread, marcados por ângulo (educacional, provocativo, orientado a histórias). O gerente escolhe um, pede uma versão revisada e tem um post finalizado pronto para agendar — tudo a partir da thread do Slack.
Fundador solo — assistente pessoal em DMs. Um fundador usa as DMs do HappyCapy como seu sistema operacional. Briefing matinal: pede um resumo das notícias da noite sobre um concorrente. Preparação pré-chamada: pede para ele buscar o histórico recente de captação de recursos da empresa. Pós-reunião: cola as anotações e pede uma lista de ações estruturada. O histórico por thread significa que o contexto da conversa da semana passada está disponível quando referenciado na thread desta semana.
Equipe de dados — scripts de análise rápida em #data. Um analista de dados descreve uma transformação que precisa fazer em um conjunto de dados e menciona o bot com @. O HappyCapy escreve o script em pandas, confirma a lógica na resposta e o analista o copia diretamente. Para equipes que querem que o bot execute o script em um arquivo que elas enviam, ele também faz isso — de ponta a ponta dentro da thread.
Como Configurar
A configuração leva cerca de cinco minutos. A skill completa está disponível em github.com/ndpvt-web/happycapy-slack.
Os passos de alto nível:
1. Crie um app do Slack. Acesse api.slack.com/apps e crie um novo app. Escolha "From scratch." Dê um nome a ele e selecione seu workspace.
2. Habilite o Socket Mode. Em "Settings → Socket Mode," ative-o. O Slack gerará um App-Level Token com o escopo connections:write. Copie-o — você precisará dele como SLACK_APP_TOKEN.
3. Adicione escopos de bot. Em "OAuth & Permissions → Bot Token Scopes," adicione: app_mentions:read, chat:write, channels:history, groups:history, im:history, mpim:history, channels:read, groups:read, im:read, files:write.
4. Habilite Event Subscriptions. Em "Event Subscriptions," habilite-a e inscreva-se nos eventos de bot: app_mention, message.im.
5. Instale o app. Em "OAuth & Permissions," instale o app no seu workspace. Copie o Bot User OAuth Token como SLACK_BOT_TOKEN.
6. Execute a skill. No seu sandbox do HappyCapy, defina SLACK_BOT_TOKEN e SLACK_APP_TOKEN como variáveis de ambiente e execute a skill do Slack. O bot se conecta via Socket Mode e começa a escutar imediatamente.
Sem implantação de servidor. Sem domínio. Sem SSL. O sandbox do HappyCapy cuida de tudo — se você quiser executá-lo a partir da sua própria máquina, a configuração em um Mac Mini como servidor persistente funciona exatamente da mesma forma (veja Mac Mini as an AI Server in 2026 para o contexto completo sobre configurações locais persistentes).
Perguntas Frequentes
Preciso de um plano pago do Slack? Não. O Socket Mode e os escopos de bot necessários estão disponíveis no plano gratuito do Slack. Você pode configurar e executar o bot do Slack do HappyCapy em um workspace gratuito sem restrições.
Funciona tanto em DMs quanto em canais? Sim. O bot responde a @menções em canais públicos, canais privados, DMs em grupo e mensagens diretas individuais. O comportamento é idêntico em todos os contextos — acesso completo a ferramentas, histórico por thread.
Como funciona o contexto de conversa entre múltiplos usuários em um canal? O contexto é por thread. Se vários membros da equipe estiverem conversando com o bot na mesma thread, o histórico completo da thread é enviado a cada mensagem, de modo que o bot vê tudo. Se duas threads separadas estiverem rodando simultaneamente em um canal, cada uma tem seu próprio histórico isolado. Os usuários não podem ver ou afetar as threads separadas uns dos outros.
Posso restringir quais canais ou usuários podem invocar o bot? Sim. A skill suporta uma lista de permissões (allowlist) de IDs de canais e IDs de usuários. Mensagens de canais ou usuários que não estão na lista são silenciosamente ignoradas. Por padrão, o bot responde a tudo que consegue ver, então adicionar restrições é uma mudança de configuração de uma única etapa.
O bot precisa de uma URL pública? Não. Essa é a principal vantagem de arquitetura. Socket Mode significa que o bot abre um WebSocket de saída para o Slack — o Slack nunca precisa alcançar seu servidor. Não há URL pública, nenhum certificado SSL e nenhuma configuração de firewall necessária.
O que acontece se eu mencionar o bot com @ em uma thread — ele vê mensagens anteriores? Sim. Quando você menciona o HappyCapy com @ em uma thread, a skill busca o histórico completo da thread na API do Slack e o inclui no contexto enviado ao bot. Ele vê cada mensagem da thread desde o início, então tem contexto completo para sua solicitação.
Minha equipe inteira pode compartilhar um único bot do HappyCapy? Sim. Um único token de bot funciona em todos os canais e DMs do seu workspace. Toda a sua equipe pode mencionar o mesmo bot com @ simultaneamente. Cada thread mantém seu próprio contexto, então o uso simultâneo por vários membros da equipe não causa mistura de contexto.
Considerações Finais
A maioria das integrações do Slack para na recuperação de informações — elas conseguem buscar coisas, mas não conseguem agir. A skill do Slack do HappyCapy cruza essa linha. Ela traz o ambiente de execução completo — sistema de arquivos, Bash, todos os principais modelos de IA, mais de 300.000 Skills — diretamente para a camada de comunicação já existente da sua equipe. O resultado é um agente de IA que vive onde sua equipe já trabalha, sem exigir que ninguém troque de contexto para uma ferramenta separada.
