n8n-nodes-bright-minds-crm

Node customizado do n8n para o CRM Bright Minds. Substitui os nodes Set
com JS cru usados hoje nos fluxos "Aplicação Recebida" e "Reunião Agendada"
por um node com campos normais e, principalmente, dropdowns que carregam
os campos personalizados direto do CRM (Configurações → Campos
Personalizados), sem precisar digitar/decorar a field_key interna nem
mexer em expressão JS quando o formulário muda.

Funciona com dois endpoints do CRM:

• Criar Lead → inbound-lead (cria contato + oportunidade, ou
  atualiza se o telefone já existir)
• Avançar Lead → inbound-lead-advance (move um lead existente pra
  etapa configurada na "Entrada de Leads", ou cria direto nela)

Cada credencial "Bright Minds CRM API" corresponde a uma Entrada de
Leads específica (Automações → Pipeline → Entrada de Leads), já que a
chave (x-api-key) determina no CRM qual pipeline/etapa recebe o lead.

Instalação (pela tela do n8n, sem terminal)

Uma vez publicado no npm (ver seção seguinte, feito uma vez só), a
instalação é igual à do node n8n-nodes-wts que já está em uso: Settings
→ Community Nodes → Install, digitar n8n-nodes-bright-minds-crm, marcar
a caixinha de confiança e instalar. Não precisa de acesso a servidor.

Publicar no npm (passo único, feito por quem cuida do repositório)

O "Install pelo nome" da tela do n8n só funciona depois que o pacote
existe no registro público do npm. Isso é feito uma vez (e de novo só se
o código do node mudar no futuro) através de um GitHub Actions já
preparado neste repositório, o mesmo mecanismo usado para publicar as
edge functions no Supabase:

1. Criar uma conta gratuita em npmjs.com (se
   ainda não tiver uma).
2. Nela, gerar um token: avatar → Access Tokens → Generate New Token →
   tipo Automation. Copiar o valor gerado.
3. No GitHub, em Settings → Secrets and variables → Actions do
   repositório, criar um secret novo chamado NPM_TOKEN com esse valor.
4. Rodar o workflow Publish n8n custom node (npm) (aba Actions do
   repositório → esse workflow → "Run workflow"). Ele builda e publica o
   pacote sozinho.

Depois disso, o pacote fica disponível como n8n-nodes-bright-minds-crm
no npm, instalável pela tela do n8n como descrito acima. Uma alteração
futura no código do node só exige rodar esse mesmo workflow de novo.

Alternativa: instalação manual (sem publicar no npm)

Se por algum motivo não for possível publicar no npm, dá pra instalar
manualmente com acesso à VPS/servidor onde o n8n roda:

1. Dentro da pasta n8n-nodes-bright-minds-crm/:

   npm install
   npm run build
   npm pack
   

   Isso gera n8n-nodes-bright-minds-crm-0.1.0.tgz.

2. Copie o .tgz para a VPS onde o n8n roda (ex.: scp ou upload manual).

3. Descubra a pasta de dados do n8n dentro do container. No Docker
   oficial do n8n costuma ser /home/node/.n8n (ou o que estiver em
   N8N_USER_FOLDER, se customizado). Confirme com:

   docker exec -it <nome-do-container-n8n> printenv N8N_USER_FOLDER
   

4. Dentro do container, crie a subpasta nodes (se ainda não existir) e
   instale o pacote a partir do .tgz:

   docker exec -it <nome-do-container-n8n> sh -c \
     "mkdir -p /home/node/.n8n/nodes && cd /home/node/.n8n/nodes && npm install /caminho/para/n8n-nodes-bright-minds-crm-0.1.0.tgz"
   

   (Se o .tgz não estiver acessível de dentro do container, monte a
   pasta onde ele está como volume antes de rodar o npm install, ou
   copie o arquivo pra dentro do container com docker cp antes desse
   passo.)

5. Reinicie o n8n para carregar o node novo:

   docker restart <nome-do-container-n8n>
   

   Ou, se estiver usando docker compose: docker compose restart n8n.

6. Confirme que funcionou: crie um novo workflow no n8n e procure por
   "Bright Minds CRM" na lista de nodes.

Configuração no n8n

1. Credenciais: crie uma credencial "Bright Minds CRM API" para cada
   Entrada de Leads que os fluxos usam hoje. A "URL Base" já vem
   preenchida com o endereço correto do CRM, normalmente não precisa
   mudar. Em "Chave da Entrada de Leads", cole o valor de x-api-key da
   tela Automações → Pipeline → Entrada de Leads correspondente.

2. No fluxo: adicione o node "Bright Minds CRM", selecione a
   credencial certa, escolha a operação (Criar Lead / Avançar Lead) e
   preencha os campos de topo (Nome, Email, WhatsApp, etc.).

3. Campos personalizados: nas seções "Campos Personalizados -
   Contato/Empresa/Oportunidade", clique em "Adicionar campo". O
   dropdown "Campo" já lista os campos cadastrados em Configurações →
   Campos Personalizados no CRM, pelo nome que aparece lá (não pela chave
   interna). No campo "Valor" ao lado, arraste o dado vindo do node
   anterior (ex.: a resposta do lead no formulário), igual faria num node
   Set comum.

   Se você acabou de criar um campo personalizado novo no CRM e ele não
   aparece no dropdown, feche e reabra o seletor do campo (ou o node):
   a lista é recarregada do CRM toda vez que o dropdown é aberto.

A partir daqui, qualquer ajuste no formulário (novo campo, campo
renomeado) se resolve escolhendo a opção certa no dropdown, sem editar
JS e sem precisar pedir para alguém mexer no fluxo.