Sincronização incremental de leads
Na primeira sincronização, o sistema externo pode buscar todos os leads. Nas próximas execuções, deve buscar apenas registros novos ou atualizados usando updated_since ou cursor.
O que é sincronização incremental
Sincronização incremental é a prática de buscar apenas registros criados, atualizados ou marcados como removidos desde um marco conhecido. Isso reduz volume e evita retrabalho no destino.
Carga inicial vs próximas sincronizações
A carga inicial cria a base completa no sistema externo. As próximas execuções usam updated_since para recuperar apenas mudanças desde a última execução concluída.
Não avance o marco de sincronização se alguma página da janela falhar.
Como usar updated_since
GET /public/v1/leads?limit=100&updated_since=2026-05-06T00:00:00ZComo usar cursor
GET /public/v1/leads?limit=100&cursor=NEXT_CURSOR_AQUIComo lidar com leads removidos
Quando aplicável, inclua registros removidos ou inativados para refletir mudanças no destino.
GET /public/v1/leads?limit=100&include_deleted=trueExemplo com n8n
Guarde updated_since em credencial, variável do workflow ou base de controle. A cada execução, o HTTP Request usa esse valor, percorre todos os cursores e só atualiza o marco depois do sucesso.
Exemplo com ERP/CRM
Em CRM ou ERP, mantenha uma tabela de controle com data da última janela concluída, quantidade processada e resultado. Isso facilita reprocessar falhas sem duplicar registros.
Boas práticas
A integração deve ser idempotente e reexecutável.
- Use id do Capturama como chave de referência no destino quando fizer sentido.
- Processe todas as páginas antes de salvar o novo updated_since.
- Registre falhas 400, 401, 503 e 500 separadamente.
- Evite buscar a base inteira em toda execução.