INTEGRACJE I API

Integracje Lokarty z CRM i systemami zewnętrznymi przez API i webhooki

Lokarta nie musi być ostatnim systemem w Twoim środowisku technologicznym.

Jeżeli firma korzysta już z CRM-u, portalu, systemu raportowego lub własnego zaplecza, nie zakładamy automatycznie, że wszystko trzeba zastąpić. Najpierw ustalamy, które dane powinny pozostać źródłowe i gdzie naprawdę potrzebna jest integracja.

Najpierw źródło danych.Dopiero potem kierunek przepływu, zdarzenia, sposób dostarczenia i monitoring.

ARCHITEKTURA INTEGRACJILokarta w istniejącym środowisku
SCHEMAT
ZEWNĘTRZNY CRMLeady / proces
PORTAL / STRONAOferta
SYSTEM RAPORTOWYDane / status
WŁASNE ZAPLECZEŹródło / odbiorca
L
LOKARTAwarstwa sprzedaży inwestycji

NAJPIERW PRZEPŁYW DANYCH, POTEM API

Integracja ma rozwiązać problem biznesowy, a nie istnieć tylko dlatego, że dwa systemy można ze sobą połączyć

Zanim zaczniemy prace techniczne, określamy: które dane są źródłowe, w którą stronę mają płynąć, jak często, co jest krytyczne i co ma się wydarzyć po błędzie.

01
ŹRÓDŁO DANYCHCo jest prawdą źródłową?
02
ZDARZENIECo uruchamia przepływ?
03
PRZEKAZANIEAPI czy webhook?
04
SYSTEM DOCELOWYGdzie dane mają trafić?
05
STATUS / PONOWIENIEJak sprawdzamy rezultat?
PRZYKŁADOWA INTEGRACJALead z Lokarty → zewnętrzny CRMschemat
ŹRÓDŁOFormularz Lokarty
ZDARZENIENowy lead
DANEKontakt + lokal + źródło
CELZewnętrzny CRM
W RAZIE BŁĘDUStatus + ponowienie

KIEDY ZEWNĘTRZNY CRM MA ZOSTAĆ

Nie każdy zespół powinien przenosić proces do CRM-u Lokarty.

Jeżeli obecny CRM obsługuje również inne działy, ma ważne automatyzacje lub jest standardem całej organizacji, lepszym rozwiązaniem może być przekazywanie leadów i danych do istniejącego środowiska zamiast zmiany systemu tylko dla jednej inwestycji.

01

CRM jest standardem firmySprzedaż inwestycji ma wejść w istniejący proces.

02

Obsługuje inne działyZmiana systemu dla jednej inwestycji tworzyłaby chaos.

03

Ma ważne automatyzacjeIntegracja może zachować proces, który już działa.

PRZEPŁYW LEADALokarta + istniejący CRM
bez wymiany systemu
LOKARTALead A12

kontakt · inwestycja · lokal · źródło

INTEGRACJAKontrolowany przepływ

uzgodnione pola i zdarzenia

ZEWNĘTRZNY CRMProces firmowy

dalsza obsługa zgodnie z procesem firmy

Cel: spójny przepływ informacji, nie wymuszanie konkretnego CRM-u.

API I WEBHOOKI

API i webhooki obsługują różne scenariusze integracji

API służy do kontrolowanego odczytu lub zapisu danych w uzgodnionym zakresie. Webhooki pozwalają reagować na zdarzenia bez ciągłego odpytywania systemu. Konkretne endpointy, zakresy i zdarzenia należą do dokumentacji aktualnej wersji.

API / SCHEMAT ODCZYTU
GET /api/v1/units/A12
Authorization: Bearer ••••••••

→ uzgodniony zakres danych
→ kontrolowany dostęp
→ odpowiedź ze statusem
API

API umożliwia integrację na żądanie

System zewnętrzny pobiera lub przekazuje uzgodnione dane wtedy, gdy proces tego wymaga.

odczyt lub zapis w kontrolowanym zakresiekonkretne endpointy zależą od wersjiuprawnienia ograniczone do wdrożenia
LOG INTEGRACJIStatus przekazania danych
UI DEMONSTRACYJNE
ZDARZENIElead.created
CELzewnętrzny CRM
STATUSWymaga ponowienia

08:42:11Zdarzenie zapisane

OK

08:42:12Przygotowano pakiet danych

OK

08:42:13System docelowy nie potwierdził odbioru

BŁĄD
Struktura UI pokazuje ideę statusu, historii i ponowienia — nie jest screenem produkcyjnym.

PRZEKAZANIE DANYCH MUSI BYĆ MOŻLIWE DO SPRAWDZENIA

Integracja bez logu jest problemem, który czeka na pierwszy błąd.

Przy krytycznych połączeniach ważne są statusy wykonania, historia dostarczeń i mechanizmy ponowienia. Zakres monitoringu zależy od konkretnej integracji i powinien być częścią projektu, a nie dodatkiem po awarii.

STATUSCzy operacja została wykonana?

HISTORIACo wydarzyło się po kolei?

PONOWIENIECo robimy po błędzie?

NIE GWARANTUJEMY INTEGRACJI Z KAŻDYM SYSTEMEM

Najpierw sprawdzamy możliwości techniczne drugiej strony.

Zakres zależy od dostępnego API, dokumentacji, limitów, uprawnień i jakości systemu zewnętrznego. Jeżeli integracja wymaga rozwiązania indywidualnego, otrzymuje osobny zakres i wycenę.

01
API / DOSTĘPCzy druga strona udostępnia potrzebne operacje?
02
DOKUMENTACJACzy zakres i format danych są jednoznaczne?
03
LIMITYJakie ograniczenia dotyczą wywołań i danych?
04
UPRAWNIENIAJak ograniczyć dostęp do potrzebnego zakresu?
05
BŁĘDYJak system sygnalizuje i obsługuje niepowodzenia?
06
UTRZYMANIEKto odpowiada za zmiany po obu stronach?

RDZEŃ PRODUKTU A ROZWIĄZANIA INDYWIDUALNE

Standardowy produkt pozostaje wspólny. Nietypowe połączenia nie trafiają automatycznie do rdzenia.

To chroni stabilność Lokarty i sprawia, że indywidualne wymagania jednego klienta nie zmieniają produktu dla wszystkich pozostałych użytkowników.

01
RDZEŃ

Powtarzalne funkcje rozwijane jako część produktu

Wspólny rdzeń, który może być utrzymywany i aktualizowany dla kolejnych wdrożeń.

02
KONFIGURACJA

Zakres dopasowany do inwestycji bez zmiany kodu

Ustawienia, mapowanie i sposób wykorzystania istniejących mechanizmów.

03
ROZWIĄZANIE INDYWIDUALNE

Indywidualna integracja albo proces poza standardowym zakresem

Osobny zakres techniczny, testy, odpowiedzialność i wycena.

FAQ

Najczęściej zadawane pytania o integracje Lokarty i API

Nie publikujemy listy kompatybilnych systemów „z góry”. Zakres każdej integracji zależy od możliwości technicznych drugiej strony i realnego przepływu danych.

Czy Lokarta może połączyć się z naszym CRM-em?

Może, jeśli system zewnętrzny udostępnia odpowiednie możliwości integracyjne i przepływ danych ma uzasadnienie. Zakres potwierdzamy po analizie.

Czy Lokarta ma API?

Tak, aktualny produkt przewiduje programistyczny dostęp do wybranych danych i operacji w kontrolowanym zakresie. Szczegóły należą do dokumentacji technicznej wersji.

Do czego służą webhooki?

Pozwalają przekazywać informację o wybranych zdarzeniach do systemów zewnętrznych bez ciągłego odpytywania API.

Czy integracje są w standardowej cenie?

Niestandardowe integracje są osobno wycenianym zakresem, ponieważ zależą od drugiego systemu i wymaganej logiki.

Czy można zastąpić CRM Lokarty zewnętrznym systemem?

W zależności od procesu — tak. Celem jest spójny przepływ informacji, a nie wymuszanie konkretnego CRM-u, jeżeli istniejący system ma zostać w firmie.

POŁĄCZ TYLKO TO, CO TRZEBA

Dobra integracja usuwa ręczny krok. Zła tworzy kolejne miejsce do utrzymania.

Pokaż nam obecne środowisko i przepływ danych. Najpierw ustalimy, czy integracja ma sens, a dopiero potem sposób techniczny.

LLOKARTA
CRMPORTALBACKEND
Jeden uzasadniony przepływ
zamiast integracji „dla samej integracji”.