[Intum](https://intum.pl/pomoc.md) / [Konto](https://intum.pl/pomoc/konto.md) # [Import klientów i kontaktów z pliku (CSV / TSV / XLSX)](https://intum.pl/pomoc/import-klientow-i-kontaktow-z-pliku-csv-tsv-xlsx.md) | [API](#api) Przenosisz dane z innego systemu, a może posiadasz gotową bazę w arkuszu kalkulacyjnym? W Sugesterze możesz samodzielnie i w kilka chwil zaimportować całą listę swoich klientów lub kontaktów. Nasz inteligentny importer pozwoli Ci dopasować kolumny, automatycznie rozdzielić numery telefonów oraz zadecydować, jak system ma postąpić w przypadku wykrycia duplikatów. ## Krok 1: Instalacja i uruchomienie dodatku Funkcja importu jest dostępna jako bezpłatny dodatek w naszym systemie. Aby go włączyć: 1. Kliknij ikonę aplikacji (**cztery kropki** w prawym górnym rogu ekranu). 2. W sekcji **Konto** wybierz **Integracje i dodatki**. ![](52e2972ecb4c-Screenshot - 2026-07-14T155432.239.png) 1. Na liście kategorii kliknij zakładkę **Importy**. ![](46f6b162afac-Screenshot - 2026-07-14T155511.740.png) 1. Przy dodatku **Import klientów i kontaktów** kliknij przycisk **Zainstaluj**, a po udanej instalacji wybierz **Uruchom**. ![](eab2185bed06-Screenshot - 2026-07-14T155540.592.png) ## Krok 2: Wybór typu danych i wgranie pliku Po uruchomieniu importera kliknij przycisk **+ Nowy import** (lub *Uruchom pierwszy import*, jeśli robisz to po raz pierwszy). 1. **Co importujesz?** - zaznacz odpowiednią opcję: **Klienci** lub **Kontakty**. 2. **Wgraj plik** - przeciągnij swój plik lub kliknij, aby wybrać go z dysku. - **Obsługiwane formaty:** CSV, TSV, XLSX. - **Limity pliku:** Maksymalny rozmiar to **100 MB**, a limit wierszy w jednym pliku wynosi **5000**. - *Wskazówka:* Możesz pobrać przykładowe, wzorcowe pliki szablonów (dodane w załącznikach do tego artykułu), aby zobaczyć, jak optymalnie ułożyć dane. ![](b9d9970216c0-Screenshot - 2026-07-14T155638.809.png) 1. System automatycznie wykryje separator oraz kodowanie pliku (najczęściej UTF-8). Upewnij się, że opcja **„Pierwszy wiersz jest nagłówkiem”** jest zaznaczona, jeśli Twój plik posiada nazwane kolumny w pierwszym rzędzie. 2. Kliknij niebieski przycisk **Dalej - mapuj kolumny**. ## Krok 3: Mapowanie kolumn i ignorowanie danych Na tym etapie dopasowujesz nagłówki ze swojego pliku do pól systemowych w Sugesterze. - **Dopasowanie:** System spróbuje automatycznie połączyć kolumny. Sprawdź, czy tytuł pola docelowego (na samej górze) zgadza się z danymi wyświetlanymi w podglądzie poniżej. Jeśli nie, kliknij na pole docelowe i wybierz właściwy odpowiednik z listy rozwijanej. - **Pomijanie danych:** Jeśli w Twoim pliku znajduje się kolumna, której nie chcesz importować do bazy (np. liczba porządkowa "Lp." czy wewnętrzne notatki), wybierz dla niej opcję **(pomiń kolumnę)**. Kolumny z żółtym tłem zostaną całkowicie pominięte podczas importu. ![](243b3f667582-Screenshot - 2026-07-14T160012.721.png) ## Krok 4: Polityka duplikatów i domyślne parametry Przed samym uruchomieniem importu, pod tabelą mapowania, możesz skonfigurować kluczowe ustawienia dla całej wgrywanej bazy: ### 1. Polityka duplikatów Zdecyduj, co system ma zrobić, jeśli w bazie znajduje się już taki sam rekord: - **Aktualizuj istniejące rekordy** - nadpisze i uzupełni dane u istniejących już klientów. - **Twórz nowe** - doda rekordy bez względu na to, czy podobne istnieją już w systemie. - **Pomiń istniejące** - zaimportuje tylko zupełnie nowych klientów, ignorując duplikaty. ### 2. Domyślne wartości grupowe Możesz za jednym zamachem nadać całej importowanej właśnie grupie wspólne parametry. Wystarczy wybrać je w polach: - *Domyślny status*, - *Domyślna kategoria*, - *Domyślny dział*, - *Domyślny opiekun*, - *Domyślne tagi* (możesz wybrać z listy lub wpisać nowy tag i zatwierdzić go Enterem). 💡 **Wskazówka:** Nadanie całej importowanej grupie wspólnego **tagu** (np. `import_lipiec_2026`) to świetny i bardzo praktyczny krok. Na podstawie tego tagu możesz później bezpośrednio stworzyć dedykowaną **listę adresową do wysyłki masowego mailingu** - bez konieczności używania i ustawiania jakichkolwiek filtrów! ## Krok 5: Finalizacja importu Gdy wszystko jest ustawione, kliknij zielony przycisk **Importuj klientów** (lub *Importuj kontakty*). System rozpocznie proces, a po jego zakończeniu wyświetli zielony komunikat podsumowujący: **Import zakończony** z dokładną liczbą zaimportowanych rekordów, pominiętych wierszy oraz ewentualnych błędów. Z tego poziomu możesz od razu przejść do listy świeżo zaimportowanych osób, klikając **Zobacz wszystkie zaimportowane rekordy →**. ## Przydatny tip: Wiele telefonów i adresów e-mail u jednego klienta Jeśli Twój klient posiada więcej niż jeden numer telefonu lub adres e-mail, nie musisz tworzyć dla niego osobnych wierszy w pliku. Wystarczy, że w komórce z adresem e-mail lub telefonem wpiszesz wszystkie dane **przedzielone średnikami (`;`) lub przecinkami (`,`)** (np. `przykladowy@intum.pl;kolejny@intum.pl`). Podczas importu nasz system automatycznie rozpozna ten zapis, rozdzieli dane i utworzy z nich osobne, kontakty przypisane do profilu tego klienta. > **Ważne:** Adres e-mail oraz numer telefonu wpisany w komórce jako **pierwszy** z kolei zostanie automatycznie ustawiony w systemie jako **główny/domyślny** kontakt do danego klienta. --- ## API ### Ogólne API # Intum API Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy. ## Host Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta) ## Autoryzacja Wszystkie requesty API wymagają `api_token`: - header: `Authorization: Bearer TOKEN` Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API** --- ## Powiązane - [Klient a Kontakt – czym się różnią i jak działa ta relacja?](https://intum.pl/pomoc/crm/klienci.md)