Your AI Connector Docs

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.
  1. 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.
  1. 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.
  1. 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 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_<fieldname> z wersji klasycznej) — zobacz Masowe ładowanie pól niestandardowych, 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 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.

Następne kroki