financiagil

Node Financiagil — Messaging + Cadastro + Chatwoot (ensure/handoff/apply-state) + Simulação (Resource+Operation)

Package Information

Released: 3 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 2.3.0

Available Nodes

Documentation generating…

Financiagil icon
Financiagil
Gateway Financiagil: Messaging (texto/botões/lista/mídia/digitando), Cadastro (lookups/CRUD bot), Chatwoot (ensure-contact/handoff/apply-state) e Simulação (render). Usa x-api-key e espelha no Chatwoot quando ativado.

Documentation

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.

Discussion