# Importowanie kontaktów z pliku Jeśli masz listę kontaktów w arkuszu kalkulacyjnym, możesz przesłać je wszystkie naraz, zamiast dodawać je pojedynczo. Aplikacja korzysta z 3-etapowego kreatora — **Prześlij → Mapuj kolumny → Przejrzyj** — który współpracuje z posiadanym już plikiem CSV, bez konieczności wcześniejszego pobierania szablonu. --- ## Jak zaimportować kontakty 1. Kliknij **Kontakty** na lewym pasku bocznym, a następnie kliknij **Importuj** u góry strony. 2. **Prześlij.** Przeciągnij plik CSV do strefy zrzutu lub kliknij go, aby przeglądać pliki. Nie ma szablonu do pobrania — użyj pliku, który już masz. 3. **Mapowanie kolumn.** Kreator odczytuje wiersz nagłówka pliku i próbuje automatycznie dopasować każdą kolumnę do pola docelowego: **Imię, Nazwisko, Telefon, E-mail, Tagi, Notatki** lub **Nie importuj**. Sprawdź sugestię dla każdej kolumny i popraw błędne dopasowania za pomocą selektora obok. Tabela podglądu pokazuje kilka pierwszych wierszy dokładnie tak, jak zostaną zaimportowane. * **Kolumna z numerem telefonu jest wymagana** — nie możesz kontynuować bez jej zmapowania. * Kolumna zmapowana na **Tagi** staje się rzeczywistymi tagami przypisanymi do każdego kontaktu. Wiele tagów w jednej komórce jest dozwolonych — oddziel je przecinkiem lub średnikiem (`vip; newsletter; hotmart`). Tagi, które jeszcze nie istnieją, zostaną utworzone; istniejące tagi zostaną użyte ponownie, bez uwzględniania wielkości liter. 4. **Przegląd.** Wybierz: * **Domyślny kanał** — WhatsApp Business, WhatsApp Web lub SMS. Dotyczy to każdego zaimportowanego kontaktu, który nie ma jeszcze określonego kanału. * **Lista** — wybierz istniejącą listę z menu rozwijanego lub wpisz nazwę, aby utworzyć nową. Możesz wybrać tylko jedną z tych opcji, nie obie naraz. * **Aktualizuj istniejące kontakty** — domyślnie wyłączone. Gdy jest wyłączone, wiersze pasujące do kontaktu, który już posiadasz (ten sam numer telefonu), są pomijane jako duplikaty: nic w tym kontakcie się nie zmienia i **nie** jest on dodawany do listy. Gdy jest włączone, te wiersze **aktualizują** kontakt: imię, e-mail i notatki w pliku nadpisują istniejące dane (puste komórki pozostawiają bieżącą wartość bez zmian), wszelkie tagi w wierszu są dodawane, a kontakt jest dodawany do wybranej listy. W ten sposób możesz ponownie zaimportować plik, aby poprawić lub wzbogacić posiadane już kontakty. 5. Kliknij **Importuj [count]**. Zostaniesz przeniesiony na ekran wyników, który pokazuje, ile kontaktów utworzono, ile istniejących kontaktów zaktualizowano (jeśli ta opcja była włączona) oraz, w przypadku pominięcia jakichkolwiek wierszy, szczegółowe wyjaśnienie dlaczego (nieprawidłowy numer telefonu, brak numeru telefonu, duplikat, osiągnięto limit kontaktów itp.). --- ## Szczegóły mapowania kolumn * **Telefon** to jedyna wymagana kolumna. Wiersze bez numeru telefonu są odrzucane przed importem i liczone oddzielnie na ekranie wyników. * **Imię / Nazwisko / E-mail** mapują się bezpośrednio na podstawowe pola kontaktu. * **Notatki** mapują się na pole [Notatki / Profil leada](custom-contact-fields.md#notes-lead-profile) kontaktu. * **Tagi** tworzą (lub wykorzystują ponownie) rzeczywiste tagi i przypisują je do kontaktu — te same, według których filtrujesz, do których kierujesz transmisje i z których wyzwalasz webhooki. Umieść kilka w jednej komórce, oddzielając je przecinkami lub średnikami. Przed 19 sierpnia 2026 r. ta kolumna była zapisywana jako pole niestandardowe o nazwie `tags`; jeśli importowałeś dane przed tą datą, zaimportuj ponownie ten sam plik z włączoną opcją **Aktualizuj istniejące kontakty**, a tagi zostaną poprawnie przypisane (pozostałe pole niestandardowe `tags` nie szkodzi; skontaktuj się z pomocą techniczną, jeśli chcesz, aby zostało usunięte z każdego kontaktu). * Obecnie nie ma mapowania kolumn dla dowolnych pól niestandardowych (takich jak kolumny `custom_` z wersji klasycznej) — zobacz [Masowe ładowanie pól niestandardowych](custom-contact-fields.md#bulk-loading-custom-fields), aby poznać bieżące obejście. --- ## Wskazówki - Sprawdź dokładnie, czy numery telefonów zawierają kod kraju. Bez niego wiadomości nie zostaną dostarczone — a wiersze bez użytecznego numeru telefonu są całkowicie pomijane. - Nie musisz usuwać spacji, myślników ani nawiasów z numerów telefonów — importer toleruje typowe formatowanie, ale nadal wymaga kodu kraju. - Pliki są przetwarzane w całości w Twojej przeglądarce, więc nie ma stałego limitu rozmiaru przesyłania w samym kreatorze — ale całkowita liczba kontaktów jest nadal ograniczona przez Twój plan. Jeśli import przekroczyłby limit Twojego planu, te wiersze zostaną odrzucone i pojawią się na ekranie wyników jako `contact_limit_reached`. - Jeśli kontakt o tym samym numerze telefonu już istnieje, wiersz ten jest domyślnie pomijany — pojawia się jako `duplicate` na ekranie wyników. Import nigdy nie tworzy drugiej kopii tej samej osoby. Aby masowo edytować posiadane już kontakty (poprawić imiona lub e-maile, dodać tagi, umieścić je na liście), włącz opcję **Aktualizuj istniejące kontakty** w kroku Przegląd i zaimportuj plik ponownie. --- ## Często zadawane pytania **Mój plik CSV zawiera kolumnę `custom_company` z starego eksportu — czy zostanie poprawnie zmapowana?** Nie automatycznie. Automatyczny dopasowywacz kreatora rozpoznaje tylko nagłówki imienia/telefonu/e-maila/tagów/notatek; wszystko inne domyślnie ustawia się na **Nie importuj**, więc kolumna `custom_company` nie wypełni samodzielnie pola niestandardowego `company`. Dodaj wartości później za pomocą [Pól niestandardowych](custom-contact-fields.md) lub przez API. **Gdzie podział się przycisk „Pobierz szablon”?** Zniknął — kreator współpracuje bezpośrednio z dowolnym plikiem CSV, który już posiadasz, i pozwala naprawić wszelkie niedopasowane kolumny w kroku mapowania. **Już zaimportowałem swoje kontakty — jak mogę dodać tagi lub poprawić pola dla wszystkich naraz?** Zaimportuj ponownie ten sam plik (lub zaktualizowany) z włączoną opcją **Aktualizuj istniejące kontakty** w kroku Przegląd. Wiersze pasujące do istniejącego numeru telefonu zaktualizują dany kontakt — imię, e-mail, notatki, tagi i listę — zamiast zostać pominięte. Do dopasowania używane są tylko numery telefonów, więc zachowaj tę kolumnę dokładnie w takiej formie, w jakiej była. **Czy mogę zaimportować kontakty z Instagrama lub Messengera z pliku?** Nie. Import obsługuje tylko WhatsApp Business, WhatsApp Web oraz SMS, ponieważ te kanały docierają do osób za pomocą numeru telefonu. Instagram i Messenger identyfikują użytkowników na podstawie ich kont społecznościowych, dlatego kontakty te są tworzone automatycznie, gdy ktoś napisze do Ciebie w tym kanale. **Czy mogę zaimportować kontakty jako nieaktywne dla bota?** Nie ma do tego kolumny w wierszu. Najpierw zaimportuj partię, a następnie użyj zbiorczej akcji **Wyłącz bota** dla zaimportowanych kontaktów — zobacz [Wykluczanie kontaktów z bota AI](excluding-contacts-from-bot.md). --- ## Następne kroki - [Organizowanie list i kontaktów](list-and-contact-management.md) — zarządzaj i sortuj nowo zaimportowane kontakty. - [Przejście z kampanii na transmisje i agentów](../moving-from-campaigns.md) — zacznij wysyłać wiadomości do zaimportowanej listy. - [Pola niestandardowe, profil leada i notatki](custom-contact-fields.md) — uzupełnij szczegółowe informacje po imporcie.