FlowFact para TYPO3

Corretores de imóveis perdem leads quando transferem objetos manualmente para o site

Um corretor mantém seu portfólio de objetos no FlowFact: fotos, plantas, preços, características de equipamento, textos de exposição. Os mesmos dados devem aparecer no próprio site, em portais imobiliários e em apresentações impressas. Sem sincronização automática, alguém digita os dados duas vezes, esquece a atualização após uma mudança de preço ou publica um imóvel já vendido. O resultado: anúncios incorretos, contato irritado com clientes, leads perdidos.

FlowFact (desde 2019 parte do grupo Hypoport) é um dos sistemas CRM mais utilizados no setor imobiliário. A integração TYPO3 sincroniza objetos automaticamente do FlowFact para o site do corretor, sem intervenção manual. A Gosign implementou essa integração para escritórios de corretagem com 50 a 2.000 objetos ativos.

Cenários típicos de uso

Escritórios de corretagem regionais com site próprio. Um escritório com 3 a 10 corretores mantém 200 a 500 objetos ativos no FlowFact. O site exibe listagens com função de busca (CEP, número de quartos, faixa de preço, tipo de objeto), páginas de detalhe com galeria de imagens e planta, download de exposição como PDF e um formulário de contato que encaminha a consulta diretamente ao corretor responsável no FlowFact. Novos objetos aparecem no site em até 15 minutos, mudanças de status (vendido, reservado) são atualizadas automaticamente.

Incorporadoras e construtoras. Empresas que comercializam projetos de construção nova precisam, além da busca de objetos, de landing pages com descrição da obra, mapa de localização e visão geral de unidades como tabela interativa. FlowFact fornece os dados dos objetos, TYPO3 o ambiente editorial para textos e conteúdo de marketing. Ambos os mundos são conectados via API.

Administradoras com portal de inquilinos. Administradoras utilizam FlowFact para gerenciar imóveis para locação. O site TYPO3 exibe apartamentos disponíveis, coleta candidaturas via formulário e as encaminha como contato no FlowFact. Particularidade: a lista de objetos filtra automaticamente por “para locação”, não por “para venda”.

Arquitetura técnica

A conexão entre FlowFact e TYPO3 funciona por duas interfaces possíveis. O caminho clássico é OpenImmo, um padrão XML setorial para troca de dados imobiliários. FlowFact exporta objetos como XML OpenImmo (manualmente ou por scheduler), um importador TYPO3 lê os arquivos e cria registros.

O caminho moderno é a API REST FlowFact (desde FlowFact v3). O servidor TYPO3 consulta dados de objetos, imagens e contatos via requests HTTP e os sincroniza no banco de dados local. Vantagens sobre OpenImmo: capacidade de tempo real (polling a cada 5 minutos em vez de exportação diária), atualizações granulares (apenas campos alterados) e acesso a dados específicos do FlowFact que não constam no padrão OpenImmo.

No lado TYPO3, objetos são armazenados como registros em tabela própria (não como páginas TYPO3). Páginas de listagem utilizam repositórios Extbase com funções de filtro. Páginas de detalhe são renderizadas via show action, que carrega imagens do FAL e exibe plantas como overlay. A integração de mapa ocorre via Leaflet ou Google Maps, com geocoordenadas obtidas do FlowFact.

Problemas frequentes e soluções

Imagens faltam após a importação. Exportações OpenImmo referenciam imagens como nomes de arquivo, mas nem sempre entregam os arquivos junto. Solução: configurar a exportação para que imagens sejam embutidas como Base64 no XML ou transferidas via FTP paralelamente ao XML. Na API REST, imagens são baixadas por endpoints próprios e devem ser importadas como referências FAL no TYPO3.

Objetos desaparecem após o sync. Quando FlowFact desativa ou exclui um objeto, o importador TYPO3 deve decidir: excluir o registro, ocultar ou marcar como “vendido”? Importadores padrão frequentemente excluem de forma agressiva. Solução: implementar soft-delete que marca objetos como “inativos” primeiro e só os remove fisicamente após 30 dias. Assim, URLs relevantes para SEO são preservadas e podem redirecionar via 301 para a página de visão geral.

Consultas do formulário de contato se perdem. O formulário envia um e-mail, mas o lead não é criado como contato no FlowFact. Solução: criar consultas do formulário via API FlowFact como contato com referência ao objeto. O corretor responsável vê o lead diretamente no seu dashboard. Para isso, o formulário precisa do ID do objeto FlowFact como campo oculto.

Migração e compatibilidade de versões

FlowFact introduziu em 2019 uma plataforma completamente nova (FlowFact v3). A versão antiga (FlowFact Classic) ainda opera, mas não recebe novos recursos. A API REST está disponível apenas na v3. Integrações OpenImmo existentes funcionam com ambas as versões, mas a abordagem baseada em API só é possível com v3.

No lado TYPO3, não existe extensão oficial FlowFact com suporte v12/v13 no TER. A maioria das instalações usa importadores personalizados ou a extensão openimmo (com adaptações). A Gosign recomenda, em upgrades TYPO3 para v12+, migrar simultaneamente a integração imobiliária para a API REST FlowFact, em vez de portar o workflow XML OpenImmo. A abordagem baseada em API requer menos manutenção e permite recursos como disponibilidade em tempo real, que não são realizáveis com exportação XML.

Um projeto típico de integração FlowFact-TYPO3 (importação de objetos, função de busca, páginas de detalhe, formulário de contato com roteamento de leads) é calculado pela Gosign com 10 a 15 dias de desenvolvimento. A manutenção contínua se limita a atualizações de API e ajustes ocasionais em mudanças de campo no esquema FlowFact.