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

# 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

> **[PostgreSQL](https://docs.strattum.ai/data-pipelines/connectors/postgres.md)**
>
> Tabelas de bancos PostgreSQL, cloud ou on-premise, com carga incremental ou full refresh por tabela.

> **[MySQL](https://docs.strattum.ai/data-pipelines/connectors/mysql.md)**
>
> Tabelas de bancos MySQL, com seleção por tabela e carga incremental ou full refresh.

> **[MongoDB](https://docs.strattum.ai/data-pipelines/connectors/mongodb.md)**
>
> Coleções de bancos MongoDB (self-hosted ou Atlas), com schema inferido por amostragem.

> **[BigQuery](https://docs.strattum.ai/data-pipelines/connectors/bigquery.md)**
>
> Tabelas do data warehouse BigQuery, autenticadas via Service Account do Google Cloud.

> **[Microsoft Fabric](https://docs.strattum.ai/data-pipelines/connectors/fabric.md)**
>
> Tabelas de um Lakehouse do Fabric lidas direto no OneLake, sem copiar os dados, com as permissões do Fabric.

> **[Databricks](https://docs.strattum.ai/data-pipelines/connectors/databricks.md)**
>
> Tabelas do Databricks consultadas na própria fonte (federadas), com ACL vinda dos grants do Unity Catalog.

### SaaS

> **[Salesforce](https://docs.strattum.ai/data-pipelines/connectors/salesforce.md)**
>
> Objetos de CRM do Salesforce para contexto de relacionamento no Memory.

> **[HubSpot](https://docs.strattum.ai/data-pipelines/connectors/hubspot.md)**
>
> Contatos, empresas e deals do HubSpot CRM, sincronizados incrementalmente.

> **[Pipedrive](https://docs.strattum.ai/data-pipelines/connectors/pipedrive.md)**
>
> Negócios, pessoas, organizações, atividades e notas do Pipedrive, com a visibilidade de cada registro.

> **[Zendesk](https://docs.strattum.ai/data-pipelines/connectors/zendesk.md)**
>
> Tickets, conversas, usuários, organizações e ratings de satisfação.

> **[Jira](https://docs.strattum.ai/data-pipelines/connectors/jira.md)**
>
> Issues, comentários, projetos e usuários do Jira Cloud.

> **[ClickUp](https://docs.strattum.ai/data-pipelines/connectors/clickup.md)**
>
> Tasks, spaces, lists e membros do workspace ClickUp.

> **[Asana](https://docs.strattum.ai/data-pipelines/connectors/asana.md)**
>
> Projetos, tarefas, comentários, times, metas e portfólios do Asana, com a permissão de cada projeto.

> **[Fibery](https://docs.strattum.ai/data-pipelines/connectors/fibery.md)**
>
> Entidades, campos e usuários de todos os databases de um workspace Fibery, e o texto das Document Views e dos campos rich text, com a permissão de cada database.

> **[MeetGeek](https://docs.strattum.ai/data-pipelines/connectors/meetgeek.md)**
>
> Reuniões gravadas, anfitriões, participantes e times do MeetGeek, com a transcrição e o resumo de cada reunião no Knowledge.

> **[Slack](https://docs.strattum.ai/data-pipelines/connectors/slack.md)**
>
> Mensagens dos canais selecionados para contexto de comunicação interna.

> **[Airtable](https://docs.strattum.ai/data-pipelines/connectors/airtable.md)**
>
> Registros das bases e tabelas selecionadas, com carga incremental por webhook.

> **[Apollo.io](https://docs.strattum.ai/data-pipelines/connectors/apollo.md)**
>
> Contatos, contas, deals, tarefas e chamadas do CRM do Apollo.io, sem gastar créditos.

### Financeiro

> **[Asaas](https://docs.strattum.ai/data-pipelines/connectors/asaas.md)**
>
> Clientes, cobranças, assinaturas e transferências do gateway de pagamentos Asaas.

> **[Omie](https://docs.strattum.ai/data-pipelines/connectors/omie.md)**
>
> Clientes e fornecedores, produtos, pedidos, notas fiscais e o financeiro do ERP Omie, no Data Catalog e no Memory.

### Documentos

> **[Google Drive](https://docs.strattum.ai/data-pipelines/connectors/google-drive.md)**
>
> Documentos e planilhas de pastas específicas do Google Drive para indexação no Knowledge.

> **[Microsoft 365 (SharePoint)](https://docs.strattum.ai/data-pipelines/connectors/microsoft-365.md)**
>
> Documentos de sites do SharePoint e do OneDrive para indexação no Knowledge.

> **[Notion](https://docs.strattum.ai/data-pipelines/connectors/notion.md)**
>
> Páginas e bancos de dados do Notion, com a integração adicionada por página.

> **[Confluence](https://docs.strattum.ai/data-pipelines/connectors/confluence.md)**
>
> Páginas e espaços do Confluence para indexação no Knowledge.

> **[Archbee](https://docs.strattum.ai/data-pipelines/connectors/archbee.md)**
>
> Documentos dos spaces do Archbee que você escolher, em markdown no Knowledge, com o link para o original.

### Analytics

> **[Google Ads](https://docs.strattum.ai/data-pipelines/connectors/google-ads.md)**
>
> Contas, campanhas, anúncios, palavras-chave e métricas diárias das contas que a credencial do Google Ads alcança.

> **[Google Analytics](https://docs.strattum.ai/data-pipelines/connectors/google-analytics.md)**
>
> Séries diárias de sessões, páginas, eventos e aquisição de usuários de uma propriedade GA4.

> **[OpenAI Ads](https://docs.strattum.ai/data-pipelines/connectors/openai-ads.md)**
>
> Campanhas, grupos e anúncios de uma conta OpenAI Ads, com gasto, entrega e conversões por anúncio e por dia.

> **[PostHog](https://docs.strattum.ai/data-pipelines/connectors/posthog.md)**
>
> Métricas diárias de Web Analytics e entidades de produto de todos os projetos de uma organização PostHog.

> **[LinkedIn Ads](https://docs.strattum.ai/data-pipelines/connectors/linkedin-ads.md)**
>
> Contas de anúncio, campanhas, criativos e métricas diárias de todas as contas que o membro alcança no LinkedIn.

> **[Microsoft Advertising](https://docs.strattum.ai/data-pipelines/connectors/bing-ads.md)**
>
> Contas, campanhas, grupos de anúncios, anúncios, palavras-chave e métricas diárias das contas que a credencial do Microsoft Advertising alcança.

***

## Configurando um conector

**1. Acesse Connections no Console**

No menu lateral, clique em **Connections** → **+ Nova Conexão**.

**2. Selecione o tipo de conector**

Escolha a categoria (banco de dados, CRM, helpdesk, documentos) e o conector específico.

**3. Preencha as credenciais**

Cada conector tem campos específicos. Consulte a documentação individual do conector para instruções detalhadas.

**4. Teste a conexão**

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.

**5. Marque os dados pessoais, se houver**

Na etapa de tabelas ou de recursos, marque as colunas com dado pessoal. O valor delas vira token antes de chegar ao lake. Sem marcação, o sync grava como sempre. Ver [Dados pessoais (PII)](https://docs.strattum.ai/data-pipelines/personal-data.md).

**6. Configure o destino**

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 |


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