> ## 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 não sincronizam

> Diagnóstico dos problemas mais comuns de conectores: teste de conexão que falha, sync travado, status Erro, credenciais expiradas e primeira carga lenta.

Esta página cobre os problemas mais comuns quando um conector não sincroniza como esperado. Para cada um, você tem o sintoma que aparece no Console, a causa mais provável e a correção.

Antes de começar, confira o status do conector em **Connections**. Ele indica onde o problema está:

| Status | Cor | O que significa |
| - | - | - |
| Conectado | Verde | Sincronizando normalmente |
| Sincronizando | Azul | Primeira carga ou ciclo em progresso |
| Erro | Vermelho | Falha na última tentativa — clique em `···` → **Ver logs** |

***

## Problemas comuns

> **O teste de conexão falha antes de salvar**
>
> **Sintoma:** ao clicar em **Testar Conexão**, o Console retorna `Connection refused`, `Authentication failed` ou `SSL required` e não deixa salvar.
>
> **Causa provável:**
>
> * `Connection refused` — host errado ou firewall bloqueando o worker.
> * `Authentication failed` — usuário ou senha incorretos, ou o usuário não tem acesso ao banco específico.
> * `SSL required` — o banco exige conexão SSL e o toggle não está ativo.
>
> **Correção:**
>
> * Libere o IP do ambiente strattum.ai (ou o CIDR da VPC) no Security Group ou firewall da fonte. Para bancos on-premise, confira também o `pg_hba.conf` e a liberação da porta (padrão `5432` no PostgreSQL).
> * Revise as credenciais e confirme que o usuário read-only tem `SELECT` no schema. Consulte o passo a passo em [PostgreSQL](https://docs.strattum.ai/data-pipelines/connectors/postgres.md).
> * Ative o toggle **Requer SSL** no formulário de conexão quando o banco exigir.

> **O sync fica travado em Sincronizando**
>
> **Sintoma:** o conector permanece em **Sincronizando** (azul) por muito mais tempo que o schedule configurado.
>
> **Causa provável:** a primeira carga ainda está em progresso, ou um ciclo anterior não fechou. Tabelas grandes em modo **Full Refresh** recarregam por completo a cada execução e podem levar horas. \[verificar tempo típico por volume]
>
> **Correção:**
>
> * Aguarde até 5 minutos após configurar antes de considerar travado — a primeira carga inicia automaticamente ao salvar.
> * Abra `···` → **Ver logs** e veja se há progresso (linhas lidas). Se os logs avançam, o sync está saudável, só é grande.
> * Para tabelas grandes com campo `updated_at`, troque de **Full Refresh** para **Incremental** — só linhas novas ou modificadas são lidas a cada ciclo.

> **O conector está em status Erro (vermelho)**
>
> **Sintoma:** o status é **Erro** e a última sincronização não completou.
>
> **Causa provável:** a última tentativa falhou — rede, credencial, schema alterado na origem ou permissão removida.
>
> **Correção:**
>
> * Clique em `···` → **Ver logs** para o erro específico. A mensagem indica a categoria (rede, autenticação, permissão).
> * `401 Unauthorized` em conectores de API significa token expirado ou sem escopo — revogue e gere um novo com os escopos corretos.
> * `Notion: object not found` significa que a integração Strattum não foi adicionada às páginas — adicione a integração em cada página manualmente.
> * Após corrigir a origem do erro, dispare uma nova sincronização e confirme que o status volta para **Conectado**.

> **As credenciais expiraram**
>
> **Sintoma:** o conector estava **Conectado** e passou para **Erro** com `401 Unauthorized` ou `Authentication failed`, sem nenhuma mudança de configuração.
>
> **Causa provável:** o token de acesso expirou, a senha do usuário foi rotacionada na origem, ou a permissão do usuário read-only foi revogada.
>
> **Correção:**
>
> * Gere um novo token (ou redefina a senha) na fonte de dados e atualize as credenciais no formulário do conector.
> * Confirme que o usuário mantém `SELECT` nas tabelas — inclusive nas criadas depois da configuração inicial. O comando `ALTER DEFAULT PRIVILEGES` garante acesso a tabelas futuras.
> * Rode **Testar Conexão** para validar antes de salvar.

> **A primeira carga está lenta**
>
> **Sintoma:** a primeira sincronização de um conector novo demora bem mais que os ciclos seguintes.
>
> **Causa provável:** a carga inicial lê o histórico completo da fonte. Ciclos posteriores em modo Incremental só leem o delta, por isso são mais rápidos.
>
> **Correção:**
>
> * Considere normal a primeira carga ser mais longa. Acompanhe o progresso em `···` → **Ver logs**.
> * Reduza o escopo inicial: selecione só as tabelas ou schemas essenciais primeiro e adicione o restante depois.
> * Ajuste o schedule ao tipo de fonte para não empilhar ciclos. Valores de referência: banco relacional a cada 15 minutos, CRM a cada 30 minutos, documentos a cada 6 horas.

***

## Onde ver os logs

Todo conector expõe o log da última execução em **Connections** → `···` → **Ver logs**. A mensagem de erro ali é o ponto de partida de qualquer diagnóstico — ela nomeia a categoria da falha (rede, autenticação, permissão, schema).

## Como abrir um chamado

Se o log não for suficiente, abra um chamado no canal **#strattum-suporte** no Slack. Inclua o nome do conector, o status atual, a mensagem de **Ver logs** e o horário aproximado da falha.

***

## Próximos passos

> **[Visão geral de conectores](https://docs.strattum.ai/connectors/overview.md)**
>
> Conectores disponíveis, credenciais mínimas e schedules recomendados por tipo de fonte.

> **[Configuração pós-instalação](https://docs.strattum.ai/getting-started/configuration.md)**
>
> A sequência de setup, do Workspace Git até a verificação final dos conectores.

> **[Problemas no Memory](https://docs.strattum.ai/troubleshooting/memory.md)**
>
> Diagnóstico de fila de revisão, entidades duplicadas e threshold mal calibrado.

> **[Changelog de produto](https://docs.strattum.ai/changelog/product.md)**
>
> Mudanças, correções e novidades da plataforma por data.


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