Slack
Visão geral
A integração com o Slack permite que sua equipe interaja com o agente de IA do Buildprint diretamente do Slack. Mencione @Buildprint em qualquer canal ou thread autorizado e o agente responderá com conhecimento do seu app Bubble — lendo logs, revisando alterações recentes, sugerindo correções e muito mais.
O agente opera como um membro específico do workspace (o usuário "run-as"), utilizando suas chaves de API e permissões. Todas as conversas ocorrem em threads do Slack e também ficam visíveis no histórico de chat do Buildprint.
Conectando o Slack
Vá em Settings → Integrations → Slack no seu workspace do Buildprint.
Clique em Connect Slack workspace. Um pop-up solicitará que você autorize o Buildprint em seu workspace do Slack.
Uma vez autorizado, você verá o nome do seu workspace do Slack e o status da conexão.
Quem pode conectar? Apenas proprietários (owners) e administradores (admins) do workspace podem conectar ou gerenciar a integração com o Slack.
Reconectando: Se o Buildprint adicionar novos recursos que exijam permissões adicionais do Slack, você poderá ver um aviso para reconectar. Clique em Reconnect para reautorizar com as permissões atualizadas. Suas configurações de canal serão preservadas.
Configurando o agente
Após a conexão, configure estes ajustes na página de integração do Slack:
Run as user — O membro do workspace cujas chaves de API o agente utilizará. Deve ser um proprietário ou administrador com credenciais de provedor de IA ativas (Claude, OpenAI ou OpenCode).
Model — Qual modelo de IA o agente utiliza (ex: Claude Sonnet, GPT-4o). Os modelos disponíveis dependem de quais provedores o usuário "run-as" conectou.
Reasoning effort — Controla o quanto o modelo "pensa" antes de responder. Um esforço maior produz respostas mais completas, mas leva mais tempo. Opções: None, Low, Medium, High.
Agent mode — Quando definido como Build, o agente opera no modo Build e pode fazer edições no seu app Bubble. Quando definido como Plan, o agente opera no modo Plan (apenas leitura). Isso exige que o recurso de edição esteja habilitado para o seu workspace.
Modos de acesso aos canais
Você controla quais canais do Slack podem mencionar o agente do Buildprint e quais projetos o agente pode acessar em cada canal. Existem três modos de acesso no nível do workspace:
Permissões por canal (padrão)
A opção mais restritiva. Você adiciona explicitamente cada canal que deve ter acesso e configura quais projetos o agente pode ver em cada um deles.
Canais não adicionados à lista não podem usar o bot — as menções serão ignoradas.
Todos os canais públicos, canais privados específicos
Uma opção equilibrada. O agente responde automaticamente em qualquer canal público para o qual for convidado, com acesso a todos os projetos. Canais privados devem ser explicitamente adicionados e configurados, assim como no modo por canal.
Isso é útil quando você deseja acesso amplo em canais públicos, mas controle rigoroso sobre discussões privadas.
Todos os canais, todos os projetos
A opção mais permissiva. O agente responde em qualquer canal (público ou privado) onde for convidado, com acesso a todos os projetos no workspace. Nenhuma configuração por canal é necessária.
Gerenciando permissões de canal
Ao usar Per-channel permissions ou a parte de canais privados de All public, custom private:
Clique em Manage channels para ver os canais disponíveis para os quais o bot foi convidado.
Adicione canais individualmente ou use Select all.
Para cada canal, escolha:
Selected projects — Selecione projetos específicos que o agente pode acessar neste canal.
All projects — O agente pode acessar todos os projetos no workspace a partir deste canal.
Remova um canal clicando no botão ×.
Nota: O bot deve ser convidado para um canal do Slack antes de aparecer na lista de canais. No Slack, digite /invite @Buildprint no canal que você deseja usar.
Como funcionam as conversas
Quando alguém menciona @Buildprint em uma mensagem:
O bot adiciona uma reação 👀 para mostrar que está processando a solicitação.
Ele lê o contexto ao redor — mensagens recentes do canal ou o histórico completo da thread.
Ele resolve quais projetos o agente pode acessar com base na configuração do canal.
A IA gera uma resposta e a publica como uma réplica na thread.
A reação 👀 é removida assim que a resposta é postada.
Se você mencionar o bot novamente na mesma thread, ele continuará a mesma conversa com o contexto completo do que foi discutido anteriormente.
Anexos de arquivos
Você pode anexar arquivos (screenshots, PDFs, documentos, etc.) ao mencionar o bot. O agente baixará e analisará esses arquivos como parte de sua resposta.
Limites:
Máximo de 30 MB por arquivo individual
Máximo de 100 MB no total por mensagem
Arquivos que excederem esses limites são ignorados silenciosamente — o agente ainda responderá à parte de texto da sua mensagem.
Solução de problemas
O bot não responde quando mencionado
O bot foi convidado para o canal? Digite
/invite @Buildprintno canal.O canal está autorizado? Se estiver usando permissões por canal, certifique-se de que o canal foi adicionado em Settings → Integrations → Slack.
O canal tem projetos atribuídos? O agente não responderá se não tiver projetos para trabalhar. Adicione pelo menos um projeto ao escopo do canal.
A chave de API do usuário "run-as" ainda está ativa? Verifique se o usuário possui credenciais de provedor válidas para o modelo selecionado.
O bot diz que o canal não está autorizado
Isso significa que o workspace está usando permissões por canal e este canal ainda não foi adicionado. Peça a um administrador do workspace para configurar as permissões de canal do Buildprint nas configurações de integração do Slack. Além disso, garanta que o administrador do workspace do Slack aprovou o aplicativo, se necessário.
O bot diz que não há projetos disponíveis
Ou não existem projetos no workspace, ou o escopo do canal está definido para projetos específicos que foram excluídos. Atualize a configuração de projetos do canal.
Vejo um aviso de "reconnect"
O Buildprint adicionou novos recursos que exigem permissões adicionais do Slack. Clique em Reconnect para reautorizar. Sua configuração de canal existente será preservada.
O bot pode acessar projetos que não deveria
Verifique o modo de acesso do seu workspace. Se definido como All channels, all projects, o bot tem acesso a tudo. Mude para Per-channel permissions ou All public, custom private para um controle mais granular.