🚀 Agendor CRM - Integração Completa para n8n

✨ 100% da API Agendor v3 em Português - Versão 2.1.2

🎯 Integração mais completa e intuitiva do Agendor para n8n - Interface 100% em português com estrutura otimizada

🎉 Novidades da Versão 2.1.2

✨ Melhorias nos Webhooks

• 🛣️ Path Customizável: Configure sufixo personalizado para URLs de webhook
• 🔧 Validação Automática: Sanitização automática de caracteres especiais no path
• 📋 Logs Aprimorados: Melhor visualização do path customizado nos logs
• 🔒 Formato Real: https://seu-n8n.com/webhook-test/[seu-path]

✨ Recursos da Versão 2.1.0 Mantidos

• 🔧 Estrutura Ultra-Otimizada: Nó único consolidado eliminando duplicações
• 🔍 Busca Avançada: Nova funcionalidade de busca simultânea em múltiplos recursos
• 🐛 Correções Críticas: Resolvidos problemas com operações de tarefas
• ⚡ Performance: Interface simplificada mantendo 100% da funcionalidade

✨ Recursos da Versão 2.0.0 Mantidos

• 🇧🇷 100% em Português: Interface completamente traduzida para o mercado brasileiro
• 🎯 Estrutura Otimizada: 37% menos complexidade mantendo 100% da funcionalidade
• 🚀 Cobertura Completa: 100% da API Agendor v3 implementada (vs. 25% anterior)
• 🧠 Busca Inteligente: Operações agrupadas logicamente por critério

📊 De 4 para 9 Resources Completos

✅ Pessoa (5 operações)        ✅ Funil (2 operações)
✅ Empresa (5 operações)       ✅ Produto (2 operações)
✅ Negócio (6 operações)       ✅ Usuário (1 operação)
✅ Tarefa (4 operações)        ✅ Sistema (3 operações)
✅ Busca Avançada (2 operações) 🆕 NOVO!

🎯 Funcionalidades Destacadas

🔍 Busca Inteligente Unificada

Cada resource possui busca unificada com múltiplos critérios:

👤 Pessoas

Buscar → Por ID | Por E-mail | Por Telefone | Por CPF | Listar Todos

🏢 Empresas

Buscar → Por ID | Por CNPJ | Listar Todos

💼 Negócios

Buscar → Por ID | Por Etapa | Por Responsável | Por Status | Por Empresa | Listar Todos

🔍 Busca Avançada (NOVO!) 🆕

Busca Global    → Múltiplos recursos simultaneamente (negócios, empresas, pessoas, etc.)
Busca por Termo → Busca inteligente por termo específico em todos os recursos selecionados

🔄 Operações Anti-Duplicação (Upsert)

• Pessoas: Criar ou atualizar por e-mail/CPF
• Empresas: Criar ou atualizar por CNPJ
• Automático: Se não existe cria, se existe atualiza

📈 Sincronização e Stream

• Atualizações Recentes: Buscar registros atualizados desde uma data
• Integração Perfeita: Ideal para sincronização com outros sistemas
• Pessoas, Empresas e Negócios: Todos suportam stream

🎯 Movimentação Inteligente de Negócios

Mover → Alterar Etapa | Alterar Status (Ganho/Perdido) | Alterar Funil

⚙️ Sistema e Metadados

• Categorias: Listar todas as categorias
• Origens de Lead: Obter origens disponíveis
• Campos Customizados: Por tipo (pessoas, empresas, negócios)

🚀 Instalação

Via npm

npm install n8n-nodes-agendor-integration

Via Community Nodes (n8n Cloud/Self-hosted)

1. Acesse Settings → Community Nodes
2. Clique em Install a community node
3. Digite: n8n-nodes-agendor-integration
4. Clique em Install

🔐 Configuração

1. Obter Token da API Agendor

1. Acesse sua conta no Agendor
2. Vá em Configurações → Integrações
3. Clique em Token de API
4. Copie seu token

2. Configurar Credenciais no n8n

1. No n8n, vá para Credentials
2. Clique em + Add Credential
3. Busque por Agendor API
4. Preencha:
   • API Token: Seu token copiado do Agendor
   • API URL: https://api.agendor.com.br/v3 (padrão)

📖 Exemplos de Uso

🔍 Buscar Pessoa por CPF

Recurso: Pessoa
Operação: Buscar
Tipo de Busca: Por CPF
CPF: 12345678901
Incluir Campos Customizados: true

🏢 Criar ou Atualizar Empresa (Anti-duplicação)

Recurso: Empresa
Operação: Criar ou Atualizar
Nome: Empresa XYZ
CNPJ: 12345678000195
E-mail: [email protected]

💼 Mover Negócio para Próxima Etapa

Recurso: Negócio
Operação: Mover
Tipo de Movimentação: Alterar Etapa
ID do Negócio: 123456
Nova Etapa: 5

📊 Listar Negócios Ganhos Recentemente

Recurso: Negócio
Operação: Buscar
Tipo de Busca: Por Status
Status: Ganho

📈 Sincronizar Atualizações

Recurso: Pessoa
Operação: Atualizações Recentes
Data Inicial: 2025-01-01T00:00:00Z

🌊 Obter Funis e Etapas

Recurso: Funil
Operação: Listar Funis

🔍 Nova Funcionalidade: Busca Avançada 🆕

Recurso: Busca Avançada
Operação: Busca Global
Recursos para Buscar: Negócios, Empresas, Pessoas

🎯 Busca por Termo Inteligente 🆕

Recurso: Busca Avançada
Operação: Busca por Termo
Termo de Busca: [email protected]
Recursos para Buscar: Pessoas, Empresas

🪝 Webhook com Path Customizado 🆕

Trigger: Agendor Trigger
Webhook Path: meu-agendor-crm
Event: Deal Created

Resultado: https://seu-n8n.com/webhook-test/meu-agendor-crm

🎯 Casos de Uso Avançados

1. Pipeline de Lead Qualification

Webhook → Pessoa (Criar ou Atualizar) → Empresa (Criar ou Atualizar) → Negócio (Criar)

2. Follow-up Automático

Schedule → Negócio (Buscar por Etapa) → Filter (sem atividade) → Tarefa (Criar)

3. Relatório de Performance

Schedule → Negócio (Buscar Ganhos) → Usuário (Listar) → Analytics (Calcular) → Email (Enviar)

4. Prevenção de Duplicatas

Webhook → Pessoa (Buscar por E-mail) → IF (não existe) → Pessoa (Criar) ELSE → Pessoa (Atualizar)

5. Sincronização Bidirecional

Schedule → Pessoa (Atualizações Recentes) → External System (Update) → Log (Success)

📋 Resources e Operações Completas

👤 Pessoa (5 operações)

• Buscar: ID, E-mail, Telefone, CPF, Listar Todos
• Criar: Nova pessoa com todos os campos
• Atualizar: Pessoa existente
• Criar ou Atualizar: Upsert por e-mail/CPF
• Atualizações Recentes: Stream de mudanças

🏢 Empresa (5 operações)

• Buscar: ID, CNPJ, Listar Todos
• Criar: Nova empresa com todos os campos
• Atualizar: Empresa existente
• Criar ou Atualizar: Upsert por CNPJ
• Atualizações Recentes: Stream de mudanças

💼 Negócio (6 operações)

• Buscar: ID, Etapa, Responsável, Status, Empresa, Listar Todos
• Criar: Novo negócio
• Atualizar: Negócio existente
• Mover: Etapa, Status, Funil
• Atualizações Recentes: Stream de mudanças
• Histórico de Movimentações: Log de mudanças

✅ Tarefa (4 operações)

• Criar: Nova tarefa
• Obter: Tarefa específica
• Listar: Múltiplas tarefas
• Atualizar: Tarefa existente

🌊 Funil (2 operações)

• Listar Funis: Todos os funis de vendas
• Listar Etapas: Etapas dos funis

📦 Produto (2 operações)

• Buscar: ID, Código, Listar Todos
• Criar: Novo produto

👥 Usuário (1 operação)

• Buscar: ID, E-mail, Listar Todos

⚙️ Sistema (3 operações)

• Obter Categorias: Todas as categorias
• Obter Origens de Lead: Todas as origens
• Obter Campos Customizados: Por tipo de entidade

🔍 Busca Avançada (2 operações) 🆕

• Busca Global: Buscar simultaneamente em negócios, empresas, pessoas, produtos e tarefas
• Busca por Termo: Busca inteligente com detecção automática de tipo (email, telefone, CNPJ)

🔧 Desenvolvimento

Pré-requisitos

• Node.js 18+
• npm/pnpm

Setup Local

git clone https://github.com/leonidasjf/agendor_crm-n8n-nodes
cd agendor_crm-n8n-nodes
npm install
npm run build

Scripts Disponíveis

npm run build      # Build do projeto
npm run dev        # Watch mode para desenvolvimento
npm run lint       # Lint do código
npm run format     # Format do código

📚 Documentação e Recursos

🔗 Links Úteis

• Documentação Agendor API v3
• n8n Community Nodes
• GitHub Repository

📖 Documentação do Projeto

• AGENDOR_API_MAPPING.md - Mapeamento completo da API
• AGENDOR_NODE_OPTIMIZATION.md - Estrutura otimizada
• TRADUCAO_INTERFACE.md - Guia de tradução
• AGENDOR_NODE_COMPLETO.md - Documentação completa

🤝 Contribuição

Contribuições são bem-vindas! Por favor:

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

📊 Comparação de Versões

| Aspecto | v1.x | v2.0.0 | |---------|------|--------| | Resources | 4 | 9 | | Operações | 16 | 30 | | Cobertura da API | ~25% | 100% | | Interface | Inglês | Português | | Busca | Fragmentada | Unificada + Avançada | | Upsert | ❌ | ✅ | | Stream | ❌ | ✅ | | Campos Customizados | ❌ | ✅ | | Busca Multi-recursos | ❌ | ✅ |

🏷️ Keywords

n8n, agendor, crm, automation, workflow, integration, sales, pipeline, leads, brasil, português

⚖️ Termos e Responsabilidade

• Não-oficial: Este node não é desenvolvido, mantido ou endossado pela empresa Agendor
• Independente: Projeto independente não afiliado ao Agendor
• Responsabilidade: O uso é por conta e risco do usuário

🚀 Desenvolvido por Leônidas Caldeira

Transforme seu CRM em uma máquina de automação!