Integracja YouLead z voxCRM - co przygotować po stronie YouLead

YouLead łączy się z voxCRM dwukierunkowo: leady z Państwa formularzy trafiają do voxCRM, zdarzenia sprzedażowe z voxCRM wracają do YouLead i aktualizują lejek, a lista lokali jest pobierana z voxCRM do YouLead. Poniższa instrukcja zawiera dokładną listę danych, zdarzeń i nazw pól, które przygotowują Państwo po stronie YouLead i przekazują nam.

💡 Niczego nie trzeba wymyślać: wszystkie potrzebne zdarzenia i nazwy pól są wypisane poniżej wprost — wystarczy ustawić je po stronie YouLead i przekazać nam wskazane informacje. Dla porządku: my przekazujemy Państwu adres odbioru leadów oraz adresy i klucz do pobierania listy lokali (opisane w dalszej części instrukcji).

Spis treści

  1. Dane dostępowe
  2. Lejek i statusy dla każdej inwestycji
  3. Zdarzenia wysyłane do YouLead
  4. Nazwy pól z formularzy
  5. Odbiór leadów z formularzy
  6. Lista lokali (feed)
  7. Ściągawka — co od Państwa potrzebujemy

1. Dane dostępowe

W panelu YouLead, w konfiguracji aplikacji integracyjnej, znajdują się trzy wartości. Prosimy o ich odczytanie i przekazanie nam — wpiszemy je po stronie voxCRM:

  • Client ID
  • App ID
  • Secret key

2. Lejek i statusy dla każdej inwestycji

Dla każdej inwestycji trzeba utworzyć w YouLead osobny lejek oraz osobny tag. Jest to warunek konieczny - bez lejka i tagu zdarzenia dla danej inwestycji nie mają gdzie trafić.

Zasady:

  • Nazwa lejka = nazwa inwestycji w voxCRM (dokładnie taka sama).

  • Statusy w lejku muszą odpowiadać etapom sprzedaży i mieć dokładnie takie nazwy jak poniżej (znak w znak).

Pełny zestaw statusów, które integracja może ustawiać w lejku:

  • Nowy

  • Zainteresowany

  • Rezerwacja ustna

  • Umowa rezerwacyjna

  • Umowa deweloperska/przedwstępna

  • Umowa końcowa (Akt notarialny)

  • Zaplanowano odbiór

  • Odebrano

Przy dodaniu nowej inwestycji w przyszłości pamiętajmy, aby dołożyć dla niej nowy lejek i tag.

3. Zdarzenia wysyłane do YouLead

Poniżej znajduje się pełna lista zdarzeń, które voxCRM potrafi wysyłać do YouLead. Wspólnie ustalamy, które z nich włączyć — my zaznaczamy je po stronie voxCRM. Aby każde zdarzenie zadziałało, po stronie YouLead musi istnieć odpowiadający mu lejek i statusy (patrz punkt 2).

Prosimy o wskazanie, które zdarzenia mają być wysyłane:

Zdarzenie Kiedy się uruchamia Co przekazuje do YouLead
Utworzenie/edycja klienta dodanie klienta lub zmiana kluczowego pola dane klienta, zgody i wybrane tagi
Utworzenie/edycja leada nowy lead (automatyczny lub ręczny) dane leada do lejka inwestycji
Konwersja leada nowy lead powstaje w YouLead odbiór leada z YouLead do voxCRM
Powiązanie z lokalem / rezerwacja / umowa powiązanie lokalu, rezerwacja ustna lub umowa aktualizacja statusu w lejku inwestycji
Utworzenie/edycja odbioru lokalu zaplanowanie odbioru lub status „Odebrano" aktualizacja statusu w lejku
Rejestracja aktywności z klientem zakończona aktywność (spotkanie, e-mail, telefon) notatka z aktywności
Połączenie telefoniczne z klientem połączenie z aplikacji mobilnej trwające ponad 10 sekund informacja o telefonie
Wysłanie oferty do klienta wysłanie oferty informacja o wysłaniu oferty
Zakończenie obsługi klienta zamknięcie klienta z inwestycjami w preferencjach status „Nie kupił" w lejkach
Anonimizacja klienta anonimizacja klienta żądanie anonimizacji danych
⚠️ Zdarzenie „Konwersja leada" to odbieranie leadów z YouLead — jego włączenie jest konieczne, aby leady z formularzy w ogóle trafiały do voxCRM.

Po zaznaczeniu zdarzenia „Utworzenie/edycja klienta" pojawia się dodatkowe pole „Przesyłane tagi", w którym zaznaczamy, jakie dodatkowe dane mają wracać do YouLead. Pełna lista dostępnych tagów (łącznie 11):

  • Etapy z preferencji
  • Inwestycje z preferencji
  • Klasyfikacja
  • Preferowana liczba pokoi do
  • Preferowana liczba pokoi od
  • Preferowana powierzchnia do
  • Preferowana powierzchnia od
  • Preferowane piętro do
  • Preferowane piętro od
  • Źródło finansowania
  • Źródło pochodzenia

4. Nazwy pól z formularzy

To najważniejsza część. voxCRM musi wiedzieć, które pole z Państwa formularza YouLead jest e-mailem, które telefonem, które zgodą itd. Dlatego przy każdym polu voxCRM prosimy o podanie nazwy odpowiadającego mu pola w Państwa formularzu YouLead.

💡 Ułatwienie: w ostatniej kolumnie podajemy domyślne nazwy, które voxCRM rozpoznaje automatycznie. Jeśli pola w formularzu zostaną nazwane dokładnie tak jak w tej kolumnie, nie trzeba nic dodatkowo ustawiać. Jeśli nazwy są inne — wystarczy je nam podać, a my dopiszemy je do mapowania.

Dane kontaktowe

Pole w voxCRM Co zawiera Domyślna nazwa w YouLead
Email (wymagane) adres e-mail, główny klucz dopasowania klienta email
Imię imię klienta imie, full_name, name
Nazwisko nazwisko klienta nazwisko, full_name
Telefon numer telefonu telefon, phone, phone_number

Zgody

Pole w voxCRM Co zawiera Domyślna nazwa w YouLead
Zgoda na przesyłanie wiadomości zgoda na kontakt e-mail / wiadomości np. zgoda_komunikacja (prosimy o potwierdzenie nazwy)
Treść zgody na przesyłanie wiadomości treść tej zgody prosimy o podanie
Zgoda na telefon zgoda na kontakt telefoniczny prosimy o podanie nazwy pola
Treść zgody na telefon treść tej zgody prosimy o podanie
Zgoda marketingowa zgoda marketingowa zgoda_marketingowa
Treść zgody marketingowej treść zgody marketingowej zgoda_marketingowa_tresc
Info o przetwarzaniu danych oświadczenie o przetwarzaniu danych zgoda_oswiadczenie
Treść informacji o przetwarzaniu danych treść oświadczenia zgoda_oswiadczenie_tresc

Klasyfikacja i przypisanie

Pole w voxCRM Co zawiera Domyślna nazwa w YouLead
Źródło pochodzenia skąd pochodzi lead (źródło / kampania) lead_source
E-mail doradcy e-mail doradcy, do którego ma trafić lead owner_email
Nazwa inwestycji inwestycja, której dotyczy lead investment, inwestycja
Typ lokalu typ nieruchomości (np. mieszkanie / dom) local_type
Sposób kontaktu sposób kontaktu (np. formularz) contact_method

Kampanie (UTM)

Pole w voxCRM Co zawiera Domyślna nazwa w YouLead
Utm source źródło kampanii utm_source
Utm medium medium kampanii utm_medium
Utm content treść kampanii utm_content
Utm term słowo kluczowe kampanii utm_term
Utm campaign nazwa kampanii utm_campaign

Pola techniczne (zwykle bez działania po Państwa stronie)

Pole w voxCRM Co zawiera Domyślna nazwa w YouLead
Data utworzenia data powstania leada occuredAt
Identyfikator YouLead identyfikator kontaktu nadawany przez YouLead ylid

⚠️ Minimum, które musi się zgadzać, to Email (klucz dopasowania), a poza tym imię, nazwisko i telefon. Pozostałe pola uzupełniamy w miarę potrzeb.

5. Odbiór leadów z formularzy

Aby leady z Państwa formularzy trafiały do voxCRM, w YouLead należy wskazać adres, pod który mają być wysyłane. Adres ten przekazujemy Państwu podczas wdrożenia. Po stronie YouLead pozostają dwa proste kroki:

  1. Wklejenie otrzymanego adresu w odpowiednim miejscu w YouLead.
  2. Włączenie wysyłania leadów.

Po naszej stronie odpowiada za to włączone zdarzenie „Konwersja leada" (punkt 3).

6. Lista lokali (feed)

Listę lokali YouLead pobiera samodzielnie z voxCRM, według ustalonego harmonogramu. Przekazujemy Państwu dwa adresy (listę inwestycji oraz lokale w inwestycji) wraz z kluczem dostępu; po stronie YouLead ustawia się, jak często dane mają być pobierane.

⚠️ Drobna uwaga techniczna: w linkach do plików (PDF, zdjęcia) kropki są zamieniane na podkreślenia, dlatego po stronie YouLead należy je z powrotem zamienić na kropki, aby linki działały poprawnie.

7. Ściągawka — co od Państwa potrzebujemy

Przekazują nam Państwo:

  • Client ID, App ID, Secret key (punkt 1).
  • Listę zdarzeń, które mają być wysyłane do YouLead (punkt 3).
  • Nazwy pól z formularzy YouLead odpowiadające polom voxCRM — tam, gdzie różnią się od domyślnych (punkt 4).

Ustawiają Państwo u siebie w YouLead:

  • Osobny lejek dla każdej inwestycji (nazwa lejka = nazwa inwestycji) ze statusami z punktu 2, w tym „Nie kupił".
  • Osobny tag dla każdej inwestycji.
  • Podłączenie adresu odbioru leadów, który od nas otrzymają Państwo, i włączenie wysyłania leadów (punkt 5).
  • Harmonogram pobierania listy lokali z adresów, które od nas otrzymają Państwo (punkt 6).
✅ Po przekazaniu nam kompletu powyższych informacji resztę konfiguracji wykonujemy po stronie voxCRM — wpisujemy otrzymane dane dostępowe i zaznaczamy ustalone wspólnie zdarzenia.

Kontakt

W razie pytań lub problemów prosimy o kontakt z działem wsparcia technicznego:

Oceń ten wpis:

Podobne wpisy