n8n-nodes-rdstation-crm-v1

Node community para n8n que integra o RD Station CRM aos seus fluxos de trabalho via API v1 — utilizando apenas um token de API, sem necessidade de OAuth ou planos adicionais do RD Station Marketing.

Por que API v1? A versão 2 da API usa OAuth2, que exige um plano do RD Station Marketing (produto separado do CRM). Esta integração usa a API v1, acessível a qualquer conta do RD Station CRM com um simples token de API.

Instalação

Via interface do n8n (recomendado)

1. Acesse Configurações → Nodes da Comunidade
2. Clique em Instalar
3. Digite n8n-nodes-rdstation-crm-v1 e confirme

Via npm (instâncias self-hosted)

cd ~/.n8n/custom
npm install n8n-nodes-rdstation-crm-v1

Credenciais

Este node utiliza autenticação por Token de API:

1. No RD Station CRM, acesse Configurações → Integrações → Token de API
2. Copie o seu token de API
3. No n8n, crie uma nova credencial RD Station CRM API
4. Cole o token e salve

Recursos e Operações

Deal (Negociação)

| Operação | Descrição | |----------|-----------| | Create | Cria uma nova negociação | | Get | Busca uma negociação pelo ID | | Get Many | Lista negociações (com filtros e paginação) | | Update | Atualiza uma negociação |

Filtros disponíveis: nome, status ganho/perdido, etapa, funil, campanha, fonte, responsável, datas

Campos extras: vinculação a contato existente pelo ID

Contact (Contato)

| Operação | Descrição | |----------|-----------| | Create | Cria um novo contato | | Get | Busca um contato pelo ID | | Get Many | Lista contatos (com filtros) | | Update | Atualiza um contato |

Campos: nome, e-mails, telefones (com tipo), cargo, empresa, data de nascimento, redes sociais (Facebook, LinkedIn, Twitter, Instagram, Skype)

Organization (Empresa)

| Operação | Descrição | |----------|-----------| | Create | Cria uma nova empresa | | Get | Busca uma empresa pelo ID | | Get Many | Lista empresas | | Update | Atualiza uma empresa |

Campos: nome, site, endereço, cidade, estado, país, telefone, e-mail, redes sociais

Task (Tarefa)

| Operação | Descrição | |----------|-----------| | Create | Cria uma nova tarefa | | Get | Busca uma tarefa pelo ID | | Get Many | Lista tarefas (com filtros) | | Update | Atualiza uma tarefa |

Tipos: Ligação, E-mail, Reunião, Tarefa, Almoço, Visita, WhatsApp Filtros: tipo, status de conclusão, responsável, negociação, contato, data de vencimento

Product (Produto)

| Operação | Descrição | |----------|-----------| | Create | Cria um novo produto | | Get | Busca um produto pelo ID | | Get Many | Lista produtos | | Update | Atualiza um produto |

Deal Product (Produto da Negociação)

| Operação | Descrição | |----------|-----------| | Create | Adiciona um produto a uma negociação | | Get Many | Lista todos os produtos de uma negociação | | Update | Atualiza um produto na negociação | | Delete | Remove um produto da negociação |

Activity (Anotação)

| Operação | Descrição | |----------|-----------| | Create | Cria uma anotação em uma negociação | | Get Many | Lista anotações (filtro por negociação) |

Custom Field (Campo Personalizado)

| Operação | Descrição | |----------|-----------| | Create | Cria um campo personalizado | | Get | Busca um campo personalizado pelo ID | | Get Many | Lista campos personalizados (filtro por entidade) | | Update | Atualiza um campo personalizado | | Delete | Exclui um campo personalizado |

Entidades: Deal, Contact, Organization Tipos: Texto, Número, Data, Seleção, Checkbox, URL

Deal Pipeline (Funil de Vendas)

| Operação | Descrição | |----------|-----------| | Create | Cria um funil | | Get | Busca um funil pelo ID | | Get Many | Lista funis | | Update | Atualiza um funil |

Deal Stage (Etapa do Funil)

| Operação | Descrição | |----------|-----------| | Create | Cria uma etapa (requer funil) | | Get | Busca uma etapa pelo ID | | Get Many | Lista etapas (filtro por funil) | | Update | Atualiza uma etapa |

Campaign (Campanha)

| Operação | Descrição | |----------|-----------| | Create | Cria uma campanha | | Get | Busca uma campanha pelo ID | | Get Many | Lista campanhas | | Update | Atualiza uma campanha |

Source (Fonte de Negociação)

| Operação | Descrição | |----------|-----------| | Create | Cria uma fonte de negociação | | Get | Busca uma fonte pelo ID | | Get Many | Lista fontes | | Update | Atualiza uma fonte |

Lost Reason (Motivo de Perda)

| Operação | Descrição | |----------|-----------| | Create | Cria um motivo de perda | | Get Many | Lista motivos de perda |

User (Usuário) — somente leitura

| Operação | Descrição | |----------|-----------| | Get | Busca um usuário pelo ID | | Get Many | Lista todos os usuários |

Team (Equipe) — somente leitura

| Operação | Descrição | |----------|-----------| | Get | Busca uma equipe pelo ID | | Get Many | Lista todas as equipes |

Exemplos de Uso

Criar uma negociação e adicionar um produto

1. RD Station CRM → Recurso: Deal → Operação: Create
   - Nome: "Proposta Empresa ABC"
   - Campos Adicionais: etapa, funil, responsável

2. RD Station CRM → Recurso: Deal Product → Operação: Create
   - ID da Negociação: {{ $json.id }}  (do nó anterior)
   - ID do Produto: "uuid-do-produto"
   - Quantidade: 5
   - Preço: 199.90

Criar uma negociação vinculada a um contato existente

1. RD Station CRM → Recurso: Deal → Operação: Create
   - Nome: "Proposta Empresa ABC"
   - Campos Adicionais → ID do Contato: "uuid-do-contato"

Buscar contatos por e-mail

1. RD Station CRM → Recurso: Contact → Operação: Get Many
   - Filtros → E-mail: "[email protected]"

Registrar uma anotação em uma negociação

1. RD Station CRM → Recurso: Activity → Operação: Create
   - ID da Negociação: "uuid-da-negociacao"
   - Texto: "Reunião realizada, cliente interessado."

Compatibilidade

• n8n: 1.0.0 ou superior
• Node.js: 18.0.0 ou superior
• RD Station CRM API: v1

Recursos

• Documentação da API RD Station CRM v1
• RD Station CRM
• Documentação do n8n
• Fórum da Comunidade n8n

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou pull request no GitHub.

Licença

MIT

Desenvolvido com ❤️ para a comunidade n8n por Eliel Alves