Slack

Configure o conector Slack para sincronizar mensagens de canais com a plataforma strattum.ai.

O conector Slack sincroniza mensagens dos canais que você seleciona com a infraestrutura strattum.ai. As mensagens aparecem no Data Catalog e alimentam o contexto de comunicação interna no Memory e no Knowledge.

Capacidades

• Sincroniza o histórico de mensagens dos canais monitorados.
• Coleta threads e respostas, com contagem de replies por mensagem.
• Autenticação via Bot Token do Slack.

Objetos suportados

Cada canal monitorado vira um recurso no formato channel__{channel_id}.

Objeto	O que vem
messages	Mensagens do canal com ts, user, text, thread_ts, reply_count, type, subtype e bot_id

Pré-requisitos

Workspace Slack

Acesso a um workspace Slack com permissão para instalar apps.

Slack App com Bot Token

Um app do Slack com Bot Token e os escopos de leitura. O passo a passo está abaixo.

Configuração

1. Crie um Slack App

   Acesse api.slack.com/apps e clique em Create New App → From scratch. Dê um nome como strattum-sync e selecione o workspace.

2. Adicione os Bot Token Scopes

   Em OAuth & Permissions → Scopes → Bot Token Scopes, adicione:

   channels:history
   channels:read
   groups:history
   users:read
   
3. Instale o app e copie o Bot Token

   Clique em Install to Workspace e autorize. Copie o Bot User OAuth Token, que começa com xoxb-.

   O Bot Token concede leitura ao workspace. Guarde-o em local seguro e nunca o comite em repositórios.

4. Convide o bot para os canais

   Em cada canal a monitorar, digite /invite @strattum-sync. O bot só lê canais dos quais é membro.

5. Adicione o conector no Console

   No menu lateral do Console, clique em Conectores → + Nova Conexão e selecione Slack. Preencha os campos:

   • Nome do Conector — identificador na lista de conectores (Obrigatório)
   • Bot Token — token xoxb-... gerado na instalação (Obrigatório)
   • Canais — os canais a monitorar (Obrigatório)

Autenticação e escopos

A autenticação é por Bot Token (xoxb-) do Slack.

Escopo	Para que serve
channels:history	Ler o histórico de mensagens de canais públicos
channels:read	Listar canais e ler seus metadados
groups:history	Ler o histórico de canais privados dos quais o bot é membro
users:read	Resolver os IDs de usuário das mensagens

A lista de escopos acima cobre o caso comum de leitura de canais. Confirme os escopos exatos exigidos pela sua instalação com o time [verificar].

Frequência de sync

O conector sincroniza a cada 30 minutos. A primeira execução após a ativação roda como sample sync (amostra) e, ao concluir, o ciclo completo passa a rodar no schedule padrão.

Limitações conhecidas

• O bot só lê canais dos quais é membro; um canal sem o /invite não sincroniza.
• As mensagens trazem o user como ID do Slack; a resolução para nome depende do objeto de usuário.
• Anexos e arquivos não são baixados — apenas o texto e os metadados da mensagem são coletados.
• Editar a conexão substitui as credenciais por completo; não há atualização parcial.

Troubleshooting

Sintoma	Causa provável	O que fazer
not_in_channel	Bot não é membro do canal	Rode /invite @strattum-sync no canal
Canal não sincroniza mensagens	Bot não convidado ou canal privado sem escopo	Convide o bot e confirme groups:history para canais privados
invalid_auth	Bot Token inválido ou revogado	Reinstale o app e atualize o token no conector
missing_scope	Falta um Bot Token Scope	Adicione o escopo em OAuth & Permissions e reinstale o app

Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.