FlowFact para TYPO3

Las agencias inmobiliarias pierden leads cuando los inmuebles se transfieren manualmente a la web

Un agente inmobiliario gestiona su cartera de propiedades en FlowFact: fotos, planos, precios, características de equipamiento, textos de exposé. Los mismos datos deben aparecer en su propia web, en Idealista, en Fotocasa y en exposés impresos. Sin sincronización automática, alguien introduce los datos por duplicado, olvida actualizar tras un cambio de precio o publica un inmueble ya vendido. La consecuencia: anuncios erróneos, contactos irritados, leads perdidos.

FlowFact (parte del grupo Hypoport desde 2019) es uno de los CRM más utilizados en el sector inmobiliario europeo. La conexión con TYPO3 sincroniza automáticamente las propiedades de FlowFact con la web de la agencia, sin intervención manual. Gosign ha implementado esta integración para agencias con entre 50 y 2.000 inmuebles activos.

Escenarios de uso habituales

Agencias inmobiliarias regionales con web propia. Una oficina con 3 a 10 agentes gestiona entre 200 y 500 propiedades activas en FlowFact. La web muestra listados con función de búsqueda (código postal, número de habitaciones, rango de precio, tipo de inmueble), páginas de detalle con galería de imágenes y plano, descarga de exposé en PDF y un formulario de contacto que enruta la consulta directamente al agente responsable en FlowFact. Las nuevas propiedades aparecen en la web en 15 minutos; los cambios de estado (vendido, reservado) se recogen automáticamente.

Promotores y constructores. Empresas que comercializan proyectos de obra nueva necesitan, además de la búsqueda de inmuebles, landing pages de proyecto con descripción de obra, plano de situación y resumen de viviendas como tabla interactiva. FlowFact aporta los datos de los inmuebles; TYPO3 proporciona el entorno editorial para textos de proyecto y contenido de marketing. Ambos mundos se conectan a través de la API.

Administradores de fincas con portal de inquilinos. Las administraciones de fincas usan FlowFact para gestionar inmuebles de alquiler. La web TYPO3 muestra las viviendas disponibles, recoge solicitudes mediante formulario y las reenvía como contacto a FlowFact. Particularidad: el listado filtra automáticamente por “en alquiler”, no por “en venta”.

Arquitectura técnica

La conexión entre FlowFact y TYPO3 funciona a través de dos interfaces posibles. La vía clásica es OpenImmo, un estándar XML del sector para el intercambio de datos inmobiliarios. FlowFact exporta propiedades como XML OpenImmo (manualmente o por scheduler); un importador TYPO3 lee los archivos y crea registros. Extensiones como openimmo o importadores a medida procesan la estructura XML.

La vía más moderna es la API REST de FlowFact (desde FlowFact v3). El servidor TYPO3 consulta datos de propiedades, imágenes y contactos mediante peticiones HTTP y los sincroniza en la base de datos local. Ventajas frente a OpenImmo: capacidad de tiempo real (polling cada 5 minutos en lugar de exportación diaria), actualizaciones granulares (solo campos modificados) y acceso a datos específicos de FlowFact no incluidos en el estándar OpenImmo (por ejemplo, notas internas, estado del lead).

En el lado TYPO3, las propiedades se almacenan como registros en una tabla propia (no como páginas TYPO3). Las páginas de listado usan repositorios Extbase con funciones de filtrado. Las páginas de detalle se renderizan vía Show Action, cargando imágenes desde FAL (File Abstraction Layer) y mostrando planos como overlay. La integración de mapas se realiza mediante Leaflet o Google Maps, tomando las geocoordenadas de FlowFact.

Problemas frecuentes y soluciones

Faltan imágenes tras la importación. Las exportaciones OpenImmo referencian imágenes por nombre de archivo pero no siempre las entregan. Solución: configurar la exportación para que las imágenes se incrusten como Base64 en el XML o se transfieran por FTP en paralelo. Con la API REST, las imágenes se descargan mediante endpoints propios y deben importarse como referencias FAL en TYPO3.

Las propiedades desaparecen tras la sincronización. Cuando FlowFact desactiva o elimina una propiedad, el importador TYPO3 debe decidir: eliminar el registro, ocultarlo o marcarlo como “vendido”. Los importadores estándar suelen eliminar de forma agresiva. Solución: implementar un soft-delete que marque las propiedades como “inactivas” y solo las elimine físicamente después de 30 días. Así se preservan las URLs relevantes para SEO y se pueden configurar redirecciones 301 a la página de resumen.

Las consultas del formulario de contacto se pierden. El formulario envía un email, pero el lead no se crea como contacto en FlowFact. Solución: crear las consultas del formulario como contacto con referencia a la propiedad vía la API de FlowFact. El agente responsable ve el lead directamente en su panel. Para ello, el formulario necesita el ID de propiedad de FlowFact como campo oculto.

Migración y compatibilidad de versiones

FlowFact introdujo en 2019 una plataforma completamente nueva (FlowFact v3). La versión anterior (FlowFact Classic) sigue en funcionamiento pero no recibe nuevas funcionalidades. La API REST solo está disponible en v3. Las integraciones OpenImmo existentes funcionan con ambas versiones, pero el enfoque basado en API solo es posible con v3.

En el lado TYPO3, no existe una extensión oficial de FlowFact con soporte v12/v13 en el TER. La mayoría de las instalaciones usan importadores a medida o la extensión openimmo (con adaptaciones). Gosign recomienda, al actualizar TYPO3 a v12+, migrar simultáneamente la conexión inmobiliaria a la API REST de FlowFact, en lugar de portar el flujo de trabajo con XML OpenImmo. El enfoque basado en API requiere menos mantenimiento y permite funcionalidades como la disponibilidad en tiempo real, imposibles con la exportación XML.

Un proyecto típico de integración FlowFact-TYPO3 (importación de propiedades, función de búsqueda, páginas de detalle, formulario de contacto con routing de leads) se estima en 10 a 15 días de desarrollo. El mantenimiento continuo se limita a actualizaciones de la API y ajustes ocasionales ante cambios en el esquema de FlowFact.