n8n-nodes-financiagil

Community node da plataforma Financiagil. Um único node com Resource + Operation, credencial única Financiagil API (baseUrl + x-api-key).

Versão: 2.3.0

Resources e Operations

Mensagem (Messaging — legado 2.1.x)

| Operação | API | |----------|-----| | text / buttons / list | POST /messaging/send-text | | media | POST /messaging/send-media | | typing | POST /messaging/send-typing |

Cadastro (novo em 2.2)

Mapeia 1:1 para Backend/api/src/fastify/routes/n8n.js.

| Grupo | Operações | API (path /n8n/...) | |-------|-----------|-----------------------| | Lookup | porTelefone, clientePorTelefone, corretorPorTelefone, checkStatus, fallbacks | GET /por-telefone, /cliente-por-telefone, /corretor-por-telefone, /check-status, /fallbacks | | Busca | buscaVinculo, buscaImobiliaria, buscaGerente, searchImobiliarias/Gerentes/Corretores/Clientes | GET /busca-vinculo, /busca-imobiliaria, /busca-gerente, /imobiliarias, /gerentes, /corretores, /clientes | | Write | createCliente, createCorretor, createGerente, createImobiliaria, createProcesso | POST /clientes, /corretores, /gerentes/cadastro, /imobiliarias/cadastro, /processos | | Update | updateCliente, updateCorretor | PUT /clientes/:id, /corretores/:id |

O campo Extras (JSON) permite mesclar chaves adicionais no body (CPF, renda_mensal, estado_civil, etc.).

Chatwoot (novo em 2.2)

| Operação | API | |----------|-----| | ensureContact | POST /n8n/chatwoot/ensure-contact | | handoff | POST /n8n/chatwoot/handoff | | applyState (novo em 2.3) | POST /n8n/chatwoot/apply-state |

Body ensureContact: { tipo: "lead"|"corretor"|"gerente", id: number }. Body handoff: { conversation_id, chatwoot_contact_id?, tipo?, id?, team_key?, motivo? }. Body applyState: { intent, conversation_id?, chatwoot_contact_id?, phone?, team_key?, tipo?, id? }.

applyState — intents (Fase 2)

O N8N envia apenas a intenção; a API é dona das mutações Chatwoot (labels, time, status).

| intent | Efeito | |----------|--------| | cadastro_pendente | Aplica label cadastro_pendente (merge). Sem handoff. | | cadastro_completo | Handoff motivo cadastro_completo (labels transferido_humano, cadastro_completo, atendimento_manual + time + status open). | | simulacao | Handoff motivo simulacao. | | documentacao | Handoff motivo documentacao. | | erro | Handoff motivo erro (prioridade high). | | handoff / atendimento_manual | Handoff motivo default. |

Resolução de conversa (algum identificador é obrigatório):

1. conversation_id (se informado)
2. chatwoot_contact_id → API busca conversa aberta
3. phone → API normaliza e resolve via mirror Chatwoot
4. Sem identificador → 400.

Detalhes de labels: docs/CHATWOOT-TIMES-E-LABELS.md § apply-state.

Simulação (novo em 2.2 — baixa frequência)

| Operação | API | |----------|-----| | simulacaoRender | POST /n8n/simulacao-render |

Body = JSON da simulação (valor_financiado, prazo, valor_imovel?, data_nascimento?, nome?, telefone?).

Credencial

Financiagil API — baseUrl (ex.: https://api.financiagil.com/api) + x-api-key (API_KEY_N8N_BOT).

Compatibilidade

• Bump do node description para version: 5. N8N migra automaticamente parâmetros ocultos.

Instalação (n8n)

Settings → Community Nodes → Install → n8n-nodes-financiagil

Repositório

clickecheck/financiagil — integrations/n8n-nodes-financiagil/

Não incluído nesta versão

• Cache Redis phone→contact_id no worker bot (Fase 3).
• Migração dos ~500 workflows do HTTP Request para o node.