Package Information
Available Nodes
Documentation generating…
Documentation
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