camposdealer

Community node n8n para o CRM Campos Dealer (camposdealer.app). Autenticação cookie + anti-CSRF; leitura e escrita modelada; 46 subnodes CD Tool para agentes de IA (AI Agent).

Package Information

Downloads: 0 weekly / 0 monthly
Latest Version: 0.4.0
Author: Campos Dealer Integration

Available Nodes

Documentation

n8n-nodes-camposdealer

Community node n8n para o CRM Campos Dealer (https://camposdealer.app).

Recursos

Leitura

  • Cliente — listar tags, tags ativas, dados do progress bar.
  • Combo / Auxiliar — tipos de negócio, clientes, origens, segmentações, motivos, eventos, campanhas, instituições financeiras, departamentos, estados, grupos econômicos, status navbar, tags, templates de orçamento e notificações.
  • Empresa do Grupo — listar.
  • Etapa do Funil — listar etapas com contagem de negócios.
  • Funil de Vendas — listar funis.
  • Negociação — listar paginada, obter, tempo, produtos, máquinas usadas, tags, tooltips, verificar orçamento/pedido, campos customizáveis, listar condição de pagamento.
  • Produto — listar marcas, grupos, modelos.
  • Vendedor — listar vendedores.
  • Ação — listar tipos/subtipos, listar grade de ações, criar ação vinculada ao cliente.

Escrita (confirmação obrigatória)

  • Ação → CriarPOST /CRM_Acoes/SalvarAcao (ação vinculada ao cliente; visita, ligação, etc.).
  • Cliente → CriarPOST /CRM_Cliente/SalvarClienteCRM (segmentação em CSV, endereço obrigatório).
  • Negociação → CriarPOST /CRM_Negocio/SalvarNegocio (produtos, previsão de compra).
  • Negociação → Mover EtapaPOST /CRM_FunilVendas/AtualizaStatusNegocio (ex.: 13103 Atendimento/Negociação).
  • Negociação → Salvar Condição de PagamentoPOST /CRM_Negocio/CRM_SalvarNegociacaoOrcamento (necessário para avançar a Orçamento Apresentado).
  • Negociação → Inativar Condição de PagamentoPOST /CRM_Negocio/CRM_InativarNegociacaoOrcamento.
  • Requisição Customizada — qualquer endpoint GET/POST com confirmação para métodos não-GET.

Autenticação

Credencial Campos Dealer API com CNPJ, login, senha e base URL. O nó faz login a cada execução, mantém cookies de sessão e token anti-CSRF apenas em memória e renova o RVT automaticamente após login (necessário para POSTs autenticados).

Saída

Por padrão o nó devolve apenas o conteúdo do campo Objeto do envelope {Mensagem, Objeto, Erro, Codigo, PBV_RetornoValidacao}. Use a opção "Retornar Envelope Completo" para receber a resposta completa.

Instalação (n8n)

npm install n8n-nodes-camposdealer

Pacote publicado: n8n-nodes-camposdealer@0.4.0

Ferramentas para Agente de IA (v0.3.0+)

O pacote inclui 50 subnodes CD Tool: … (um por recurso/operação), prontos para conectar na porta Tools do nó AI Agent.

Requisitos:

  • n8n 1.79.0+
  • Variável de ambiente: N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

O system prompt do agente é configuração local do projeto (docs/agent-prompt-vendedor-campos-dealer.md) — não faz parte do pacote publicado no npm. Cole-o manualmente no nó AI Agent do seu workflow n8n.

Regenerar subnodes após alterar operações:

npm run generate:tools
npm run build

Build local

npm install
npm run build

Para registrar no n8n local, siga a documentação de community nodes do n8n e aponte para a pasta dist/.

Documentação da API

Veja ../docs/writes-confirmed.md para payloads validados ao vivo, regras de Playbook por etapa do funil e mapeamento de "Condição de Pagamento".

Discussion