Como integrar leads B2B com seu ERP
A integração com ERP é útil quando leads/clientes precisam chegar ao processo operacional sem cadastro manual. O Capturama fornece leitura via API; o ERP ou fornecedor técnico decide como receber e transformar os dados.
Por que conectar prospecção e ERP
Em muitas empresas, a prospecção gera uma base que só chega à operação quando alguém recadastra os dados no ERP. Isso cria atraso, erro de digitação e diferença entre o que vendas sabe e o que operação enxerga.
Conectar a fonte de leads ao ERP ajuda a dar continuidade à passagem comercial para operação, especialmente quando há qualificação, proposta, faturamento ou onboarding depois da primeira conversa.
Evite cadastro manual de clientes
A API permite automatizar a leitura de campos básicos como nome, e-mail, telefone, datas e área do lead. O ERP pode usar esses dados para pré-cadastro, fila de validação ou comparação com clientes existentes.
O Capturama não escreve no ERP e não define regras fiscais, financeiras ou cadastrais do destino. Essas validações continuam sob responsabilidade do sistema operacional.
Como enviar leads para o ERP via API
O fornecedor do ERP deve consumir GET /public/v1/leads com token Bearer, mapear campos públicos e gravar no destino conforme as regras internas do ERP. Quando precisar conferir um registro específico, pode usar GET /public/v1/leads/{lead_id}.
Se a integração for feita por n8n, o workflow pode buscar no Capturama e chamar a API do ERP em seguida.
Carga inicial e atualização incremental
A carga inicial monta a base de partida. Depois, a integração deve usar updated_since ou cursor para buscar apenas registros novos ou atualizados.
Quando include_deleted fizer sentido para a operação, o ERP pode processar registros removidos ou inativados sem assumir que a API fará qualquer exclusão no destino.
O que enviar ao fornecedor do ERP
Use o bloco abaixo como briefing técnico para o fornecedor que fará a integração.
- Endpoint de listagem: GET /public/v1/leads
- Endpoint de detalhe: GET /public/v1/leads/{lead_id}
- Autenticação: Authorization: Bearer SEU_TOKEN_AQUI
- Carga inicial: chamar listagem sem updated_since
- Incremental: usar updated_since ou cursor
- Paginação: usar page_info.next_cursor
- API somente leitura
Segurança do token
O token completo aparece apenas no momento de criação no painel. Depois disso, o painel exibe apenas prefixo ou preview, e o token pode ser revogado.
Nunca salve o token em planilhas abertas, comentários de chamado ou código público. O fornecedor deve tratar o token como segredo operacional.
Perguntas frequentes
Posso integrar leads com ERP? +
Sim, via API, n8n ou implementação técnica do fornecedor do ERP, desde que o destino aceite receber ou importar os dados necessários.
A API substitui o cadastro do ERP? +
Não. A API lê leads/clientes no Capturama. A criação ou atualização dentro do ERP depende das regras do próprio ERP.
O token deve ficar com o fornecedor? +
Somente se houver necessidade operacional e acordo de segurança. O token deve ser guardado como segredo e revogado quando não for mais usado.