Use fluxos de trabalho compartilhados no Slack

O Slack permite que uma equipe execute os mesmos fluxos de trabalho públicos onde solicitações e decisões já acontecem. Mencione o Okou em um canal para trabalho visível ou use uma mensagem direta para rascunhos privados e análises sensíveis.

O fluxo de trabalho ainda pertence a um agente Okou. O Slack determina onde a conversa ocorre; não altera a instrução do fluxo, conexões ou modelo de permissões.

1. Instale o Okou no workspace do Slack

Um Admin do workspace configura a integração compartilhada:

1. Abra a página onde os canais ou superfícies de trabalho do Okou são gerenciados.
2. Encontre Slack e selecione Instalar no Slack.
3. Escolha o workspace do Slack desejado.
4. Revise e aprove as permissões solicitadas pelo Slack.
5. Conclua a instalação e retorne ao Okou.

Se você não for um Admin do workspace, o produto exibirá Peça ao seu admin para instalar a integração do Slack. Sua organização no Slack também pode exigir que um Admin do Slack aprove o aplicativo.

Instale o aplicativo uma vez para o workspace. Cada membro conecta sua própria identidade Okou para que mensagens e execuções sejam atribuídas à pessoa correta.

2. Conecte cada membro

Após a instalação no workspace:

1. Abra a integração do Slack no Okou.
2. Selecione Conectar.
3. Complete a conexão com a conta do Slack.
4. No Slack, abra a página inicial do app Okou ou use /okou connect se o Slack solicitar o vínculo da conta.

O comando de barra principal atual é /okou.

3. Adicione o Okou a um canal

Convide @Okou para cada canal onde a equipe deseja que ele atue. O Okou só pode ler e responder em canais aos quais foi adicionado.

Use o menor conjunto útil de canais. Um fluxo de suporte pode precisar apenas de #support-triage; um fluxo de lançamento pode precisar apenas de #launch-room.

Para trabalho privado, abra uma mensagem direta com o Okou em vez de adicioná-lo a um canal compartilhado.

4. Selecione o agente correto

O agente selecionado determina qual função, fluxos de trabalho públicos, conexões e permissões estarão disponíveis para uma nova conversa no Slack.

Use:

• /okou switch para escolher o agente da próxima conversa;
• /okou model para escolher o modelo quando essa opção estiver disponível;
• os controles da página inicial do app Okou quando preferir um seletor visual.

As escolhas de agente e modelo são fixadas quando um tópico do Slack é criado. Alterá-las não modifica um tópico já existente. Inicie uma nova menção de nível superior quando precisar de outro agente para trabalhos não relacionados.

5. Invoque um fluxo de trabalho compartilhado

Mencione o Okou e informe o nome do fluxo de trabalho ou o resultado desejado. Inclua o input e qualquer destino ou restrição de aprovação que a execução necessite.

Nome explícito do fluxo de trabalho:

Okou run qualify-inbound-lead para esta mensagem.
Crie o resumo e um rascunho de resposta. Não envie.

Solicitação em linguagem natural:

Okou qualifique este lead recebido usando nosso processo compartilhado.
Publique o resumo neste tópico e crie um rascunho de e-mail para revisão.

Quando uma solicitação depende da conversa atual do Slack, mencione o Okou a partir dessa mensagem ou tópico para que o contexto relevante permaneça vinculado.

6. Mantenha os acompanhamentos no mesmo tópico

O Okou responde a uma menção em canal em um tópico. Continue correções e acompanhamentos relacionados ali. Esse tópico é uma conversa com seu próprio contexto.

Inicie uma nova menção de nível superior quando:

• a tarefa não for relacionada;
• outro agente deva ser responsável;
• o tópico atual contém contexto que não deve ser levado adiante;
• a equipe deseja uma trilha de revisão separada.

Isso mantém o tráfego do canal legível e evita que instruções de tarefas não relacionadas se misturem.

Canal, tópico ou DM?

Não coloque informações confidenciais em um canal público apenas porque o fluxo de trabalho é público. A visibilidade do fluxo e das mensagens são diferentes.

Exemplo: um fluxo de triagem de bugs compartilhado

Considere que o workspace possui um fluxo público triage-bug-report em um agente de Produto público.

1. Um colega publica uma captura de tela e descrição em #bug-report.
2. Ele escreve: @Okou run triage-bug-report on this message. Draft the GitHub issue, but ask before creating it.
3. O Okou aplica as regras compartilhadas de reprodução, severidade, verificação de duplicidade e formatação de issues.
4. O colega revisa o rascunho no tópico do Slack.
5. Após aprovação, o Okou cria o issue usando o acesso autorizado do GitHub desse membro e responde com o link.
6. Se o mesmo campo ausente aparecer repetidamente, o proprietário do fluxo atualiza a instrução pública para futuros relatórios.

A equipe compartilha o método de triagem e a trilha de revisão. O membro que aprova a ação ainda usa sua própria identidade e permissões concedidas.

Solução de problemas

O Okou não responde

• Confirme se o app está instalado no workspace do Slack desejado.
• Confirme se @Okou é membro do canal.
• Conecte sua conta Okou.
• Tente /okou help para verificar os comandos disponíveis.

O Okou usa o agente errado

Execute /okou switch, escolha o agente desejado e inicie uma nova menção de nível superior. Um tópico existente mantém o agente selecionado quando foi criado.

O fluxo de trabalho não pode ser encontrado

Confirme que o fluxo é Público, que o agente proprietário é público e que a conversa do Slack está direcionada a esse agente. Veja Compartilhe fluxos de trabalho com sua equipe.

Falta permissão de um conector

Abra o prompt de autorização, confirme a conta e conceda apenas a permissão necessária. Fluxos compartilhados não herdam acesso ao Gmail, GitHub, Notion ou outros serviços de outro membro.

O resultado foi para o lugar errado

Informe o destino na solicitação ou instrução do fluxo, como “responder neste tópico”, “me envie por DM” ou “apenas criar rascunho”. Atualize o fluxo público se o destino deva ser o mesmo para toda execução.

Para o comportamento completo da integração com o Slack, veja Slack. Para agendamentos e entregas automáticas no Slack, veja Automações.