> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectores — Visão Geral
> Conecte o strattum.ai às suas fontes de dados. Cada conector alimenta Data Pipelines, Memory e Knowledge automaticamente.
Conectores são as ligações entre o strattum.ai e as fontes de dados da sua empresa. Uma vez configurado, um conector mantém os dados sincronizados automaticamente — sem scripts manuais de ETL.
## Como o fluxo funciona
```
Fonte de dados → Conector → Data Pipelines → Data Catalog (raw/ e clean/)
↓
Memory Worker → grafo FalkorDB
Knowledge Worker → vetores Qdrant
```
Após a sincronização, os dados ficam disponíveis para Memory e Knowledge automaticamente, e chegam aos agentes via Skills e MCP.
***
## Conectores disponíveis
### Bancos de dados
Tabelas de bancos PostgreSQL, cloud ou on-premise, com carga incremental ou full refresh por tabela.
Tabelas de bancos MySQL, com seleção por tabela e carga incremental ou full refresh.
Coleções de bancos MongoDB (self-hosted ou Atlas), com schema inferido por amostragem.
Tabelas do data warehouse BigQuery, autenticadas via Service Account do Google Cloud.
### SaaS
Objetos de CRM do Salesforce para contexto de relacionamento no Memory.
Contatos, empresas e deals do HubSpot CRM, sincronizados incrementalmente.
Tickets, conversas, usuários, organizações e ratings de satisfação.
Issues, comentários, projetos e usuários do Jira Cloud.
Tasks, spaces, lists e membros do workspace ClickUp.
Mensagens dos canais selecionados para contexto de comunicação interna.
Registros das bases e tabelas selecionadas, com carga incremental por webhook.
### Financeiro
Clientes, cobranças, assinaturas e transferências do gateway de pagamentos Asaas.
### Documentos
Documentos e planilhas de pastas específicas do Google Drive para indexação no Knowledge.
Documentos de sites do SharePoint e do OneDrive para indexação no Knowledge.
Páginas e bancos de dados do Notion, com a integração adicionada por página.
Páginas e espaços do Confluence para indexação no Knowledge.
### Analytics
Séries diárias de sessões, páginas, eventos e aquisição de usuários de uma propriedade GA4.
***
## Configurando um conector
No menu lateral, clique em **Connections** → **+ Nova Conexão**.
Escolha a categoria (banco de dados, CRM, helpdesk, documentos) e o conector específico.
Cada conector tem campos específicos. Consulte a documentação individual do conector para instruções detalhadas.
Clique em **Testar Conexão** antes de salvar. A plataforma nunca escreve nas fontes — apenas lê. Use sempre um usuário com permissão de somente leitura.
Selecione para quais produtos o conector alimenta:
* **Data Catalog** — dados estruturados (tabelas, registros)
* **Knowledge** — documentos e textos para indexação semântica
* **Memory** — dados de entidades (clientes, contratos, tickets)
***
## Credenciais mínimas por tipo
### Bancos de dados relacionais (PostgreSQL, MySQL)
```sql theme={null}
-- PostgreSQL: criar usuário de leitura
CREATE USER strattum_readonly WITH PASSWORD 'senha_segura';
GRANT CONNECT ON DATABASE seu_banco TO strattum_readonly;
GRANT USAGE ON SCHEMA public TO strattum_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO strattum_readonly;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
GRANT SELECT ON TABLES TO strattum_readonly;
```
```sql theme={null}
-- MySQL: criar usuário de leitura
CREATE USER 'strattum_readonly'@'%' IDENTIFIED BY 'senha_segura';
GRANT SELECT ON seu_banco.* TO 'strattum_readonly'@'%';
FLUSH PRIVILEGES;
```
### MongoDB
```javascript theme={null}
use admin
db.createUser({
user: "strattum_readonly",
pwd: "senha_segura",
roles: [{ role: "read", db: "seu_banco" }]
})
```
***
## Erros comuns
| Erro | Causa | Solução |
| -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------- |
| `Connection refused` | Host errado ou firewall bloqueando | Verificar se o IP do servidor Strattum está liberado no security group/firewall |
| `Authentication failed` | Usuário ou senha incorretos | Revisar credenciais; verificar se o usuário tem acesso ao banco específico |
| `SSL required` | Banco exige SSL | Ativar o toggle "Requer SSL" no formulário de conexão |
| `401 Unauthorized` | Token expirado ou sem permissão | Revogar e gerar novo token com os escopos corretos |
| `Notion: object not found` | Integração não adicionada às páginas | Adicionar a integração Strattum em cada página do Notion manualmente |
***
## Schedules de sincronização recomendados
| Tipo de conector | Schedule padrão |
| ------------------------------ | ----------------- |
| Banco de dados relacional | A cada 15 minutos |
| CRM (Salesforce, HubSpot) | A cada 30 minutos |
| Helpdesk (Zendesk) | A cada 30 minutos |
| Documentos (Notion, Drive) | A cada 6 horas |
| Mensageria (Slack) | A cada 1 hora |
| Armazenamento (S3, GCS, Drive) | A cada 24 horas |