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, dowolnego z Twoich pól niestandardowych lub Nie importuj. Sprawdź propozycję dla każdej kolumny i popraw błędne dopasowania za pomocą selektora obok niej. Tabela podglądu pokazuje kilka pierwszych wierszy dokładnie tak, jak zostaną zaimportowane.
    • Kolumna, której nagłówek jest nazwą jednego z Twoich pól niestandardowych, jest automatycznie dopasowywana do tego pola. Wielkość liter i znaki diakrytyczne nie mają znaczenia, więc kolumna CPF zostanie dopasowana do pola o nazwie cpf. Możesz również ręcznie wybrać dowolne pole niestandardowe dla każdej kolumny.
    • Kolumna, która nie jest jeszcze jednym z Twoich pól niestandardowych, może się nim stać: wybierz Nowe pole niestandardowe: w selektorze, a pole zostanie utworzone podczas importu.
    • Jeśli pole niestandardowe ma określony typ (Liczba, Pole wyboru, Lista rozwijana), a niektóre wartości w kolumnie do niego nie pasują, kreator ostrzeże Cię przed importem, ilu wierszy to dotyczy. Te wiersze zostaną całkowicie pominięte, włącznie z imieniem i adresem e-mail. Kliknij Zmień na Tekst w ostrzeżeniu, aby zmienić typ pola w jednym kroku, popraw wartości lub ustaw kolumnę na Nie importuj.
    • Kolumna z numerem telefonu jest wymagana — nie możesz kontynuować bez jej zmapowania.
    • Kolumna zmapowana na Tagi stanie się rzeczywistymi tagami przy każdym kontakcie. Kilka tagów w jednej komórce jest w porządku — oddziel je przecinkiem lub średnikiem (vip; newsletter; hotmart). Tagi, które jeszcze nie istnieją, zostaną utworzone automatycznie; 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 wykonać tylko jedną z tych czynności, nie obie naraz. Jeśli otworzysz import, gdy na stronie Kontakty wyświetlana jest jedna z Twoich list, zostanie ona wybrana automatycznie; usuń ją, jeśli jej nie chcesz.
    • 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, chociaż jeśli wybrano listę, posiadany już kontakt zostanie do niej dodany. Gdy jest włączone, te wiersze aktualizują kontakt: imię, adres 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]. Zobaczysz ekran wyników pokazujący, ile kontaktów utworzono, ile istniejących kontaktów zaktualizowano (jeśli ta opcja była włączona), ile Twoich dotychczasowych kontaktów dodano do wybranej listy oraz, jeśli pominięto jakieś wiersze, szczegółowe wyjaśnienie dlaczego (nieprawidłowy numer telefonu, brak numeru telefonu, duplikat, osiągnięto limit kontaktów itp.). Jeśli opcja Aktualizuj istniejące kontakty była wyłączona, a niektóre wiersze pasowały do kontaktów, które już masz, ekran wyników poinformuje o tym i zaoferuje opcję Aktualizuj te kontakty: jedno kliknięcie spowoduje ponowne przesłanie tylko tych wierszy z włączonym przełącznikiem, dzięki czemu nie musisz ponownie importować pliku.

Szczegóły mapowania kolumn

  • Telefon to jedyna wymagana kolumna. Wiersze bez numeru telefonu są odrzucane przed importem i zliczane 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 używają 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 tagów w jednej komórce, rozdzielają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; napisz do wsparcia, jeśli chcesz, aby zostało usunięte z każdego kontaktu).
  • Pola niestandardowe — każde z Twoich pól niestandardowych jest osobnym celem. Nagłówek pasujący do nazwy pola zostanie wybrany automatycznie; wartość jest zapisywana w kontakcie dokładnie tak, jak w pliku (pole typu Liczba, Data, Pole wyboru lub Lista rozwijana konwertuje rozpoznawalne formaty, takie jak 19,99, 01/02/1990 lub yes). Wybierz Nowe pole niestandardowe, aby utworzyć pole z kolumny. Przy włączonej opcji Aktualizuj istniejące kontakty, wartości pól niestandardowych w pliku aktualizują również posiadane już kontakty; puste komórki pozostawiają bieżącą wartość bez zmian.
  • Kolumna zawierająca identyfikatory z kropkami, myślnikami lub wiodącymi zerami (CPF, numer podatkowy, kod pocztowy) powinna być polem typu Tekst. W polu typu Liczba takie wartości nie pasują i wiersz jest pomijany.

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ą analizowane w całości w Twojej przeglądarce, więc sam kreator nie ma sztywnego limitu rozmiaru przesyłania — ale całkowita liczba kontaktów jest nadal ograniczona przez Twój plan. Jeśli import spowodowałby przekroczenie limitu 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. Wybór listy nadal działa w przypadku tych wierszy: posiadany już kontakt jest dodawany do listy i liczony oddzielnie na ekranie wyników, więc ponowne zaimportowanie tego samego pliku to sposób na wypełnienie listy osobami, które już masz na koncie. Aby również odświeżyć ich pola (poprawić imiona lub adresy e-mail, dodać tagi), 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 ze starego eksportu — czy zmapuje się poprawnie? Nie automatycznie, ponieważ nagłówek nie jest dokładnie taki sam jak company. Wybierz Pole niestandardowe: company w selektorze tej kolumny, a dane zostaną zaimportowane do pola company. Zmiana nazwy nagłówka na company przed przesłaniem pliku sprawi, że kreator dopasuje go automatycznie.

Niektóre wiersze zostały pominięte z komunikatem „Wartość pola niestandardowego nie pasuje do typu pola” — dlaczego? Kolumna jest zmapowana na pole niestandardowe z określonym typem (na przykład Liczba), a te wiersze zawierają coś innego, np. 001.576.401-08 w polu typu Liczba. Kliknij Zmień na Tekst w ostrzeżeniu na etapie mapowania kolumn (lub zmień typ w sekcji Pola niestandardowe) i zaimportuj plik ponownie z włączoną opcją Aktualizuj istniejące kontakty.

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