FlowFact dla TYPO3

Pośrednicy nieruchomości tracą leady, gdy obiekty są ręcznie przenoszone na stronę

Pośrednik zarządza swoim portfolio obiektów w FlowFact: zdjęcia, rzuty, ceny, wyposażenie, teksty ekspoze. Te same dane mają pojawić się na własnej stronie internetowej, na portalach nieruchomości i w drukowanych ekspoze. Bez automatycznej synchronizacji ktoś wpisuje dane podwójnie, zapomina o aktualizacji po zmianie ceny lub publikuje już sprzedany obiekt. Konsekwencja: fałszywe ogłoszenia, zirytowani klienci, utracone leady.

FlowFact (od 2019 roku część grupy Hypoport) to jeden z najczęściej używanych systemów CRM w branży nieruchomości. Ponad 10 000 pośredników z niego korzysta. Integracja z TYPO3 automatycznie synchronizuje obiekty z FlowFact na stronę pośrednika, bez ręcznej interwencji. Gosign wdrożył tę integrację dla biur z 50 do 2000 aktywnych obiektów.

Typowe scenariusze zastosowań

Regionalne biura nieruchomości z własną stroną. Biuro z 3 do 10 pośrednikami zarządza 200 do 500 aktywnymi obiektami w FlowFact. Strona wyświetla listy z funkcją wyszukiwania (kod pocztowy, liczba pokoi, zakres cenowy, typ obiektu), strony szczegółowe z galerią zdjęć i rzutem, pobieranie ekspoze PDF oraz formularz kontaktowy, który kieruje zapytanie bezpośrednio do właściwego pośrednika w FlowFact. Nowe obiekty pojawiają się na stronie w ciągu 15 minut, zmiany statusu (sprzedany, zarezerwowany) są przejmowane automatycznie.

Deweloperzy i firmy budowlane. Firmy marketingujące projekty nowobudowlane potrzebują oprócz wyszukiwarki obiektów także stron landing z opisem budowy, planem lokalizacji i przeglądem mieszkań jako interaktywną tabelę. FlowFact dostarcza dane obiektów, TYPO3 środowisko redakcyjne dla tekstów projektowych i treści marketingowych. Oba światy są połączone przez API.

Zarządy nieruchomości z portalem dla najemców. Zarządcy wykorzystują FlowFact do administrowania obiektami na wynajem. Strona TYPO3 wyświetla wolne mieszkania, zbiera aplikacje przez formularz i przekazuje je jako kontakt do FlowFact. Szczególność: lista obiektów filtruje automatycznie “do wynajęcia”, a nie “na sprzedaż”.

Architektura techniczna

Połączenie między FlowFact a TYPO3 odbywa się przez dwa możliwe interfejsy. Klasyczny sposób to OpenImmo - oparty na XML standard branżowy wymiany danych nieruchomości. FlowFact eksportuje obiekty jako OpenImmo-XML (ręcznie lub przez scheduler), importer TYPO3 wczytuje pliki i tworzy rekordy. Rozszerzenia takie jak openimmo (od justimmo) lub niestandardowe importery przetwarzają strukturę XML.

Nowocześniejszy sposób to FlowFact REST-API (od FlowFact v3). Serwer TYPO3 pobiera dane obiektów, obrazy i kontakty przez żądania HTTP i synchronizuje je z lokalną bazą danych. Zalety wobec OpenImmo: zdolność do działania w czasie rzeczywistym (polling co 5 minut zamiast codziennego eksportu), granularne aktualizacje (tylko zmienione pola) i dostęp do danych specyficznych dla FlowFact, których nie ma w standardzie OpenImmo (np. wewnętrzne notatki, status leada).

Po stronie TYPO3 obiekty są przechowywane jako rekordy we własnej tabeli (nie jako strony TYPO3). Strony z listami wykorzystują repozytoria Extbase z funkcjami filtrowania. Strony szczegółowe są renderowane przez akcję Show, która ładuje obrazy z FAL (File Abstraction Layer) i wyświetla rzuty jako overlay. Integracja map odbywa się przez Leaflet lub Google Maps, przy czym współrzędne geograficzne są przejmowane z FlowFact.

Częste problemy i rozwiązania

Brak obrazów po imporcie. Eksporty OpenImmo odwołują się do obrazów jako nazwy plików, ale nie zawsze dostarczają same pliki. Rozwiązanie: konfiguracja eksportu tak, aby obrazy były osadzone jako Base64 w XML lub przesyłane równolegle do XML przez FTP. Przy REST-API obrazy są pobierane przez oddzielne endpointy i muszą być importowane jako referencje FAL w TYPO3.

Obiekty znikają po synchronizacji. Gdy FlowFact dezaktywuje lub usuwa obiekt, importer TYPO3 musi zdecydować: usunąć rekord, ukryć czy oznaczyć jako “sprzedany”? Standardowe importery często usuwają radykalnie. Rozwiązanie: implementacja soft-delete, które najpierw oznacza obiekty jako “nieaktywne” i dopiero po 30 dniach fizycznie je usuwa. Dzięki temu URL istotne dla SEO są zachowane i mogą wskazywać przez 301-Redirect na stronę przeglądu.

Zapytania z formularza kontaktowego trafiają w pustkę. Formularz kontaktowy wysyła e-mail, ale lead nie jest tworzony w FlowFact jako kontakt. Rozwiązanie: tworzenie zapytań formularza przez FlowFact-API jako kontakt z odniesieniem do obiektu. Odpowiedzialny pośrednik widzi lead bezpośrednio w swoim dashboardzie. Do tego formularz potrzebuje FlowFact-Objekt-ID jako ukryte pole.

Migracja i kompatybilność wersji

FlowFact wprowadził w 2019 roku zupełnie nową platformę (FlowFact v3). Stara wersja (FlowFact Classic) jest nadal obsługiwana, ale nie otrzymuje nowych funkcji. REST-API jest dostępne tylko w v3. Istniejące integracje OpenImmo działają z obiema wersjami, ale podejście oparte na API jest możliwe tylko z v3.

Po stronie TYPO3 nie ma oficjalnego rozszerzenia FlowFact ze wsparciem v12/v13 w TER. Większość instalacji korzysta z niestandardowych importerów lub rozszerzenia openimmo (z modyfikacjami). Gosign zaleca przy aktualizacjach TYPO3 na v12+ jednoczesne przejście integracji nieruchomości na FlowFact-REST-API, zamiast portowania workflow OpenImmo-XML. Podejście oparte na API jest mniej wymagające w utrzymaniu i umożliwia funkcje takie jak dostępność w czasie rzeczywistym, które nie są realizowalne z eksportem XML.

Typowy projekt integracji FlowFact-TYPO3 (import obiektów, wyszukiwarka, strony szczegółowe, formularz kontaktowy z routingiem leadów) Gosign kalkuluje na 10 do 15 dni deweloperskich. Bieżące utrzymanie ogranicza się do aktualizacji API i sporadycznych dostosowań przy zmianach pól w schemacie FlowFact.