n8n-nodes-sharpspring

Nó comunitário n8n para a SharpSpring API v1/v1.2 (Marketing Automation).

Recursos suportados

Lead

| Operação | Descrição | |---|---| | Create | Cria um novo lead | | Get | Busca lead por ID | | Get Many | Lista leads com filtros | | Get Many by Date Range | Lista leads por período de criação/atualização | | Update | Atualiza um lead (incluindo campos personalizados) | | Delete | Remove um lead |

Opportunity

| Operação | Descrição | |---|---| | Create | Cria uma nova oportunidade | | Get | Busca oportunidade por ID | | Get Many | Lista oportunidades com filtros | | Get Many by Date Range | Lista oportunidades por período | | Update | Atualiza uma oportunidade (incluindo campos personalizados) | | Delete | Remove uma oportunidade |

Dropdowns dinâmicos

Os campos abaixo são carregados automaticamente da sua conta via API:

• Deal Stage → busca em getDealStages
• Owner → busca em getUsers
• Account → busca em getAccounts
• Campaign → busca em getCampaigns
• Custom Fields (Lead) → busca campos personalizados com relationship = lead
• Custom Fields (Opportunity) → busca campos personalizados com relationship = opportunity

Autenticação

A API SharpSpring usa accountID + secretKey passados como query string em cada requisição.

1. No SharpSpring, vá em Settings → API → Public API
2. Gere ou copie seu Account ID e Secret Key
3. No n8n, crie uma credencial SharpSpring API e preencha os campos

API Reference

Base URL: https://api.sharpspring.com/pubapi/{version}/

• v1: timestamps baseados no timezone da conta
• v1.2: timestamps em UTC (recomendado)

Todas as requisições usam POST com JSON no corpo, no formato:

{
  "method": "createLeads",
  "params": { "objects": [ {...} ] },
  "id": "uuid-aqui"
}

Instalação

cd ~/.n8n/custom
npm install n8n-nodes-sharpspring

Ou via Settings → Community Nodes no n8n.

Build

npm install
npm run build