n8n-nodes-rd-station-crm

Nós personalizados do n8n para integração com a API do RD Station CRM (v1).

🚀 Funcionalidades

Este pacote fornece nós personalizados para o n8n que permitem integração completa com a API do RD Station CRM, incluindo:

📋 Nós Disponíveis

1. RD Station CRM Contatos - Gerenciamento de contatos
2. RD Station CRM Negócios - Operações com negócios/deals
3. RD Station CRM Tarefas - Gestão de tarefas
4. RD Station CRM Notas - Criação e gerenciamento de notas
5. RD Station CRM Empresas - Operações com empresas
6. RD Station CRM Produtos de Negócio - Gestão de produtos em negócios
7. RD Station CRM Usuários - Informações de usuários
8. RD Station CRM Times - Gestão de equipes
9. RD Station CRM Pipelines - Operações com funis de vendas
10. RD Station CRM Campanhas - Gestão de campanhas
11. RD Station CRM Fontes - Informações sobre fontes de leads
12. RD Station CRM Motivos de Perda - Gestão de motivos de perda
13. RD Station CRM Webhooks - Configuração de webhooks

🔑 Credenciais

• RD Station CRM API - Autenticação via token de API

📦 Instalação

Instalação via n8n Community Nodes

1. Acesse as configurações do n8n
2. Vá para "Community Nodes"
3. Clique em "Install"
4. Digite: n8n-nodes-rd-station-crm
5. Clique em "Install"

Instalação Manual

# Clone o repositório
git clone https://github.com/rdstation/n8n-nodes-rd-station-crm.git
cd n8n-nodes-rd-station-crm

# Instale as dependências
npm install

# Compile o projeto
npm run build

# Instale globalmente (opcional)
npm install -g .

🔧 Configuração

Obtendo o Token de API

1. Acesse sua conta do RD Station CRM
2. Vá para Configurações > Integrações > API
3. Gere um novo token de API
4. Copie o token gerado

Configurando as Credenciais no n8n

1. No n8n, vá para "Credentials"
2. Clique em "Add Credential"
3. Selecione "RD Station CRM API"
4. Cole seu token de API no campo correspondente
5. Teste a conexão e salve

🛠️ Desenvolvimento

Estrutura do Projeto

n8n-nodes-rd-station-crm/
├── credentials/           # Definições de credenciais
│   └── RdStationCrmApi.credentials.ts
├── nodes/                # Nós do n8n
│   ├── RdStationCrmContacts.node.ts
│   ├── RdStationCrmDeals.node.ts
│   ├── RdStationCrmTasks.node.ts
│   ├── RdStationCrmNotes.node.ts
│   ├── RdStationCrmCompanies.node.ts
│   ├── RdStationCrmDealProducts.node.ts
│   ├── RdStationCrmUsers.node.ts
│   ├── RdStationCrmTeams.node.ts
│   ├── RdStationCrmPipelines.node.ts
│   ├── RdStationCrmCampaigns.node.ts
│   ├── RdStationCrmSources.node.ts
│   ├── RdStationCrmLossReasons.node.ts
│   ├── RdStationCrmWebhooks.node.ts
│   └── rdstation.svg      # Ícone dos nós
├── dist/                 # Arquivos compilados
├── index.ts              # Arquivo principal de exportação
├── package.json          # Configurações do pacote
├── tsconfig.json         # Configurações do TypeScript
└── gulpfile.js          # Tarefas de build

Scripts Disponíveis

# Compilar o projeto
npm run build

# Modo de desenvolvimento (watch)
npm run dev

# Executar linter
npm run lint

# Corrigir problemas de linting
npm run lintfix

# Formatar código
npm run format

🔄 Correções Implementadas

Versão 1.0.2 - Correções de Carregamento

Problemas Corrigidos:

1. Inconsistência no package.json: Removidos nós inexistentes (RdStationCrmFunnels, RdStationCrmStages) e adicionado o nó RdStationCrmPipelines que estava faltando
2. Arquivo index.js otimizado: Simplificado para apenas redirecionar para dist/index.js
3. Configuração TypeScript melhorada: Adicionadas opções para melhor compatibilidade
4. Estrutura de diretórios corrigida: Removidos subdiretórios desnecessários em dist/nodes
5. Gulpfile otimizado: Corrigida a cópia de ícones SVG

Erro Resolvido:

Error loading package "n8n-nodes-rd-station-crm": The "paths[1]" argument must be of type string. Received an instance of Object

Alterações Técnicas:

• Corrigida a exportação de nodeTypes e credentialTypes no arquivo principal
• Melhorada a resolução de módulos no TypeScript
• Removidas estruturas de diretórios duplicadas
• Otimizada a configuração do Gulp para cópia de ícones

📚 Documentação da API

Para mais informações sobre a API do RD Station CRM, consulte:

• Documentação Oficial da API
• Guia de Autenticação

🤝 Contribuição

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🆘 Suporte

Se você encontrar problemas ou tiver dúvidas:

1. Verifique se o token de API está correto
2. Confirme se a versão do n8n é compatível
3. Consulte os logs do n8n para mais detalhes sobre erros
4. Abra uma issue no repositório do GitHub

📈 Versões

• 1.0.3 - Correções de carregamento e otimizações finais
• 1.0.2 - Correções de carregamento e otimizações
• 1.0.1 - Versão inicial com todos os nós básicos
• 1.0.0 - Primeira versão estável

🚀 Como Publicar no NPM

Para desenvolvedores que desejam publicar este pacote:

Pré-requisitos

1. Conta no npmjs.com
2. Login no npm: npm login

Opção 1: Script Automático (Windows)

# Execute o script de publicação
.\publish.bat
# ou
.\publish.ps1

Opção 2: Manual

# 1. Fazer build
npm run build

# 2. Verificar conteúdo
npm pack --dry-run

# 3. Publicar
npm publish

Verificação Pós-Publicação

• Acesse: https://www.npmjs.com/package/n8n-nodes-rd-station-crm
• Teste a instalação: npm install n8n-nodes-rd-station-crm