n8n-nodes-portalimob

Node n8n para integração com a API REST do Portalimob - Sistema de gestão imobiliária.

Recursos

Este node permite integrar o n8n com o Portalimob para:

📋 Imóveis

• Listar imóveis com filtros (tipo de transação, tipo de imóvel, status)

👥 Leads

• Criar novos leads
• Listar leads com filtros (status, origem)
• Mover leads entre etapas do pipeline
• Adicionar tags aos leads

🏢 Clientes

• Criar novos clientes
• Listar clientes com filtros (tipo, status)
• Adicionar tags aos clientes

🏷️ Tags

• Listar todas as tags disponíveis

Instalação

Community Nodes (Recomendado)

1. Vá em Settings > Community Nodes
2. Selecione Install
3. Digite n8n-nodes-portalimob
4. Aceite os riscos e instale

Instalação Manual

npm install n8n-nodes-portalimob

Configuração

Obter a API Key

1. Acesse o Portalimob
2. Vá em Configurações > API REST
3. Gere sua chave API
4. Copie a chave gerada

Configurar Credenciais no n8n

1. No n8n, adicione o node Portalimob
2. Clique em Create New Credentials
3. Cole sua API Key
4. Salve as credenciais

Uso

Exemplo: Criar um Lead

1. Adicione o node Portalimob
2. Selecione:
   • Resource: Lead
   • Operation: Create
3. Preencha os campos:
   • Nome: Nome do lead
   • Email: (opcional)
   • Telefone: (opcional)
   • Origem: site, telefone, email, etc.

Exemplo: Listar Imóveis Disponíveis

1. Adicione o node Portalimob
2. Selecione:
   • Resource: Imóvel
   • Operation: Get Many
3. Em Filters, adicione:
   • Status: Disponível
   • Transaction Type: Venda

Exemplo: Adicionar Tag a um Cliente

1. Adicione o node Portalimob
2. Selecione:
   • Resource: Cliente
   • Operation: Add Tag
3. Preencha:
   • Client ID: UUID do cliente
   • Tag: Nome da tag (ex: "VIP")

Rate Limiting

A API do Portalimob possui limite de requisições:

• Padrão: 60 requisições por minuto
• Headers de resposta informam o limite e requisições restantes

Desenvolvimento

# Instalar dependências
npm install

# Compilar o node
npm run build

# Modo watch (desenvolvimento)
npm run dev

# Formatar código
npm run format

# Lint
npm run lint

Estrutura do Projeto

n8n-nodes-portalimob/
├── credentials/
│   └── PortalimobApi.credentials.ts
├── nodes/
│   └── Portalimob/
│       ├── Portalimob.node.ts
│       └── portalimob.svg
├── dist/                    # Arquivos compilados
├── package.json
└── tsconfig.json

Suporte

Para problemas ou dúvidas sobre a API do Portalimob, consulte a documentação oficial ou entre em contato com o suporte.

Licença

MIT