Jak zaimportować klientów do VoxCRM

System voxDeveloper CRM umożliwia masowy import klientów z pliku Excel (.xlsx). Funkcja ta pozwala na szybkie przeniesienie bazy kontaktów do systemu bez konieczności ręcznego dodawania każdego klienta. Poniżej przedstawiamy instrukcję przygotowania pliku i przeprowadzenia importu.

Kiedy skorzystać z importu klientów?

Import klientów jest przydatny w następujących sytuacjach:

  • Migracja danych — przenoszenie bazy klientów z innego systemu CRM lub arkusza kalkulacyjnego do voxDeveloper CRM,
  • Nowa inwestycja — dodanie listy klientów zainteresowanych nową inwestycją,
  • Aktualizacja bazy — uzupełnienie systemu o dane klientów zebranych podczas eventów, targów lub kampanii marketingowych.
⚠ Ważne: Przed importem należy pobrać plik wzorcowy udostępniony na końcu tego artykułu. Dane klientów muszą być uzupełnione zgodnie ze strukturą tego pliku — system nie zaimportuje pliku o innym układzie kolumn.

Słowniczek pojęć

Pojęcie Wyjaśnienie
Plik wzorcowy Plik Excel (.xlsx) z predefiniowaną strukturą kolumn, który należy uzupełnić danymi klientów przed importem do systemu.
Źródło pochodzenia Informacja o tym, skąd pochodzi kontakt z klientem (np. strona WWW, targi, polecenie, portal ogłoszeniowy). Wartość musi odpowiadać źródłom zdefiniowanym w systemie.
Doradca Użytkownik systemu voxCRM (pracownik), do którego zostanie przypisany importowany klient. Podawany, jako e-mail doradcy.
Klasyfikacja Kategoria klienta w systemie (np. A, B, C) określająca priorytet obsługi lub stopień zainteresowania ofertą. Więcej o klasyfikacjach
Tryb importu Ustawienie określające, które wiersze z pliku mają zostać zaimportowane. Opcja "Wszystkie wiersze" pozwala najpierw zweryfikować dane przed właściwym importem.
Adres korespondencyjny Drugi adres klienta, na który kierowana jest korespondencja (jeśli różni się od adresu zamieszkania). Oznaczony w pliku przyrostkiem "– koresp."

Wymagane pola (minimum)

Aby import przebiegł poprawnie, w pliku wzorcowym należy uzupełnić co najmniej poniższe kolumny:

Pole Opis Przykład
Data utworzenia Data dodania klienta do bazy. Musi być wprowadzona jako tekst (String), np. w formacie RRRR-MM-DD. Jeśli komórka zostanie sformatowana jako data (typ Date), system nie rozpozna wartości. 2026-04-07
Mail Adres e-mail klienta. Musi być unikalny w systemie. jan.kowalski@email.pl
Telefon Numer telefonu klienta. 600 100 200
Źródło pochodzenia Skąd pochodzi kontakt. Wartość musi być zgodna ze źródłami dostępnymi w systemie. Listę źródeł można sprawdzić poprzez filtr na liście klientów lub w polu przy ręcznym dodawaniu klienta. Strona WWW
Doradca Email pracownika, do którego zostanie przypisany klient. annanowak@voxoft.com
⚠ Ważne: Wartości w polach Źródło pochodzenia oraz Doradca muszą dokładnie odpowiadać danym skonfigurowanym w systemie voxCRM. Literówka lub różnica w wielkości liter spowoduje błąd importu.

Pełna lista pól w pliku importu

Plik wzorcowy zawiera 38 kolumn. Pola oznaczone jako wymagane muszą być uzupełnione. Pozostałe pola są opcjonalne i mogą pozostać puste.

Lp. Nazwa kolumny Kategoria
1 Imię Dane osobowe
2 Nazwisko Dane osobowe
3 Telefon * Kontakt
4 Mail * Kontakt
5 Data utworzenia * System
6 Źródło pochodzenia * System
7 Typ dokumentu Dokumenty
8 Nr dokumentu Dokumenty
9 Data wygaśnięcia Dokumenty
10 Inwestycja System
11 Doradca * System
12 Klasyfikacja System
13 Pesel Dane osobowe
14–19 Woj, Miasto, Kod pocztowy, Ulica, Budynek, Mieszkanie Adres zamieszkania
20–25 Woj, Miasto, Kod pocztowy, Ulica, Budynek, Mieszkanie (– koresp.) Adres korespondencyjny
26–27 Zgoda marketingowa, Treść zgody marketingowej Zgody RODO
28–29 Zgoda na przesyłanie wiadomości, Treść zgody na przesyłanie wiadomości Zgody RODO
30–31 Zgoda na telefon, Treść zgody na telefon Zgody RODO
32–33 Zgoda o przetwarzaniu danych, Treść zgody o przetwarzaniu danych Zgody RODO
34 Status System
35 Nip Dane osobowe
36 Imię ojca Dane osobowe
37 Imię matki Dane osobowe
38 Opis Dodatkowe

* Pola oznaczone gwiazdką są wymagane do prawidłowego importu.

Instrukcja importu — krok po kroku

Krok 1. Pobranie pliku wzorcowego

Pobrać plik wzorcowy Import klientów.xlsx (dostępny na końcu tego artykułu) i otworzyć go w programie Excel lub LibreOffice Calc.

Krok 2. Uzupełnienie danych klientów

Uzupełnić plik danymi klientów. Każdy wiersz odpowiada jednemu klientowi. Należy wypełnić co najmniej pola wymagane: Data utworzenia, Mail, Telefon, Źródło pochodzenia, Doradca.

💡 Wskazówka: Kolumna Data utworzenia musi zawierać wartość tekstową (String), a nie datę w formacie Excel. Aby to zapewnić, przed wpisaniem daty należy wstawić apostrof na początku komórki (np. '2026-04-07) lub sformatować kolumnę jako Tekst. W przeciwnym razie system nie rozpozna wartości.

Krok 3. Zapisanie pliku

Zapisać uzupełniony plik w formacie .xlsx. Nie zmieniać nazw kolumn ani ich kolejności.

Krok 4. Przejście do modułu importu

W panelu voxDeveloper CRM przejść do: Klienci → kliknąć zielony przycisk Import (po prawej stronie ekranu - jednak zależny od upranień w systemie).

Krok 5. Wgranie pliku

Wybrać przygotowany plik wzorcowy z uzupełnionymi danymi klientów.

Krok 6. Weryfikacja danych (sprawdzenie)

Przed właściwym importem zawsze najpierw sprawdzić dane. W polu Tryb wybrać opcję Wszystkie wiersze. System wyświetli podgląd danych i ewentualne błędy.

Krok 7. Import danych

Jeżeli system nie wykazuje błędów w rezultacie, kliknąć przycisk Zaimportuj.

Krok 8. Weryfikacja po imporcie

Po zakończeniu importu sprawdzić poprawność danych — zweryfikować co najmniej pierwszy, ostatni oraz środkowy rekord na liście klientów.

⚠ Ważne: Zawsze korzystać z trybu sprawdzenia przed właściwym importem. Pozwala to wykryć błędy w danych (np. nieprawidłowe źródło pochodzenia, brak wymaganych pól) bez ryzyka zaimportowania niepoprawnych rekordów.

Najczęstsze problemy

Problem Możliwa przyczyna Rozwiązanie
Błąd w polu "Źródło pochodzenia" Wpisana wartość nie istnieje w konfiguracji systemu Sprawdzić dostępne wartości poprzez filtr na liście klientów lub w polu "Źródło pochodzenia" przy ręcznym dodawaniu klienta, a następnie użyć dokładnej nazwy
Błąd w polu "Doradca" Email nie zgadza się z użytkownikiem w systemie Zweryfikować pisownię — musi być identyczna jak w profilu użytkownika voxCRM
Duplikaty klientów po imporcie Klient z danym adresem e-mail już istnieje w systemie Przed importem sprawdzić, czy klienci nie są już w bazie. System może utworzyć duplikaty
System nie akceptuje pliku Zmieniono strukturę pliku (nazwy kolumn, kolejność, format) Użyć oryginalnego pliku wzorcowego bez modyfikacji nagłówków kolumn
Brak danych po imporcie Puste wymagane pola w wierszu Upewnić się, że każdy wiersz ma uzupełnione pola: Data utworzenia, Mail, Telefon, Źródło pochodzenia, Doradca
Nieprawidłowy format daty Data w formacie innym niż oczekiwany Używać formatu RRRR-MM-DD (np. 2026-04-07)

Plik do pobrania

Poniżej znajduje się plik wzorcowy do importu klientów. Należy go pobrać, uzupełnić danymi i wgrać do systemu zgodnie z powyższą instrukcją.

W razie pytań zapraszamy do kontaktu z naszym zespołem wsparcia: kontakt@voxcommerce.pl

pliki dołączone::