Slack

Para a maioria dos times, é no Slack que o trabalho acontece — onde os bugs são reportados, onde as decisões são debatidas, onde alguém diz "alguém resume essa thread?" e quatro pessoas a abrem.

O Okou encontra você ali. Depois de instalado, o Okou é um app do Slack que você pode @mencionar em qualquer canal ou chamar por DM. Os mesmos workflows, os mesmos conectores, as mesmas permissões do app web — só que dentro da conversa do seu time.

Instalação

1. Abra a página Where Okou works no seu espaço de trabalho e clique em Add to Slack.
2. Escolha o workspace do Slack e conceda os escopos que o Okou pede:
   • Ler mensagens de canais e DMs onde ele for adicionado
   • Publicar mensagens e reações
   • Ler informações de perfil (para marcar e se dirigir às pessoas)
   • Enviar arquivos (para artefatos anexados)
3. Convide @Okou para os canais onde ele deve atuar. O Okou só vê mensagens dos canais para os quais foi convidado.

Se o seu workspace do Slack exige aprovação de admin para apps novos, o pedido de instalação vai para um admin do Slack. A página Where Okou works mostra o status.

Como usar o Okou no Slack

Três padrões principais, todos funcionando sem nenhuma configuração além da instalação:

@Okou em qualquer canal. O Okou responde em uma thread, mantendo o canal limpo. Use para tarefas que o time deve ver:

"Okou resuma as últimas 50 mensagens desta thread e publique os itens de ação como lista numerada."

Chamar o Okou por DM. Para trabalho privado, rascunhos, ou qualquer coisa que você não queira divulgar. A DM se comporta como um chat web — várias mensagens de ida e volta, log completo, arquivos suportados. Uma DM é uma conversa contínua, não uma série de perguntas soltas, e cada agente mantém o próprio histórico quando você alterna entre eles.

Invocar um workflow pelo nome. "Okou triage-bug-report" — o Okou carrega o workflow nomeado e o executa sobre a thread ou o contexto da mensagem atual. Útil quando você já montou workflows em torno do trabalho recorrente de um canal.

Slack e Web Chat são a mesma conversa

Mensagens enviadas do Slack passam pelo mesmo pipeline do app web. Uma thread do Slack aparece no Web Chat, onde você pode acompanhar, buscar ou retomar — e uma mensagem que começou no Slack carrega um link Slack · Open message ↗ de volta ao original.

Dois comandos de barra controlam o roteamento:

• /okou switch — escolher qual agente responde
• /okou model — escolher qual modelo faz o trabalho

Os dois se fixam quando uma thread é criada, então valem para a próxima thread que você abrir em vez de reescrever aquela em que você já está. Responder dentro de uma thread do Slack cria a própria conversa paralela.

Workflows comuns no Slack

Os padrões que o time do Okou usa todo dia:

• Triagem de bugs no #bug-report. Alguém joga uma captura de tela. "Okou tria isso." O Okou extrai os passos de reprodução, abre uma issue no GitHub e responde com o link.
• Resumo de thread. Uma thread enorme aconteceu enquanto você dormia. "Okou resuma esta thread e me diga o que eu deveria fazer." O Okou condensa 100 mensagens em cinco tópicos e uma ação recomendada.
• Registro de decisões. "Okou registre a decisão desta thread na nossa página de decisões no Notion." O Okou escreve uma entrada estruturada: contexto, decisão, responsável, data.
• Digests de canal agendados. Uma automação agendada roda toda segunda e publica uma retrospectiva da semana no #engineering ou no #cs. Veja Automations.
• Rascunhos de resposta a clientes. Conecte Gmail, Front ou Zendesk e deixe o Okou observar a chegada de e-mails de clientes. Quando algo chega, o Okou rascunha uma resposta na sua voz e manda por DM para você aprovar.
• Pesquisa no meio da reunião. Alguém num huddle do Slack cita um concorrente. @Okou faça um resumo sobre [Concorrente] — cinco tópicos. Dois minutos depois o resumo está na thread.

Etiqueta e convenções

Alguns hábitos que funcionam melhor que outros, pelo que os times acabam adotando:

• Responda na thread. Quando você @Okou em um canal, o Okou responde em uma thread. Mantenha os desdobramentos na mesma thread — isso é um chat só. Para trabalho sem relação, comece uma nova menção no nível do canal.
• Seja específico sobre o destino da saída. "Me manda DM" ou "publica no #cs-replies" — destinos vagos embaralham o resultado.
• Use DMs para trabalho sensível. Rascunhos de respostas a clientes, ações financeiras ou análises privadas pertencem às DMs, não a canais compartilhados.
• Não adicione o Okou a canais de que ele não precisa. As permissões são delimitadas por canal; minimizar o acesso é mais limpo.

Permissões no Slack

As permissões do Slack são delimitadas por workspace, não por canal. O Okou só pode ler canais dos quais é membro, mas as ações que ele realiza (publicar, reagir, enviar arquivo) seguem as mesmas regras.

Se você remover o Okou de um canal:

• ele perde imediatamente a capacidade de ler o histórico daquele canal
• não pode mais publicar nem reagir ali
• os logs de chat antigos continuam mostrando as mensagens que o Okou viu enquanto era membro

Para restringir o Okou a um único canal sensível sem dar a ele o resto do workspace, você pode instalar um segundo Okou em um workspace do Slack separado; essa é a saída certa para casos que exigem muito isolamento.

Armadilhas comuns

• O Okou não responde. Verifique se ele foi convidado para o canal. Verifique a saúde da conexão na página Where Okou works.
• Respostas no lugar errado. Se um workflow publica no canal errado, edite a instrução dele para nomear o destino explicitamente.
• Permissão negada. Quando o Okou precisa de um conector que não está autorizado, ele manda uma DM para quem pediu, com um link de autorização. Não ignore essas DMs.
• Instalações duplicadas do Okou. Se um workspace tem o Okou instalado várias vezes (sessões OAuth diferentes), uma prevalece. A página Where Okou works mostra qual.

O que vem a seguir

• Veja Workflows para capturar o trabalho recorrente de um canal.
• Veja Automations para publicar digests sem ninguém pedir.
• Veja Permissions para o que o Okou pode e não pode fazer no seu Slack.