n8n e automação

Como integrar leads B2B com n8n usando o Capturama

O n8n ajuda a montar fluxos visuais entre APIs e ferramentas de negócio. No Capturama, ele pode buscar leads via API read-only e enviar esses dados para CRM, ERP, Google Sheets, BI ou outro destino técnico.

HTTP RequestBearer tokenupdated_since

O que essa integração resolve

O fluxo com n8n resolve a passagem entre Capturama e outros sistemas quando a equipe não quer depender de exportação manual. O n8n chama a API, transforma campos se necessário e envia cada lead ao destino correto.

Esse caminho é útil para times que já têm CRM, ERP, planilha operacional ou dashboard e precisam apenas de uma ponte segura e reprocessável.

Quando usar n8n com leads B2B

Use n8n quando a integração precisa ser configurável, auditável pela equipe técnica e simples de ajustar. Ele costuma funcionar bem para rotinas como buscar novos leads a cada hora, criar registros no CRM e atualizar uma linha no Google Sheets.

Quando o fluxo envolve regras complexas, volume alto ou validações específicas do ERP, o n8n ainda pode servir como protótipo antes de uma implementação técnica dedicada.

Como funciona o fluxo

01

Agendamento

Um trigger roda em horário definido ou sob demanda.

02

HTTP Request

O node chama GET /public/v1/leads com limit e updated_since.

03

Tratamento

O fluxo normaliza campos, verifica duplicidade e prepara o payload do destino.

04

Envio

O lead segue para CRM, ERP, Google Sheets, BI ou outro sistema.

Passo a passo no n8n

Crie um workflow com trigger de agendamento, adicione um node HTTP Request e configure método GET. Na URL, use o endpoint de listagem da API pública, mantendo URL_DA_API como placeholder se o seu ambiente ainda não tiver domínio público definido.

Em Headers, adicione Authorization com Bearer SEU_TOKEN_AQUI. Em Query Parameters, comece com limit=100 e inclua updated_since nas execuções recorrentes.

  • Método: GET
  • Endpoint: /public/v1/leads
  • Header: Authorization: Bearer SEU_TOKEN_AQUI
  • Query: limit, updated_since e cursor quando houver próxima página

Configurando o HTTP Request

Snippet base para o node HTTP Request ou para validar a chamada antes de montar o workflow.

GET /public/v1/leads?limit=100&updated_since=2026-05-06T00:00:00Z
Authorization: Bearer SEU_TOKEN_AQUI

Usando updated_since para buscar novos leads

updated_since deve guardar o marco da última execução concluída com sucesso. Assim, o workflow evita buscar a base inteira de novo e reduz risco de duplicar registros no destino.

Se a resposta indicar has_more=true, continue usando cursor até finalizar a janela. Só atualize o marco de sincronização depois que todas as páginas forem processadas.

Enviando leads para CRM

Depois do HTTP Request, adicione o conector ou chamada API do CRM. Mapeie campos como full_name, email, phone, lead_role e lead_area conforme o modelo do destino.

Se o CRM exigir deduplicação, use email, phone ou id do Capturama como chave de comparação. O Capturama não escreve de volta no CRM; o fluxo externo controla essa etapa.

Enviando leads para Google Sheets

Para planilhas, crie colunas estáveis para id, full_name, email, phone, created_at e updated_at. Evite salvar token na própria planilha e restrinja acesso aos dados exportados.

Quando o uso evoluir para dashboard, prefira uma aba de staging e outra aba analítica, ou envie os dados para uma base que alimente o Power BI.

Erros comuns

Status Código Quando acontece Ação recomendada
400 invalid_cursor O cursor informado não pode ser lido ou não pertence à consulta atual. Use apenas o valor retornado em page_info.next_cursor.
400 invalid_updated_since A data de updated_since não está em formato aceito. Envie uma data ISO 8601, por exemplo 2026-05-06T00:00:00Z.
401 unauthorized O token está ausente, inválido ou revogado. Confira o header Authorization e gere novo token se necessário.
503 integration_disabled A integração está desabilitada para a conta ou token. Reative a integração no painel ou fale com o responsável pela conta.
FAQ

Perguntas frequentes

O Capturama integra com n8n? +

Sim. O caminho documentado é usar o node HTTP Request do n8n para chamar a API read-only com Authorization Bearer.

O n8n pode enviar os leads para CRM? +

Pode, desde que o CRM aceite API, conector do n8n ou outro mecanismo de entrada. A integração nativa com cada CRM não é prometida aqui.

Como evitar buscar todos os leads sempre? +

Use updated_since nas execuções recorrentes e continue páginas com cursor quando page_info.has_more for true.