Skip to main content

​
Conectar via API

Conecte sua tabela a uma fonte externa (CRM, ERP, sistema próprio) para mantê-la sempre atualizada — sem cópia manual e sem código.

​
Quando usar

Use a integração via API quando:
  • Os dados mudam frequentemente (estoque, preços)
  • A fonte de verdade vive em outro sistema (CRM, ERP)
  • Você precisa que o Agente de IA leia dados sempre atualizados
  • Precisa importar grandes volumes em lotes paginados
Para Pipefy, há uma integração nativa mais simples — veja Sincronizar com Pipefy.

​
Passo a passo

1

Iniciar conexão

Em Tabelas, clique em Nova Tabela → Conectar via API → Configurar URL manualmente.
2

Configurar endpoint

​
Placeholders disponíveis no body

3

Mapear resposta

O Brainchat usa o ID Field para detectar registros existentes (atualiza em vez de duplicar).
4

Configurar paginação

Escolha o tipo de paginação que sua API suporta:
5

Definir modo de sincronização

​
Modo incremental

No modo incremental, defina:
  • Campo incremental — coluna na resposta que indica quando o registro foi atualizado (ex: updated_at)
  • Janela de overlap (minutos) — segurança para não perder edições no limite (default 10 min)
O Brainchat envia o timestamp da última sync no placeholder {{since}}.
6

Agendamento

Defina a periodicidade da sincronização automática:Você pode definir um limite máximo de execuções (útil para sync de 1 vez por importação inicial).
7

Testar e ativar

Use Testar conexão para validar o setup. Se OK, salve. A primeira sync roda imediatamente.

​
Status de sincronização

O card da tabela mostra o status atual:

​
Retomar carga interrompida

Se uma sync grande for interrompida (timeout, limite de páginas, erro temporário), o status fica partial e o Brainchat guarda em sync_resume:
  • Cursor da última página processada
  • Quantas páginas já foram baixadas
  • Quantos registros já foram inseridos
  • Timestamp do início
Basta clicar em Continuar sincronização que ele retoma de onde parou — sem reprocessar o que já foi feito.

​
Boas práticas

  • Comece com Max Pages baixo (5–10) para testar antes de liberar uma carga completa.
  • Use modo incremental sempre que a API suportar updated_at — é muito mais barato e rápido.
  • Defina Response Path com cuidado — caminho errado faz a sync retornar zero registros.
APIs externas com rate limit podem rejeitar muitas chamadas seguidas. Use Page Size razoável (50–100) e prefira modo incremental.

​
Próximo passo

Sincronizar com Pipefy

Integração nativa com Databases e Pipes do Pipefy — sem precisar montar a query GraphQL.