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

<AccordionGroup>
  <Accordion title="O teste de conexão falha antes de salvar" icon="plug-circle-xmark">
    **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](/data-pipelines/connectors/postgres).
    * Ative o toggle **Requer SSL** no formulário de conexão quando o banco exigir.
  </Accordion>

  <Accordion title="O sync fica travado em Sincronizando" icon="rotate">
    **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.
  </Accordion>

  <Accordion title="O conector está em status Erro (vermelho)" icon="triangle-exclamation">
    **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**.
  </Accordion>

  <Accordion title="As credenciais expiraram" icon="key">
    **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.
  </Accordion>

  <Accordion title="A primeira carga está lenta" icon="hourglass-half">
    **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.
  </Accordion>
</AccordionGroup>

***

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

<CardGroup cols={2}>
  <Card title="Visão geral de conectores" icon="plug" href="/connectors/overview">
    Conectores disponíveis, credenciais mínimas e schedules recomendados por tipo de fonte.
  </Card>

  <Card title="Configuração pós-instalação" icon="gear" href="/getting-started/configuration">
    A sequência de setup, do Workspace Git até a verificação final dos conectores.
  </Card>

  <Card title="Problemas no Memory" icon="brain" href="/troubleshooting/memory">
    Diagnóstico de fila de revisão, entidades duplicadas e threshold mal calibrado.
  </Card>

  <Card title="Changelog de produto" icon="clock-rotate-left" href="/changelog/product">
    Mudanças, correções e novidades da plataforma por data.
  </Card>
</CardGroup>