n8n-nodes-perfex-api

Nó da comunidade n8n para integração com o Perfex CRM através do módulo WON API.

📋 Descrição

Este nó permite integrar o Perfex CRM com n8n através da WON API, proporcionando acesso completo às funcionalidades de CRM incluindo leads, clientes, contatos, projetos, tarefas e faturas.

✅ Compatibilidade v0.2.1

WON API v2.1.1+

• ✅ Autenticação corrigida: Usa header X-API-TOKEN
• ✅ Endpoints compatíveis: Todos os endpoints seguem padrão WON API
• ✅ Operação JOIN: Compatível com busca por CNPJ/CPF
• ✅ Validações robustas: Arrays, datas e campos obrigatórios

🚀 Instalação

npm install n8n-nodes-perfex-api

⚙️ Configuração

1. Base URL: URL base da sua instalação Perfex (sem /api)

   • Exemplo: https://seu-perfex.com

2. API Token: Token gerado no Perfex CRM

   • Acesse: Setup > Settings > API
   • Gere um novo token
   • Configure o token nas credenciais do n8n

📚 Recursos Suportados

👥 Leads

• ✅ Listar leads
• ✅ Obter lead específico
• ✅ Criar novo lead
• ✅ Atualizar lead
• ✅ Excluir lead

🏢 Clientes (Customers)

• ✅ Listar clientes
• ✅ Obter cliente específico
• ✅ Criar novo cliente
• ✅ Excluir cliente

👤 Contatos

• ✅ Listar contatos por cliente
• ✅ Obter contato específico
• ✅ Criar novo contato
• ✅ Atualizar contato
• ✅ Excluir contato

🔧 Validações Implementadas

📅 Datas

• Formato obrigatório: YYYY-MM-DD
• Validação de datas válidas
• Mensagens de erro em português

🔢 Arrays

• Conversão automática de strings para arrays
• Remoção de valores inválidos (NaN)
• Limpeza de campos vazios

🚨 Logs de Debug

• Logs detalhados para debugging
• Informações de autenticação
• Detalhes de endpoint e método

📋 Exemplo de Uso

Criar um Lead

{
  "resource": "lead",
  "operation": "create",
  "name": "Lead Exemplo",
  "source": 1,
  "status": 1,
  "additionalFields": {
    "email": "[email protected]",
    "phone": "11999999999"
  }
}

Buscar Cliente por ID

{
  "resource": "customer",
  "operation": "get",
  "customerId": 123
}

🛠️ Desenvolvimento

# Instalar dependências
pnpm install

# Build
pnpm build

# Desenvolvimento (watch mode)
pnpm dev

# Linting
pnpm lint

# Formatação
pnpm format

📄 Licença

MIT

🤝 Contribuindo

Contribuições são bem-vindas! Por favor, abra uma issue ou pull request.

📞 Suporte

Para suporte, abra uma issue no GitHub ou entre em contato através dos canais oficiais.

Versão: 0.2.1
Compatibilidade: WON API v2.1.1+
n8n: ^1.0.0