Como Ligar o HappyCapy ao Slack: O Poder de um Agente de IA em Cada Canal
Socket Mode, acesso total a ferramentas, memória por tópico — o HappyCapy torna-se o agente de IA da tua equipa dentro do Slack.
O Slack tem 32 milhões de utilizadores ativos diários. A maioria dos bots do Slack responde a perguntas. A integração do HappyCapy com o Slack faz algo fundamentalmente diferente: executa tarefas. Quando o mencionas com @, ele pode escrever e executar código, gerar imagens, pesquisar na web, criar ficheiros e entregar resultados finalizados — tudo dentro de uma thread do Slack. Sem mudar de separador. Sem copiar e colar resultados. Apenas uma mensagem que entra e um resultado que sai.
A Diferença de Arquitetura
A maioria das integrações do Slack exige que exponhas um URL de webhook público, configures certificados SSL e mantenhas um servidor acessível a partir da internet pelo Slack. Isso são três problemas de infraestrutura antes sequer de escreveres uma linha de lógica de negócio.
O HappyCapy usa o Socket Mode. Em vez de o Slack contactar o teu servidor, o bot abre uma ligação WebSocket de saída para a infraestrutura do Slack. Não há nenhum URL público para configurar. Nenhum certificado SSL para gerir. Nenhuma regra de firewall para abrir. Executas a skill, ela liga-se e mantém-se ligada.
A segunda diferença é onde o bot vive. O HappyCapy corre numa sandbox Linux persistente na Fly.io — com acesso root, Python 3.11, Node.js v24, sempre ativa. Quando o teu bot recebe uma mensagem, não está a iniciar uma função serverless que expira em 10 segundos. Tem um ambiente completo disponível: sistema de ficheiros persistente, acesso à rede, processos de longa duração.
A terceira diferença é a forma como responde. Cada resposta do HappyCapy volta para a mesma thread do Slack onde a mensagem teve origem. Os canais mantêm-se limpos. As equipas não se afogam em ruído de bots. O histórico da conversa por thread é guardado e reenviado com cada nova mensagem, para que o bot mantenha contexto ao longo de toda uma sessão numa thread — sabe o que foi discutido 20 mensagens atrás.
| Capacidade | Bot típico do Slack | Bot do Slack do HappyCapy |
|---|---|---|
| Requer URL público | Sim | Não (Socket Mode) |
| Ambiente de execução | Serverless / limitado | Sandbox Linux sempre ativa |
| Contexto de thread | Normalmente 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 Podes Fazer
Dizer que um bot do Slack "tem acesso total a ferramentas" é fácil. Eis o que isso significa realmente na prática.
Escrever e executar código, e devolver resultados. Pede ao bot para processar um ficheiro CSV que deixes no canal, executar um script de análise em Python e publicar os resultados de volta como uma tabela formatada. Ele escreve o código, executa-o na sandbox e responde com o resultado.
Gerar imagens numa thread. Solicita um mockup de produto gerado por IA diretamente a partir de uma mensagem do Slack. O bot chama a geração de imagem, carrega o ficheiro e publica-o na thread — sem sair do Slack para usar uma ferramenta separada.
Pesquisar na web e resumir. Pede-lhe para recolher os preços mais recentes da página de um concorrente e resumir as diferenças em relação ao que tu cobras. Ele acede à página, lê-a 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 que abrangem revisão de código, geração de conteúdo, análise de dados, SEO, investigação de mercado e centenas de outros fluxos de trabalho. Todas elas estão disponíveis a partir de uma mensagem no Slack.
Usar mensagens diretas para sessões privadas com o agente. O bot funciona em mensagens diretas da mesma forma que funciona em canais. Uma DM privada com o bot torna-se um espaço de trabalho pessoal de IA dentro do Slack — histórico de conversa, acesso total a ferramentas, sem audiência.
Invocar a partir de qualquer canal. Não há configuração por canal. Adiciona o bot a #engineering, #marketing e #data simultaneamente. Cada equipa recebe as mesmas capacidades completas.
Vantagens
- Não é necessário URL público nem infraestrutura — o Socket Mode trata da ligação
- Acesso total a Bash e ao sistema de ficheiros dentro da sandbox do HappyCapy
- A memória por thread mantém as conversas de várias interações coerentes
- Acesso a todos os principais modelos de IA, não apenas a um
- Mais de 300.000 Skills disponíveis a partir de qualquer @menção
- Funciona em canais, DMs de grupo e DMs 1:1
- As respostas vão para as threads, mantendo os canais legíveis
- Sem limites de comprimento de mensagem nas respostas — os resultados voltam completos
Casos de Uso Reais
Equipa de engenharia — revisão de código e depurador de CI em #dev. Uma equipa de engenharia cola um log de CI com falhas 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 equipa tem uma resposta revisível na mesma thread onde levantou o problema, sem abrir outro separador ou mudar de contexto.
Equipa de marketing — geração de conteúdo a partir do Slack. Uma gestora de marketing deixa numa thread uma lista de funcionalidades do produto e pede ao HappyCapy para escrever cinco rascunhos de publicações para o LinkedIn. Ele devolve-as na mesma thread, identificadas por abordagem (educativa, provocadora, orientada a histórias). A gestora escolhe uma, pede uma versão revista e fica com uma publicação finalizada pronta a agendar — tudo a partir da thread do Slack.
Fundador solo — assistente pessoal em DMs. Um fundador usa as DMs do HappyCapy como o seu sistema operativo. Briefing matinal: pede um resumo das notícias da noite sobre um concorrente. Preparação pré-chamada: pede-lhe para recolher o histórico de financiamento recente da empresa. Pós-reunião: deixa as notas 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 referido na thread desta semana.
Equipa de dados — scripts de análise rápida em #data. Um analista de dados descreve uma transformação de que precisa num conjunto de dados e menciona o bot com @. O HappyCapy escreve o script em pandas, confirma a lógica na resposta, e o analista copia-o diretamente. Para equipas que querem que o bot execute o script sobre um ficheiro que carregam, também trata disso — de ponta a ponta dentro da thread.
Como Configurar
A configuração demora cerca de cinco minutos. A skill completa está disponível em github.com/ndpvt-web/happycapy-slack.
Os passos principais:
1. Criar uma app do Slack. Vai a api.slack.com/apps e cria uma nova app. Escolhe "From scratch." Dá-lhe um nome e seleciona o teu workspace.
2. Ativar o Socket Mode. Em "Settings → Socket Mode," ativa-o. O Slack vai gerar um App-Level Token com o âmbito connections:write. Copia-o — vais precisar dele como SLACK_APP_TOKEN.
3. Adicionar âmbitos ao bot. Em "OAuth & Permissions → Bot Token Scopes," adiciona: app_mentions:read, chat:write, channels:history, groups:history, im:history, mpim:history, channels:read, groups:read, im:read, files:write.
4. Ativar Event Subscriptions. Em "Event Subscriptions," ativa e subscreve os eventos de bot: app_mention, message.im.
5. Instalar a app. Em "OAuth & Permissions," instala a app no teu workspace. Copia o Bot User OAuth Token como SLACK_BOT_TOKEN.
6. Executar a skill. Na tua sandbox do HappyCapy, define SLACK_BOT_TOKEN e SLACK_APP_TOKEN como variáveis de ambiente e executa a skill do Slack. O bot liga-se via Socket Mode e começa a escutar de imediato.
Sem implementação de servidor. Sem domínio. Sem SSL. A sandbox do HappyCapy trata de tudo — se preferires executá-lo a partir da tua própria máquina, a configuração num Mac Mini como servidor persistente funciona exatamente da mesma forma (consulta 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 âmbitos de bot necessários estão disponíveis no plano gratuito do Slack. Podes configurar e executar o bot do Slack do HappyCapy num workspace gratuito sem restrições.
Funciona tanto em DMs como em canais? Sim. O bot responde a @menções em canais públicos, canais privados, DMs de grupo e mensagens diretas 1:1. O comportamento é idêntico em todos os contextos — acesso total a ferramentas, histórico por thread.
Como funciona o contexto de conversa entre vários utilizadores num canal? O contexto é por thread. Se vários membros da equipa estiverem a falar com o bot na mesma thread, o histórico completo da thread é enviado com cada mensagem, para que o bot veja tudo. Se duas threads separadas estiverem a decorrer em simultâneo num canal, cada uma tem o seu próprio histórico isolado. Os utilizadores não podem ver nem afetar as threads separadas uns dos outros.
Posso restringir quais canais ou utilizadores podem invocar o bot? Sim. A skill suporta uma lista de permissões de IDs de canais e IDs de utilizadores. As mensagens de canais ou utilizadores que não estejam na lista são ignoradas silenciosamente. Por predefinição, o bot responde a tudo o que consegue ver, pelo que adicionar restrições é uma alteração de configuração de um único passo.
O bot precisa de um URL público? Não. Esta é a vantagem central da arquitetura. O Socket Mode significa que o bot abre um WebSocket de saída para o Slack — o Slack nunca precisa de contactar o teu servidor. Não é necessário nenhum URL público, nenhum certificado SSL, nem qualquer configuração de firewall.
O que acontece se eu o mencionar com @ numa thread — ele vê as mensagens anteriores? Sim. Quando mencionas o HappyCapy com @ numa thread, a skill obtém o histórico completo da thread a partir da API do Slack e inclui-o no contexto enviado ao bot. Ele vê todas as mensagens da thread desde o início, pelo que tem contexto completo para o teu pedido.
Toda a minha equipa pode partilhar um único bot do HappyCapy? Sim. Um único token de bot funciona em todos os canais e DMs do teu workspace. Toda a tua equipa pode mencionar o mesmo bot com @ em simultâneo. Cada thread mantém o seu próprio contexto, pelo que o uso simultâneo por vários membros da equipa não causa mistura de contextos.
Considerações Finais
A maioria das integrações do Slack fica-se pela obtenção de informação — conseguem procurar coisas, mas não conseguem agir. A skill do Slack do HappyCapy ultrapassa essa linha. Traz o ambiente de execução completo — sistema de ficheiros, Bash, todos os principais modelos de IA, mais de 300.000 Skills — diretamente para a camada de comunicação já existente da tua equipa. O resultado é um agente de IA que vive onde a tua equipa já trabalha, sem exigir que ninguém mude de contexto para uma ferramenta separada.
