Saltar para o conteúdo principal
Traga o Replit Agent para as conversas onde sua equipe trabalha. Mencione @Replit em um canal ou envie uma mensagem direta para fazer perguntas, trabalhar em projetos existentes e colaborar com seus colegas nos canais do Slack. O Replit responde no Slack, compartilha o progresso enquanto trabalha e fornece um link para abrir o chat no Replit. Você conecta o bot a um workspace do Replit e, em seguida, cada colega vincula sua própria conta do Replit. O Replit usa as permissões da conta vinculada ao processar uma solicitação.
Este guia aborda como conversar com o Replit Agent pelo Slack. Para permitir que o Agent pesquise ou envie mensagens do Slack como uma ferramenta, configure o connector do Slack separadamente. Consulte Gerenciar connectors.

O que você pode fazer

  • Mantenha sua equipe informada. Receba respostas e atualizações de progresso na thread do Slack em que você fez a solicitação.
  • Trabalhe em projetos existentes. Aponte o Replit para um projeto ou repositório conectado e descreva as alterações desejadas.
  • Use ferramentas conectadas. Peça ao Replit para trabalhar com informações de ferramentas disponíveis para sua conta e seu workspace, como Linear ou Notion.
  • Faça perguntas sobre sua base de código. Obtenha a explicação de um recurso, investigue um bug ou entenda como parte do seu aplicativo funciona.
  • Comece um projeto a partir de uma ideia. Peça ao Replit para criar uma ferramenta interna, um site ou um app e, em seguida, abra o projeto no Replit para continuar.
Por exemplo:
O acesso a projetos, repositórios e ferramentas conectadas depende das suas permissões no Replit e das conexões que você configurou.

Como funciona

Uma nova thread do Slack inicia um chat do Replit. Solicitações de acompanhamento nessa thread continuam o mesmo chat, para que você possa refinar o pedido sem recomeçar. O Replit publica suas respostas e o progresso na thread. Selecione View in Replit para abrir o chat associado no navegador. Algumas etapas, como revisar uma escolha detalhada ou concluir a configuração de outra ferramenta, podem pedir que você continue no Replit. Em canais, mencione o bot em toda solicitação, inclusive nas de acompanhamento. Em mensagens diretas, escreva para ele sem mencionar. Responda na mesma thread da DM para continuar uma tarefa; uma nova DM de nível superior inicia um chat separado.
Cada thread está vinculada à pessoa que iniciou sua sessão do Replit. Outros membros do canal podem ler as respostas, mas não podem assumir essa sessão nem responder aos pedidos de aprovação dela. Para fazer a própria solicitação, devem mencionar o Replit em uma nova thread.
Os exemplos neste guia usam @Replit. Se o seu workspace escolher um handle diferente, use esse nome.

Configure o Replit no Slack

A configuração tem duas partes: instalar o bot do workspace e, depois, conectar suas contas pessoais do Slack e do Replit.

Antes de começar

Você precisa de:
  • Um workspace de equipe do Replit com o recurso do Slack habilitado.
  • Uma conta verificada do Replit com acesso a esse workspace.
  • Permissão para adicionar o bot no Replit e instalar apps no workspace de destino do Slack.
Editores do workspace e funções superiores podem criar o bot. Admins do workspace gerenciam alterações em um bot existente. Seu workspace do Slack também pode exigir que um administrador aprove a instalação.

1. Adicione o bot do workspace

  1. No Replit, mude para o workspace que você quer usar.
  2. Abra Settings → Workspace overview.
  3. Em External platforms, selecione Manage ao lado de Slack.
Configurações do workspace com o Slack em External platforms
  1. Informe um Slack handle. Esse é o nome que os colegas vão mencionar, como @Replit.
  2. Selecione Add to Slack e siga o fluxo de autorização no Slack. Se o Replit mostrar Continue in Slack, selecione-o para concluir a autorização.
Instalação do app do Slack e solicitação de permissões
  1. Revise as permissões solicitadas e autorize a instalação no workspace do Slack pretendido.
  2. Volte ao Replit e aguarde o status do bot mostrar Installed. A configuração pode levar alguns minutos.
Se o status mostrar Needs admin approval, aguarde o administrador do Slack aprovar o app. Depois, volte ao painel de configuração do Slack e selecione Finish install.

2. Vincule sua conta do Replit

Cada colega conclui esta etapa individualmente.
  1. Abra uma DM com o bot ou convide-o para um canal e mencione-o com uma solicitação.
  2. O Replit envia um aviso privado para conectar sua conta. Selecione o botão de vinculação de conta.
  3. Faça login no Replit, se necessário. Depois de entrar, volte ao Slack e selecione o botão de vinculação de conta novamente.
  4. Em Connect your Slack account, confira a conta do Replit e o workspace exibidos.
  5. Selecione Allow para conectar as contas e volte ao Slack.
O Replit retoma a solicitação original após a vinculação. Se não retomar, envie a solicitação novamente. A vinculação de conta exige sua confirmação mesmo que os e-mails do Slack e do Replit sejam iguais. Se forem diferentes, o Replit mostra um aviso. Continue somente se as duas contas forem suas. O aviso de vinculação de conta expira após dez minutos. Se expirar, ou se você atualizar a página de confirmação, volte ao Slack para abrir o link novamente. Envie uma nova mensagem ao bot se precisar de um novo aviso.

Usando o Replit no Slack

Em um canal

Convide o bot para o canal e mencione-o com uma solicitação específica. O Replit só lê o contexto dos canais do Slack aos quais você concedeu acesso. Não presuma que o Replit lê mensagens anteriores do canal, a menos que você peça explicitamente no seu prompt.
O Replit responde em uma thread. Continue por lá, mencionando-o novamente:
Replit respondendo a uma solicitação em uma thread de canal do Slack

Em uma mensagem direta

Abra a aba Messages do bot no Slack e envie uma solicitação. Não é necessário mencionar:
Mantenha os acompanhamentos na mesma thread para preservar o chat. Cada nova mensagem de nível superior na sua DM inicia um chat separado, que você pode continuar no Slack ou no Replit.
Chat de mensagem direta com o Replit no Slack

Responda perguntas e revise ações

Quando o Replit precisa de uma resposta, ele pode mostrar botões ou um formulário no Slack. Responda por lá quando disponível. Para solicitações que exigem uma interface mais rica, use o link para continuar no Replit. Somente a pessoa que iniciou a sessão pode responder às perguntas ou aprovar as ações dela. Se o Slack rejeitar uma resposta, tente novamente ou abra o chat no Replit.

Abra os resultados no Replit

Use View in Replit para revisar o chat, abrir um projeto ou acessar resultados que precisam do navegador. Arquivos gerados compatíveis também podem aparecer como anexos do Slack. Quando não for possível anexar um arquivo, use o link do Replit.
Chat do Slack aberto no Replit

Use comandos de barra

O bot do workspace oferece um comando de barra baseado no handle dele. Os exemplos abaixo presumem o handle @Replit. Se o seu workspace usa um handle diferente, substitua /replit por esse nome. As respostas dos comandos são visíveis apenas para você. Use menções ou DMs para pedir ao Agent que execute um trabalho.

Permissões e visibilidade

Instalar o bot não dá a todos os membros do Slack acesso ao seu workspace do Replit. Cada pessoa precisa vincular uma conta elegível do Replit, e as solicitações são verificadas de acordo com o acesso dessa pessoa. O app do Slack solicita permissões para receber menções e mensagens, responder em threads, mostrar o status de trabalho, identificar usuários, trabalhar com arquivos e adicionar reações. O bot do workspace também solicita permissão para oferecer comandos de barra. Revise a tela de autorização do Slack antes de instalar. O bot responde a solicitações endereçadas a ele. Mensagens comuns do canal não se tornam solicitações ao Agent. Pesquisar o histórico do Slack ou usar o Slack como uma ferramenta conectada é uma capacidade separada, com sua própria conexão e permissões.
Respostas e arquivos publicados em um canal ficam visíveis para quem tem acesso a esse canal. Escolha o canal com cuidado antes de pedir ao Replit para trabalhar com informações confidenciais. O acesso ao chat ou ao projeto no Replit continua seguindo as permissões do Replit.

Gerencie a conexão

Volte para Settings → Workspace overview → External platforms → Slack para gerenciar o bot e sua conta vinculada.

Altere o handle do bot

Um admin do workspace pode editar o Slack handle, selecionar Save changes e concluir a autorização no Slack. O comando de barra do bot muda junto com o handle.

Atualize ou reinstale o app

Se Update app aparecer, um admin do workspace pode usá-lo para aplicar uma atualização disponível do app. O Slack pode exigir aprovação para novas permissões. Se alguém remover o app no Slack, o Replit mostra Uninstalled. Use Reinstall e conclua a autorização do Slack para reconectá-lo.

Desvincule sua conta

Selecione Unlink na seção da conta ou execute /replit unlink no Slack. Se o seu workspace usa um handle de bot diferente, substitua /replit por esse nome. A próxima solicitação exigirá que você vincule novamente. Os chats existentes mantêm o proprietário original.

Remova o bot do workspace

Um admin do workspace pode selecionar Remove from Slack, confirmar a remoção e concluir a etapa de autorização do Slack. Remover o bot exclui o app do Slack gerenciado por ele. Os chats permanecem no Replit, e os vínculos de conta pessoal salvos são mantidos. Remover o bot e desvincular sua conta pessoal são ações separadas.

Solução de problemas

Não vejo o Slack nas configurações

Verifique se você selecionou o workspace de equipe do Replit pretendido e verificou o endereço de e-mail da sua conta. Peça a um admin do workspace para verificar se o Slack está disponível em External platforms. Se ele também não aparecer para o admin, entre em contato com a Ajuda do Replit para verificar a disponibilidade no seu workspace.

O Replit não responde em um canal

Verifique se o bot está instalado, foi convidado para o canal e foi mencionado na sua mensagem. Solicitações de acompanhamento em um canal também precisam de uma menção. Procure um aviso privado de vinculação de conta.

A instalação está aguardando aprovação

Um administrador do Slack precisa aprovar o app. Após a aprovação, volte ao Replit e selecione Finish install. Se a aprovação foi negada, resolva isso com seu administrador antes de usar Ask again.

Minha página de vinculação de conta é inválida ou expirou

Volte ao Slack e selecione o botão de vinculação de conta novamente. Se o link expirou, envie uma mensagem ao bot para receber um novo aviso. Se você precisou fazer login no Replit, abra o link do Slack novamente depois de entrar.

O Replit diz que a thread pertence a outra pessoa

Inicie uma nova thread e mencione o bot nela. Uma sessão não pode ser transferida para outro colega. Se você vinculou uma conta diferente do Replit, inicie uma nova thread para trabalhar com essa conta. As threads existentes continuam associadas à conta usada quando foram iniciadas.

Uma pergunta ou resultado pede que eu abra o Replit

Algumas interações precisam do navegador. Selecione View in Replit para continuar com o mesmo chat. Para obter ajuda com problemas de configuração não resolvidos, acesse a Ajuda do Replit.