n8n-nodes-linqer-crm

Nó customizado do n8n para integração com a API do CRM Linqer.

Instalação

Via npm (Recomendado)

npm install n8n-nodes-linqer-crm

Via n8n Community Nodes

1. Abra o n8n
2. Vá em Settings > Community Nodes
3. Clique em Install a community node
4. Digite: n8n-nodes-linqer-crm
5. Clique em Install

Instalação Manual

1. Clone este repositório
2. Execute npm install para instalar as dependências
3. Execute npm run build para compilar o projeto
4. Copie a pasta dist para o diretório de nós customizados do n8n

Configuração

Credenciais

Antes de usar o nó, você precisa configurar as credenciais da API do Linqer:

1. No n8n, vá em Credentials
2. Clique em + Add Credential
3. Procure por Linqer CRM API
4. Preencha os campos:
   • URL da API: https://api.app.linqer.com.br
   • Tipo de Autenticação: Escolha entre Bearer Token ou API Key Pública
   • Bearer Token ou API Key: Sua chave de autenticação
   • Company ID: ID da sua empresa (opcional, mas recomendado)

Recursos Disponíveis

Contatos

• Criar: Criar um novo contato
• Buscar Todos: Listar todos os contatos
• Buscar por ID: Buscar um contato específico
• Atualizar: Atualizar dados de um contato
• Deletar: Remover um contato

Oportunidades

• Criar: Criar uma nova oportunidade
• Buscar Todas: Listar todas as oportunidades
• Buscar por ID: Buscar uma oportunidade específica
• Buscar por Funil: Filtrar oportunidades por funil
• Atualizar: Atualizar uma oportunidade
• Deletar: Remover uma oportunidade

Tarefas

• Criar: Criar uma nova tarefa
• Buscar Todas: Listar todas as tarefas
• Atualizar: Atualizar uma tarefa
• Deletar: Remover uma tarefa

Produtos ✨ NOVO

• Criar: Criar um novo produto
• Buscar Todos: Listar todos os produtos
• Buscar por ID: Buscar um produto específico
• Atualizar: Atualizar dados de um produto
• Deletar: Remover um produto

Funis ✨ NOVO

• Buscar Todos: Listar todos os funis
• Buscar por ID: Buscar um funil específico

Campos Personalizados ✨ NOVO

• Criar: Criar um novo campo personalizado
• Buscar Todos: Listar todos os campos personalizados
• Buscar por ID: Buscar um campo específico
• Atualizar: Atualizar um campo personalizado
• Deletar: Remover um campo personalizado

Notas

• Criar: Criar uma nova nota
• Buscar por Oportunidade: Buscar notas de uma oportunidade

Anexos

• Upload: Fazer upload de arquivos para oportunidades

Propostas ✨ NOVO

• Upload: Fazer upload de propostas
• Buscar Todas: Listar todas as propostas
• Deletar: Remover uma proposta

Webhooks ✨ NOVO

• Criar: Criar um novo webhook
• Buscar Todos: Listar todos os webhooks
• Buscar por ID: Buscar um webhook específico
• Atualizar: Atualizar um webhook
• Deletar: Remover um webhook

Exemplos de Uso

Criar um Contato

{
  "name": "João Silva",
  "email": "[email protected]",
  "mainPhone": "11999999999",
  "type": "individual",
  "document": "12345678900",
  "documentType": "cpf",
  "industry": "Tecnologia",
  "active": true
}

Criar uma Oportunidade

{
  "title": "Venda de Software",
  "description": "Oportunidade de venda de sistema CRM",
  "value": 5000,
  "contactId": "id-do-contato",
  "funnelId": "id-do-funil",
  "stageId": "stage_1"
}

Criar uma Tarefa

{
  "opportunityId": "id-da-oportunidade",
  "description": "Ligar para o cliente",
  "date": "2025-05-25",
  "time": "14:00",
  "duration": "1"
}

Autenticação

O nó suporta dois tipos de autenticação:

Bearer Token

Use o token JWT obtido através do login na API.

API Key Pública

Use a chave pública no formato base64 (userId:companyId).

Tratamento de Erros

O nó possui tratamento de erros integrado. Em caso de falha:

• Se "Continue on Fail" estiver habilitado, o erro será retornado como dados
• Caso contrário, a execução será interrompida

Desenvolvimento

Estrutura do Projeto

n8n-nodes-linqer-crm/
├── credentials/
│   └── LinqerCrmApi.credentials.ts
├── nodes/
│   └── LinqerCrm/
│       ├── LinqerCrm.node.ts
│       ├── linqer.svg
│       └── descriptions/
│           ├── ContactsDescription.ts
│           ├── OpportunitiesDescription.ts
│           └── TasksDescription.ts
├── package.json
├── tsconfig.json
└── gulpfile.js

Scripts Disponíveis

• npm run build: Compila o projeto
• npm run dev: Modo de desenvolvimento com watch
• npm run lint: Executa o linter
• npm run format: Formata o código

Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -am 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

Licença

MIT

Suporte

Para suporte, abra uma issue no repositório do GitHub ou entre em contato através do email de suporte.

Changelog

v1.0.16 ✨ NOVO

• NOVO: Substituição de Pipelines por Funis
• NOVO: Endpoints de Funis (/v1/funnel/public/all e /v1/funnel/public/{id})
• CORREÇÃO: Removido campo companyId obrigatório das oportunidades
• Atualização da documentação

v1.0.15

• CORREÇÃO: Removido campo companyId obrigatório das oportunidades
• Correções de bugs menores

v1.0.14

• NOVO: Suporte para Produtos (CRUD completo)
• NOVO: Suporte para Campos Personalizados (CRUD completo)
• NOVO: Suporte para Webhooks (CRUD completo)
• NOVO: Suporte para Propostas (Upload, buscar e deletar)
• ATUALIZADO: Estrutura de Tarefas baseada na API atualizada
• TOTAL: 10 recursos disponíveis
• Todos os endpoints do Postman implementados

v1.0.13

• Melhorias na autenticação
• Correções de bugs
• Otimizações de performance

v1.0.0

• Implementação inicial
• Suporte para Contatos, Oportunidades e Tarefas
• Autenticação via Bearer Token e API Key
• Tratamento de erros integrado