n8n-nodes-nold-crm

Community node do n8n para o Nold CRM. Substitui o node HTTP Request: você escolhe a operação, preenche os campos e o node monta o payload, autentica com a chave do cliente e trata os erros.

O que o node faz

| Recurso | Operação | Descrição | |---|---|---| | Lead | Criar ou Atualizar | Cria o lead na etapa escolhida (ou na primeira do funil). Se o telefone já existe, atualiza o lead existente em vez de duplicar. | | Lead | Validar (Sem Gravar) | Mostra como o lead ficaria (etapa, campos, avisos), sem criar nada. Use para testar o mapeamento. | | Funil | Obter Etapas e Campos | Devolve as etapas e as chaves de campos personalizados do cliente. |

As listas Etapa Inicial e Campos Personalizados são carregadas direto do CRM do cliente da credencial — não precisa digitar stage_id nem a chave dos campos.

Campos do lead: nome, telefone, e-mail, cidade, valor estimado, observações, etapa inicial, origem do envio (landing page / formulário nativo / outro), nome do formulário, URL da página, campanha, conjunto, anúncio, fbc, fbp, campos personalizados (chave/valor) e Campos Extras (JSON) para qualquer outra chave (UTMs etc. — o que não bater com um campo do cliente fica em source_metadata.extra).

Credencial: "Nold CRM API"

Uma credencial por cliente:

| Campo | Valor | |---|---| | Slug do cliente | biliart-odonto | | Chave de API | Admin → cliente → aba n8n → "Chave" | | URL do webhook | já vem preenchida com a do projeto Nold |

O botão Test da credencial chama o CRM e falha com 401 se a chave estiver errada.

Instalação

Opção A — publicar no npm (recomendado)

cd n8n-nodes-nold-crm
npm install
npm run build
npm publish

No n8n: Settings → Community Nodes → Install → n8n-nodes-nold-crm. (O n8n Cloud só aceita pacotes verificados pela n8n; para o n8n próprio funciona direto.)

Opção B — n8n próprio, sem publicar

cd n8n-nodes-nold-crm
npm install
npm run build
npm pack                      # gera n8n-nodes-nold-crm-0.1.0.tgz
cd ~/.n8n/nodes               # crie a pasta se não existir (npm init -y)
npm install /caminho/para/n8n-nodes-nold-crm-0.1.0.tgz

Reinicie o n8n. O node aparece como Nold CRM.

Uso típico

Webhook (formulário) → Nold CRM (Criar ou Atualizar) → ...

Mapeie os campos do formulário nas expressões do node (ex.: Nome = {{ $json.body.nome }}). Para testar sem criar lead, troque a operação para Validar.

Desenvolvimento

npm run build   # compila para dist/ e copia o ícone
npm run dev     # tsc --watch