Skip to main content
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}.

​
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:
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.
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

​
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.