Slack

Com o app do Kadu instalado no Slack, você conversa com o agente numa thread: pede para listar Tasks, executar uma delas, acompanhar o andamento, cancelar ou pedir um ajuste. Status, pendências, resultado e arquivos de cada execução chegam na mesma thread.

Instalar

Em Configurações → Slack, clique em Instalar no Slack e autorize o app no workspace. Uma organização pode ter mais de um workspace instalado. Um workspace do Slack fica ligado a uma organização só.

Quem instala direto pelo Slack, sem passar pelo console, recebe do bot uma mensagem direta com o botão Conectar conta Kobana. O login liga o Slack à organização ativa da sua conta (o seu papel precisa permitir editar a organização). Quem ainda não tem organização no Kadu cai no cadastro. Uma instalação que não for ligada a nenhuma organização em 14 dias é removida.

Conectar a Conta Kobana

Todo usuário do bot usa a própria Conta Kobana. Na primeira mensagem, o bot responde só para você com o botão Conectar conta Kobana: faça login e volte ao Slack, que o bot continua com o seu pedido.

• A conexão vale 7 dias. Depois, o bot pede para fazer login de novo. No último dia, ele avisa na primeira mensagem que você mandar.
• O acesso é o do seu papel na organização, o mesmo do console. Sem convite para a organização, o bot não responde.
• Para desconectar, escreva desconectar para o bot.
• Removido da organização ou desativado no Slack, a conexão cai sozinha.

Executar uma Task

Peça em linguagem natural: "roda a baixa de pagamentos de ontem no ambiente Produção". O bot confere a Task e os parâmetros e publica um card de confirmação com Task, ambiente, data de referência, parâmetros e secrets faltando. Nada executa até alguém clicar em Executar. O card vale 15 minutos.

Pode confirmar quem pediu ou outro membro com permissão de executar. Se a conexão de quem clicou venceu, o clique não vale: faça login e confirme de novo.

Cancelar uma execução e pedir ajuste numa Task conversacional também passam por card.

Arquivos de entrada

Task que recebe arquivo (planilha, extrato, PDF) usa os anexos da própria thread: anexe o arquivo na conversa e peça a execução. O card mostra os arquivos que vão junto.

• Vale anexo de até 100 MB. Link externo (Google Drive, por exemplo) não conta: anexe o arquivo em si.
• Só entram arquivos anexados na mesma thread e ainda não usados por outra execução. Cada arquivo vai para uma execução só, como no console.
• O anexo só é guardado depois que a sua Conta Kobana está conectada. Se você anexar antes de conectar, o bot guarda depois da conexão.

O que aparece na thread

Mensagem	Quando
Status	uma mensagem fixa, editada com o passo atual, o tempo decorrido e as pendências abertas
Marcos	passo concluído, aviso e erro, cada um numa mensagem
Pendência	cada pendência nova, com o botão Resolver
Resultado	no fim: status, resumo, duração e preço
Arquivos	os arquivos de saída, como link para o console ou anexados (ver abaixo)

A execução continua mesmo se a sua conexão vencer no meio: status, resultado e arquivos seguem chegando.

Pedir ajuste

Em Task conversacional, responda na thread depois que a execução terminar: "refaz considerando só os boletos". O bot publica o card de ajuste; confirmado, a nova rodada segue na mesma thread.

Configurar

Cada workspace instalado tem três ajustes em Configurações → Slack:

Ajuste	Padrão	O que faz
Onde o bot responde	mensagem direta e canal privado	também conversa em grupo, canal público e canal compartilhado com outra empresa (Slack Connect)
Arquivos de saída	só link para o console	anexa na thread até o tamanho máximo (até 100 MB); acima disso, link
Detalhe na thread	só marcos	também um resumo dos logs da execução

Canal público e Slack Connect expõem resultado e arquivos a mais gente: ative só se a organização decidiu isso. Em canal compartilhado, pessoas de outra empresa nunca usam o bot, mesmo com Conta Kobana.

Uma Task pode fixar o modo de arquivos no Playbook, em metadata.slack.files_mode (link ou upload) do bloco task:.

Em canal, mencione o bot (@Kadu) para começar. Na thread em que ele já publicou um card ou uma execução, não precisa mencionar de novo.

Consumo

Cada mensagem respondida é medida e cobrada como uma execução: tokens × preço do nível das conversas, no mesmo consumo do mês, na mesma franquia de créditos e no mesmo teto. Sem plano, franquia ou saldo, o bot avisa e não responde. Cada conversa tem um limite de gasto e cada pessoa pode mandar até 20 mensagens por minuto. Ver Plano e custos.

Remover

Remover em Configurações → Slack revoga o app no workspace: o bot para de responder e as conexões de conta são desfeitas. Desinstalar pelo próprio Slack tem o mesmo efeito.

A mesma configuração está na API: GET, PATCH e DELETE em /v1/organizations/{id}/slack_installations.