> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://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-`.

> [!WARNING]
>
> 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 |

> [!NOTE]
>
> 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](https://docs.strattum.ai/data-pipelines/local-development.md)**
>
> Configure o ambiente local completo com Prefect, worker e Docker Compose.

> **[Quickstart — Data Pipelines](https://docs.strattum.ai/data-pipelines/quickstart)**
>
> Ative conectores via Console strattum.ai sem precisar de ambiente local.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.