Bot do Slack para agentes de programação: integre seu Sharkly Agent ao Slack

TL;DR

Um bot do Slack para agentes de código é um app do Slack vinculado a um único agente de IA, de modo que mensagens diretas e menções se tornam conversas com o agente e toda resposta cai na mesma thread. No Sharkly, cada bot é vinculado a exatamente um Agent, e esse Agent responde com as instruções, o modelo, as skills e os repositórios que você configurou para ele.

1. Abra api.slack.com/apps, gere um App Configuration Token e copie o Refresh Token dele.
2. No Sharkly, abra Integrations, selecione Slack e escolha Connect Agent.
3. Escolha o Agent a vincular e, opcionalmente, dê um nome ao app (o Slack limita nomes de app a 35 caracteres).
4. Cole o Refresh Token e selecione Create & Install.
5. Aprove o prompt de OAuth na janela que o Slack abrir.
6. Aguarde o status do bot passar de Installing para Connected e então envie uma mensagem direta para ele.

Por que seus agentes de código devem responder no Slack

Seu time já usa agentes de código. Alguém tem o Claude Code aberto em um terminal, outra pessoa cria scripts para rodar o Codex, e a saída fica no histórico de shell de cada um. Enquanto isso, as perguntas que esses agentes poderiam responder são feitas no Slack, porque é no Slack que o time conversa.

Essa lacuna tem um custo. Quando um product manager pergunta por que o endpoint de exportação começou a falhar, a pergunta vai para um desenvolvedor, que pergunta a um agente e repassa a resposta de volta. O repasse adiciona uma hora a uma pergunta que o agente respondeu em noventa segundos.

O Sharkly fecha essa lacuna pelo lado da plataforma. O Sharkly não substitui o Claude Code, o Codex ou outras ferramentas de execução; ele adiciona a camada compartilhada de tarefas, contexto, controle e revisão ao redor delas. Sua integração com o Slack estende essa camada para dentro do seu workspace, para que os colegas recebam a resposta no mesmo lugar onde a pergunta foi feita.

Duas conexões, duas funções

A integração oferece dois tipos de conexão independentes, e confundi-los é a fonte mais comum de dúvidas:

São instalações separadas, sustentadas por apps do Slack distintos, e cada uma funciona sem a outra. Mais duas delimitações: um workspace do Slack se conecta a apenas uma organização do Sharkly por vez, e as ações do Slack dentro das automações de Space usam uma terceira conexão, na qual o Slack atua como ação, mas não pode iniciar um workflow nesta versão. Este guia aborda a vinculação de bot de Agent.

O que é um bot do Slack de Agent do Sharkly?

Um bot de Agent conecta um Agent do Sharkly a um app do Slack. As mensagens se tornam uma conversa com o Agent, e a resposta volta para a mesma DM ou thread. O Agent que responde é o mesmo colega configurado que ele é em todos os outros lugares do Sharkly: mesmas instruções, modelo, skills e conhecimento de repositórios.

A vinculação é estritamente um para um, e você pode vincular seus próprios Personal Agents, além dos Agents compartilhados no Space que você tem permissão para usar.

A instalação traz duas formas de interação. Mensagens diretas criam uma sessão de chat para aquele canal de DM, e as mensagens seguintes dão continuidade a ela, de modo que o Agent mantém o contexto em vez de começar do zero. Menções em canais removem a menção, enviam o restante ao Agent e respondem em uma thread que começa na sua mensagem.

@ReleaseShark summarize the decision in this thread and list the next steps

O Sharkly ignora mensagens de outros bots, eventos de mensagem editada e eventos de entrada em canais, o que evita loops de resposta quando vários apps compartilham um canal.

Como conectar um agente de IA ao Slack

Você precisa de um Agent que possa configurar (veja o guia de primeiros passos) e de permissão para gerar um App Configuration Token do Slack e instalar um app no time de destino.

1. Abra api.slack.com/apps e localize Your App Configuration Tokens.
2. Gere um App Configuration Token e copie o Refresh Token dele (documentação do Slack). Trate-o como segredo e envie-o apenas pelo formulário de conexão do Sharkly.
3. No Sharkly, abra Integrations e selecione Slack.
4. Selecione Connect Agent e escolha o Agent a vincular.
5. Opcionalmente, informe um nome para o app. Se deixar em branco, o nome do Agent será usado.
6. Cole o Refresh Token e selecione Create & Install.
7. Conclua a autorização OAuth do Slack na janela que abrir. Se nada aparecer, permita pop-ups e tente novamente.
8. Aguarde o status do bot mudar de Installing para Connected.

O Sharkly troca o refresh token por um token de acesso de configuração de curta duração, cria o app a partir de um manifesto que abrange a identidade do bot, a visualização do Slack Assistant, o redirecionamento OAuth, o callback e os escopos da Events API e, em seguida, abre o Slack para instalar o app.

Para verificar, envie uma DM ao bot. Uma resposta confirma todo o caminho: evento recebido, sessão criada, execução concluída, resposta entregue. Se o bot permanecer em Installing, o callback OAuth ainda não armazenou o token do bot; nesse caso, reabra a janela de instalação e conclua o prompt. Se o Agent não puder ser selecionado, ele já está vinculado a outro app.

Gatilhos do bot do Slack: menção, reação com emoji, qualquer mensagem

Por padrão, o bot responde a mensagens diretas e menções em canais, e nada mais. Nas configurações de Slack do Agent, cada gatilho é uma linha que você pode ativar ou desativar:

• Menção em um canal é o padrão. O Agent só é executado quando alguém menciona o bot, e a resposta aparece em uma thread abaixo da menção.
• Reação com emoji em um canal transforma uma reação em gatilho. Reaja com o emoji configurado e o bot abre uma thread com o contexto ao redor.
• Qualquer mensagem no canal executa o Agent em mensagens comuns nos canais que você escolher explicitamente. Não é possível aplicar a todos os canais, e outros apps que publicam neles podem disparar o gatilho.

O par de decisões que mantém isso sob controle: mantenha o modo somente menções nos canais compartilhados, onde gatilhos amplos geram ruído e expõem ao Agent contextos sem relação com ele. Ative Qualquer mensagem no canal apenas em um canal dedicado, onde todos esperam que as mensagens cheguem ao Agent. O gatilho por emoji fica entre esses extremos, já que nada chega ao Agent a menos que uma pessoa reaja de propósito.

Cada thread de canal é uma conversa própria com o Agent, então duas threads em um mesmo canal são duas sessões com contextos separados, e as pessoas podem dar continuidade a uma thread sem mencionar o bot novamente. O app também habilita o Slack Assistant, o painel que o Slack oferece para apps de IA.

Uma conversa no Slack não é uma Task

As conversas com o bot de Agent nunca criam Tasks por conta própria, e essa delimitação é intencional. A regra de chat versus atribuição de tarefa continua valendo sem alterações: converse quando precisar de uma resposta, atribua uma Task quando precisar de um resultado que alguém vai revisar.

Quando um Agent cria uma Task a partir do Slack, você pode vincular a thread atual ao mesmo tempo. Depois da vinculação, os comentários da tarefa e as mensagens da thread permanecem sincronizados. A vinculação de thread é o que faz essa integração valer a pena: uma discussão começa no Slack, vira uma Task e, a partir daí, progresso, impedimentos e resultados voltam para a Task, enquanto a thread se mantém atualizada para as pessoas que participaram da conversa.

Quando um bot do Slack é a ferramenta errada

Você só quer criação de Tasks e prévias de links. Use apenas a conexão de workspace. Slash commands, atalhos, linkbacks e unfurls vêm todos do app compartilhado.

Você quer mensagens de canal agendadas ou orientadas a eventos. Isso é uma ação do Slack dentro de um workflow de automação, não uma conversa. Como eventos do Slack não podem disparar workflows nesta versão, comece por um agendamento, uma mudança de status, uma palavra-chave em comentário ou um webhook.

O trabalho exige execução em um repositório com revisão no final. Atribua uma Task. Use o bot para perguntar; use as Tasks para construir.

Você quer um único bot representando todo o seu time. Essa vinculação não existe. Vários especialistas coordenando trabalho real pertencem a uma Crew trabalhando em uma Task, não a um canal cheio de bots.

Segurança e permissões

• O App Configuration Refresh Token é trocado durante a configuração e não é usado como token do bot instalado. O client secret, o signing secret e o token de bot OAuth gerados são criptografados em repouso.
• Os callbacks da Events API são verificados com o signing secret armazenado; assinaturas inválidas são rejeitadas e o tamanho dos corpos de evento é limitado.
• Revise os escopos solicitados antes de autorizar: menções, mensagens diretas, histórico de threads de canais públicos e privados, envio de mensagens, abertura de DMs e atualizações de status do Assistant.
• Owners e Admins gerenciam o workspace compartilhado e todas as vinculações; membros gerenciam as vinculações dos Agents que podem usar.

Desconectar não é destrutivo: o Agent deixa de receber mensagens por esse bot, mas o histórico do Slack permanece intacto e nenhuma mensagem passada se torna uma Task.

Conclusão

Um bot do Slack para agentes de código conquista seu espaço quando muda onde a conversa acontece sem mudar onde o trabalho vive. Vincule um Agent em que você já confia, mantenha o padrão de somente menções até que um canal peça mais e use a vinculação de thread no momento em que um chat virar trabalho. Se você ainda não tem um Agent, crie um primeiro.

Perguntas frequentes

Preciso conectar um workspace do Slack antes de vincular um bot de Agent?

Não. Os dois tipos de conexão são independentes. Você precisa da conexão de workspace apenas para criação de Tasks a partir do Slack, linkbacks, prévias de links e DMs de notificação da Inbox.

Um único bot do Slack pode atender vários Agents do Sharkly?

Não. Cada bot é vinculado a exatamente um Agent, e um Agent mantém apenas uma vinculação por vez. Para colocar vários Agents no Slack, crie um bot separado para cada um.

Conversar com o bot cria Tasks automaticamente?

Não. Quando uma conversa se transforma em trabalho que precisa de responsável, status ou revisão, crie a Task de forma deliberada. Se o Agent a criar a partir do Slack, você pode vincular a thread para que comentários e mensagens permaneçam sincronizados.

Uma mensagem do Slack pode iniciar um workflow de automação do Sharkly?

Não nesta versão. O Slack está disponível em workflows como ação, mas os gatilhos do Slack via Events API ainda não estão implementados.