Skip to main content
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á:

​
Problemas comuns

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.
  • Ative o toggle Requer SSL no formulário de conexão quando o banco exigir.
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.
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.
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.
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

Conectores disponíveis, credenciais mínimas e schedules recomendados por tipo de fonte.

Configuração pós-instalação

A sequência de setup, do Workspace Git até a verificação final dos conectores.

Problemas no Memory

Diagnóstico de fila de revisão, entidades duplicadas e threshold mal calibrado.

Changelog de produto

Mudanças, correções e novidades da plataforma por data.