Importowanie danych: kreator CSV dla leadów, kontaktów i relacji

Tesoro ma wbudowanego kreatora importu. Trzy typy rekordów: leady, kontakty i relacje. Automatyczne mapowanie kolumn, testowy import przed ostatecznym wykonaniem, przetwarzanie wsadowe dla dużych plików. Tylko dla Administratora.

Kiedy to stosować?

500 kontaktów z poprzedniego CRM w formacie CSV
Lista leadów z kampanii marketingowej
Ręcznie zebrany zbiór relacji biznesowych (firm)

Cztery typy importu

Typ	Co	Nawigacja
Lead	Leady kupujących ze śledzeniem	Leads → Import
Lead (Owner)	Sprzedający ze szczegółami nieruchomości	Leads → Import (wybierz Owner)
Contact	Gekwalifikowane kontakty	Contacts → Import
Relacja	Firmy, partnerzy biznesowi	Relations → Import

Wymagania CSV

Właściwość	Wymóg
Typ	`.csv`
Maks. rozmiar	50 MB
Separator	Przecinek lub średnik (automatyczne wykrywanie)
Wiersz nagłówkowy	Pierwszy wiersz = nagłówki kolumn
Kodowanie	Zalecane UTF-8

Przygotowanie CSV: wytyczne

Proszę pobrać plik przykładowy i użyć go jako szablonu.
Proszę zachować wiersz nagłówkowy z prawidłowymi nazwami pól Tesoro.
Proszę używać kodowania UTF-8 dla znaków specjalnych.
Proszę wypełnić pola wymagane: w przeciwnym razie wiersz zostanie pominięty.

Numery telefonów

Format międzynarodowy z kodem kraju: +31612345678
Spacje są automatycznie usuwane
Nawiasy/myślniki mogą powodować błędy

Wiele wartości w jednej komórce

Proszę oddzielić przecinkiem w tej samej komórce:

property_details.type: apartment, villa, townhouse
property_details.location: Marbella, Estepona, Benahavis

Pola zagnieżdżone: notacja kropkowa

Prefiks	Zagnieżdżone pod	Przykład
`address.`	Adres	`address.city`, `address.street`
`lead.`	Śledzenie leadów	`lead.source`, `lead.status`
`property_details.`	Preferencje nieruchomości	`property_details.type`, `property_details.price_min`
`property_address.`	Adres nieruchomości (sprzedający)	`property_address.street`
`timing.`	Czas	`timing.looking_to`, `timing.timeline_max`
`social.`	Media społecznościowe (relacje)	`social.facebook`, `social.linkedIn`

Pola według typu importu

Import leadów

Kolumna	Wymagane
`type` (zawsze `lead`)	Tak
`status`	Tak
`owner_email`	Tak
`salutation`	Nie
`language`	Nie
`first_name`, `last_name`	Tak
`email`, `phone`	Tak
`additional_information`	Nie

Kolumna
`address.city`, `address.country`, `address.state`, `address.street`, `address.zip_code`

Kolumna	Wartości
`lead.source`	Website, Referral, Portals, Cold Calling, …
`lead.status`	New, Contacted, Qualified, Unqualified, Lost, Converted
`lead.stage`	Hot, Neutral, Cold

Kolumna
`property_details.type` (wiele, oddzielone przecinkami)
`property_details.location` (wiele)
`property_details.number_of_bedrooms`, `_bathrooms`
`property_details.price_min`, `_max`
`property_details.size_min`, `_max`, `size`
`property_details.market_price`

Kolumna
`commision` (procent prowizji)
`way_of_selling`
`property_address.street`, `_city`, `_state`, `_zip_code`, `_country`, `_address_line_2`

Kolumna
`timing.looking_to`, `timing.timeline_max`

Import kontaktów

Kolumna	Wymagane
`type` (zawsze `contact`)	Tak
`status`, `owner_email`	Tak
`salutation`, `role`, `language`	Nie
`first_name`, `last_name`, `email`, `phone`	Tak
`additional_information`	Nie
`address.*`	Nie
`do_not_contact`, `portal_user` (true/false)	Nie

Import relacji

Kolumna	Wymagane
`name`, `type`, `email`, `phone_number`, `status`	Tak
`website_url`, `preferred_communication`, `note`, `credit_terms`	Nie
`address.*`	Nie
`social.facebook`, `social.linkedIn`, `social.instagram`	Nie

Kreator importu: cztery kroki

Wybór pliku: proszę przejść do odpowiedniego typu (Leads/Contacts/Relations → Import).

Kreator importu.

Proszę przesłać plik CSV (maks. 50 MB). Na tej stronie również:
- Pobranie pliku przykładowego dla danego typu (leadów: wybór między wariantem leads a owners)
- Open import history dla poprzednich importów
Next →
Mapowanie pól (mapping): Tesoro analizuje i wyświetla dla każdej kolumny:
- Nazwę kolumny z pliku
- Przykładową wartość z wiersza 2
- Rozwijaną listę pól Tesoro
Auto-dopasowanie:
- Dokładna nazwa (np. first_name)
- Dokładna etykieta (np. First Name)
- Częściowe dopasowanie (niezależne od wielkości liter)
- Poprzednie mapowanie dla tych samych nazw kolumn
Wszystkie pola wymagane muszą być przypisane, w przeciwnym razie nie można kontynuować.

Preview → test import.
Walidacja (podgląd): Żadne rekordy nie są tworzone. Dla każdego wiersza:
- Numer wiersza
- Status: udany / nieudany
- Komunikat o błędzie przy nieudanym
Błędy? Proszę wrócić do kroku 1, poprawić CSV, ponownie przesłać.

Zadowolony? Import → ostateczne wykonanie.
Gotowe: dziennik importu z wierszami udanymi/pominiętymi. W przypadku sukcesu: odnośnik do utworzonego rekordu.

Jak działa auto-mapping

Trzy strategie:

Dokładne dopasowanie wartości: first_name pasuje do first_name
Dopasowanie etykiety: First Name (etykieta) pasuje
Częściowe dopasowanie: nie uwzględnia wielkości liter
Poprzednie mapowanie: te same nazwy kolumn co wcześniejszy import → mapowanie przywrócone

Pola wymagane według typu

Typ	Wymagane
Lead	first_name, last_name, email, phone, owner_email
Contact	first_name, last_name, email, phone, owner_email
Relacja	name, type, email, phone_number, status

Określanie właściciela

Kolumna owner_email → użytkownik wyszukiwany dla każdego wiersza
Wartość zastępcza → pierwszy użytkownik z Pana/Pani firmy

Duplikaty: brak automatycznego wykrywania

Tesoro nie wykrywa duplikatów podczas importu CSV. Wszystkie wiersze są tworzone, nawet przy istniejących adresach email. Aby uniknąć duplikatów:

Proszę sprawdzić CSV przed importem
Proszę usunąć duplikaty w źródle
Proszę wykonać import testowy, aby zobaczyć liczby
Proszę ręcznie scalić po imporcie

Częste błędy

Błąd	Przyczyna	Rozwiązanie
Puste pole wymagane	first_name, last_name, email puste	Uzupełnić w CSV
Nieprawidłowy email	Brak @ lub literówka	Sprawdzić
Nieprawidłowy owner_email	Użytkownik nie istnieje	Użyć istniejącego użytkownika
Nieprawidłowy typ/status	Nie w dozwolonych opcjach	Porównać z plikiem przykładowym
Nieprawidłowy numer telefonu	Brak formatu międzynarodowego	Użyć `+31612345678`
Lokalizacja jako string	Wiele wartości nieprawidłowo oddzielonych	Przecinek w komórce
Nazwa z cyframi	first_name/last_name zawiera cyfry	Usunąć

Dziennik importu (testowy + ostateczny)

Dla każdego wiersza:

Numer wiersza (od 2, ponieważ 1 = wiersz nagłówkowy)
Status (błąd: 0 lub 1)
Komunikat o błędzie przy nieudanym
Utworzony rekord przy sukcesie (resource + ID)

Przetwarzanie wsadowe

Importy są przetwarzane w partiach po 100:

Duże pliki automatycznie dzielone
Każda partia przez zadanie w tle
Postęp na żywo w interfejsie (“150/500 processed”)
Odpytywanie co 5 sekund

Historia importu

Open import history na stronie importu. Tabela:

Kolumna	Co
Nazwa pliku	Nazwa CSV
Łączna liczba wierszy	W pliku
Przetworzone wiersze	Liczba przetworzonych
Data	Kiedy

Paginiowany (domyślnie 10, opcje 10/20/30/40/50), sortowane od najnowszych.

Importowanie nieruchomości: inna ścieżka

Nie przez kreator CSV, ale przez XML-feed:

Kyero XML-feeds do synchronizacji feedów nieruchomości
Ręczne przesyłanie XML do jednorazowego importu

Proszę skonfigurować przez Settings → XML Import. Można również ustawić, co zrobić z nieruchomościami, które nie są już w feedzie (np. status ‘Removed by Feed’).

Osiem wskazówek udanego importu

Rozpocząć od importu testowego: kreator robi to automatycznie w kroku podglądu
Plik przykładowy jako szablon: zapobiega problemom z mapowaniem
Międzynarodowe numery telefonów z kodem kraju
Prawidłowe adresy email: w przeciwnym razie pominięte
owner_email pasuje do istniejącego użytkownika: w przeciwnym razie wartość zastępcza
Podzielić duże pliki: łatwiej sprawdzić w dzienniku
UTF-8 dla znaków specjalnych
Wiele wartości oddzielone przecinkami: nie średnikami w komórkach

Następne kroki

Przegląd migracji Pełna migracja do Tesoro, przeprowadzona przez zespół Tesoro.

Zarządzanie kontaktami Praca z zaimportowanymi kontaktami.

Zarządzanie leadami Zarządzanie zaimportowanymi leadami w swoim pipeline.