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

Tabelas de bancos PostgreSQL, cloud ou on-premise, com carga incremental ou full refresh por tabela.

MySQL

Tabelas de bancos MySQL, com seleção por tabela e carga incremental ou full refresh.

MongoDB

Coleções de bancos MongoDB (self-hosted ou Atlas), com schema inferido por amostragem.

BigQuery

Tabelas do data warehouse BigQuery, autenticadas via Service Account do Google Cloud.

SaaS

Salesforce

Objetos de CRM do Salesforce para contexto de relacionamento no Memory.

HubSpot

Contatos, empresas e deals do HubSpot CRM, sincronizados incrementalmente.

Zendesk

Tickets, conversas, usuários, organizações e ratings de satisfação.

Jira

Issues, comentários, projetos e usuários do Jira Cloud.

ClickUp

Tasks, spaces, lists e membros do workspace ClickUp.

Slack

Mensagens dos canais selecionados para contexto de comunicação interna.

Airtable

Registros das bases e tabelas selecionadas, com carga incremental por webhook.

Financeiro

Asaas

Clientes, cobranças, assinaturas e transferências do gateway de pagamentos Asaas.

Documentos

Google Drive

Documentos e planilhas de pastas específicas do Google Drive para indexação no Knowledge.

Microsoft 365 (SharePoint)

Documentos de sites do SharePoint e do OneDrive para indexação no Knowledge.

Notion

Páginas e bancos de dados do Notion, com a integração adicionada por página.

Confluence

Páginas e espaços do Confluence para indexação no Knowledge.

Analytics

Google Analytics

Séries diárias de sessões, páginas, eventos e aquisição de usuários de uma propriedade GA4.

---

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

-- 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;

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

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