
# Pola niestandardowe, profil leada i notatki

Każdy kontakt ma podstawowe dane — imię i nazwisko, numer telefonu, adres e-mail, kanał komunikacji. Zazwyczaj jednak wiesz o osobach, z którymi rozmawiasz, znacznie więcej: gdzie pracują, kiedy mają urodziny, co ostatnio kupiły, z jakiej konferencji do Ciebie trafiły. Ta strona opisuje dodatkowe informacje, które możesz przypisać do kontaktu, oraz miejsca, w których się one znajdują.


---

## Omówienie

| Co | Najlepsze do | Gdzie się znajduje |
|---|---|---|
| **Pola niestandardowe** | Krótkie, ustrukturyzowane fakty (firma, stanowisko, data urodzin, plan itp.) | Lista par klucz/wartość przy kontakcie |
| **Notatki (= Profil leada)** | Dowolny opis tego, kim jest ta osoba i dlaczego jest ważna — czytany przez AI podczas personalizacji odpowiedzi | Pojedyncze pole tekstowe przy kontakcie |
| **Status** | Śledzenie etapu podróży kontaktu, w tym oznaczanie go jako spam | Pojedyncza wartość przy kontakcie |

> **Jeśli korzystasz z aplikacji od dłuższego czasu:** to, co wcześniej było dwiema oddzielnymi funkcjami — rozbudowanym „Profilem leada” i listą datowanych notatek — zostało teraz połączone w **jedno pole** o nazwie **Notatki** w pełnym profilu kontaktu. Nie ma już osobnego dziennika notatek z sygnaturami czasowymi i tytułami; wszystko, co chcesz zapisać na temat kontaktu, trafia do tego jednego pola. Zobacz sekcję [Notatki](#notes-lead-profile) poniżej, aby dowiedzieć się, co to oznacza w praktyce.

---

## Definiowanie pól niestandardowych

Pola niestandardowe można wielokrotnie wykorzystywać dla wszystkich kontaktów. Gdy utworzysz pole, takie jak `company`, stanie się ono częścią schematu Twojego konta i będzie pojawiać się jako sugestia za każdym razem, gdy będziesz edytować inny kontakt.

**Typ pola:** Pola niestandardowe obsługują tylko zwykły tekst — nie ma typów rozwijanych, przycisków opcji ani wyboru wielokrotnego. Jeśli chcesz, aby pole zawierało tylko jedną z kilku określonych wartości (np. źródło leada: „Newsletter”, „Polecenie” lub „Reklama”), wpisuj tę samą wartość konsekwentnie lub wypełnij ją masowo poprzez eksport/import arkusza kalkulacyjnego, aby każdy kontakt używał dokładnie takiego sformułowania, jakiego oczekujesz.

**Zasady nazewnictwa:**

- Nazwy pól mogą zawierać wyłącznie małe litery, cyfry i znaki podkreślenia oraz muszą zaczynać się od litery lub znaku podkreślenia (na przykład `lead_source`, a nie `Lead Source`).
- **Tylko angielskie litery bez znaków diakrytycznych** — spacje, wielkie litery oraz znaki akcentowane lub niełacińskie są odrzucane. Nawet jeśli reszta Twojego konta jest w innym języku, nazwij pole `cumpleanos` lub `birthday`, a nie `cumpleaños`. Ograniczenie dotyczy tylko nazwy; przechowywana w nim wartość może być w dowolnym języku.
- Konto może mieć do **50 pól niestandardowych**.
- Wybieraj nazwę ostrożnie — gdy pole zostanie użyte w szablonie lub kampanii, nie możesz go usunąć bez wcześniejszego usunięcia tych odniesień.

---

## Wypełnianie pól niestandardowych w kontakcie

1. Na lewym pasku bocznym kliknij **Kontakty**.
2. Kliknij wiersz kontaktu, aby otworzyć [panel szybkiego podglądu](creating-contacts.md), a następnie kliknij **Edytuj** — lub kliknij **Nowy kontakt**, aby utworzyć nowy.
3. W formularzu kontaktu znajdź sekcję **Pola niestandardowe**.
4. Wpisz nazwę w polu **Dodaj pole** (istniejące nazwy pól pojawią się jako sugestie — kliknij jedną, aby użyć jej ponownie), kliknij **Dodaj**, a następnie wpisz wartość.
5. Kliknij **Zapisz** w formularzu, aby ją zapisać.


Pola, które mają już przypisaną wartość, są widoczne w panelu szybkiego podglądu oraz w pełnym rekordzie kontaktu jako wiersze tylko do odczytu — aby zmienić wartość, otwórz ponownie **Edytuj**.


**Usunięcie pola** z formularza edycji usuwa tę wartość z kontaktu. Całkowite usunięcie pola ze wszystkich kontaktów i schematu konta nie jest możliwe, dopóki jest ono używane w szablonie lub kampanii.

---

## Pozwalanie AI na wypełnianie pól niestandardowych za Ciebie

Twój Agent AI może zapisywać informacje bezpośrednio w polach niestandardowych, gdy pojawią się one w rozmowie — urodziny, imię partnera, wymagania dietetyczne, preferencje dotyczące stolika — dzięki czemu możesz ich później użyć w transmisji lub wiadomości uzupełniającej. Ta funkcja jest domyślnie wyłączona i zapisuje dane tylko w polach, które wyraźnie wybierzesz.

Muszą zostać spełnione dwa warunki i **oba** są niezbędne — to najczęstszy powód, dla którego użytkownicy stwierdzają, że nic nie zostało zapisane:

**1. Najpierw utwórz pola.** AI może zapisywać dane tylko w polach, które już istnieją na Twoim koncie. Dodaj je w standardowy sposób (zobacz [Wypełnianie pól niestandardowych w kontakcie](#filling-in-custom-fields-on-a-contact) powyżej) — na przykład `customer_birthday`, `partner_name`, `dietary_notes`. Pamiętaj o zasadach nazewnictwa: tylko małe litery, cyfry i znaki podkreślenia.

**2. Nadaj Agentowi uprawnienia i wybierz pola.**

1. Kliknij **Agenci AI** na pasku bocznym i otwórz Agenta.
2. Przejdź do karty **Możliwości AI**.
3. W sekcji **Aktualizacje kontaktu** włącz **Pozwól AI zbierać dodatkowe informacje**.
4. Pojawi się karta zatytułowana **Zbieraj dodatkowe informacje podczas rezerwacji**, zawierająca listę Twoich pól niestandardowych. Włącz przełącznik obok **każdego** pola, które AI może wypełniać — samo utworzenie pola nie wystarczy, a każde pominięte pole będzie ignorowane. (Jeśli karta informuje, że nie masz jeszcze żadnych pól niestandardowych, wróć i utwórz je najpierw).
5. Kliknij **Zapisz**, a następnie **Opublikuj** Agenta. Zmiany pozostają w wersji roboczej do momentu publikacji, więc nieopublikowana zmiana nie wpłynie na trwające rozmowy. Publikacja wprowadza **wszystkie** oczekujące zmiany, nie tylko tę jedną, więc przejrzyj najpierw inne karty, jeśli dokonywałeś edycji.


**Warto wiedzieć:**

- **Działa to przez całą rozmowę, nie tylko podczas rezerwacji.** Pomimo brzmienia karty — rezerwacje to miejsce, w którym funkcja się zaczęła — AI zapisuje wartość w momencie, gdy kontakt o niej wspomni, niezależnie od tego, czy dotyczy to spotkania. Wcale nie musisz mieć włączonych rezerwacji.
- **Każde pole można oznaczyć jako wymagane.** Wymagane oznacza tylko "musi zostać zebrane przed potwierdzeniem spotkania przez AI" — nigdy nie blokuje normalnej rozmowy i nie działa u Agenta, który nie przyjmuje rezerwacji.
- **To, że AI "zanotowało" coś, nie jest równoznaczne z zapisaniem tego.** Jeśli pole nie zostało utworzone i włączone, AI może nadal uprzejmie odpowiedzieć, że zanotowało informację, ale nic nie trafi do kontaktu. Sprawdź rekord kontaktu, aby potwierdzić, że wartość faktycznie została zapisana.
- **Powiedz Agentowi, kiedy ma pytać.** W instrukcjach Agenta opisz, kiedy każde pole ma zastosowanie ("jeśli gość wspomni o alergii lub diecie, zapisz to w `dietary_notes`"). AI czyta to w prostym języku, więc nie będzie przesłuchiwać wszystkich tą samą listą.
- **Nic nie jest uzupełniane wstecznie.** Przechwytywane są tylko rozmowy od momentu publikacji — szczegóły wspomniane w przeszłych czatach nie są wypełniane retrospektywnie.
- **Skonfiguruj to na koncie, do którego należą kontakty.** Pola niestandardowe należą do jednego konta, więc w konfiguracji agencyjnej utwórz je na subkoncie, którego Agent prowadzi rozmowę, a nie na nadrzędnym koncie agencji.
- **Notatki w dowolnym formacie również należą do pola.** AI konwersacyjne nie może pisać w polu **Profil leada / Notatki** kontaktu (patrz poniżej) — jest ono przeznaczone dla Ciebie i Twojego zespołu, choć [Automatyzacje](../automations/automations.md) i API mogą w nim pisać. Jeśli chcesz, aby samo AI zapisało coś w stylu "poproszono o danie bezglutenowe", zrób z tego pole niestandardowe, takie jak `dietary_notes`.

---

## Co AI może odczytać podczas rozmowy

Jeśli zastanawiasz się, gdzie umieścić informacje, aby AI mogła **wykorzystać je podczas czatu**, oto różnica, która ma znaczenie:

- **Pola niestandardowe: AI odczytuje je przy każdej odpowiedzi.** Wszystkie wartości pól niestandardowych kontaktu są dostępne dla AI przez cały czas trwania rozmowy — niezależnie od tego, w jaki sposób pole zostało wypełnione (przez Ciebie, wcześniej przez AI, poprzez import lub API). Dzięki temu reguła w instrukcjach Twojego Agenta, taka jak „witaj powracających klientów po ich `preferred_barber`”, działa, ponieważ AI widzi tę wartość w danym momencie.
- **Tagi: AI nie widzi ich podczas czatu.** Tagowanie odbywa się jako osobny krok po wysłaniu odpowiedzi przez AI — AI nakłada tagi na podstawie Twoich opisów, ale nie widzi, jakie tagi posiada już kontakt w trakcie rozmowy. Instrukcje typu „jeśli kontakt ma tag VIP, zaoferuj zniżkę” **nie** zadziałają.

Zasada jest prosta: wszystko, co AI powinna odczytać i na co powinna zareagować w trakcie rozmowy, należy umieścić w **polu niestandardowym**. **Tagi** służą do wszystkiego, co dzieje się wokół rozmowy — filtrowania i segmentowania kontaktów, kierowania wiadomości masowych oraz wyzwalania [webhooków tagów](../integrations/webhooks.md) w innych systemach w momencie, gdy AI je zastosuje.

---

## Masowe ładowanie pól niestandardowych

Kreator importu rozpoznaje w mapowaniu kolumn tylko **imię, nazwisko, telefon, email, tagi i notatki** — nie ma kroku „mapuj tę kolumnę arkusza kalkulacyjnego do pola niestandardowego” (tagi natomiast importują się jako rzeczywiste tagi). Aby masowo załadować wartości pól niestandardowych, użyj API — wybór ścieżki zależy od tego, czy kontakty już istnieją.

**Dodajesz zupełnie nowe kontakty?** Punkt końcowy API do masowego importu kontaktów przyjmuje wartości pól niestandardowych bezpośrednio w tym samym wywołaniu, więc nie potrzebujesz drugiego przejścia. Dołącz obiekt `custom_fields` do każdego rekordu obok imienia, telefonu i adresu email, a kontakty pojawią się z już wypełnionymi polami niestandardowymi. Format żądania jest udokumentowany w sekcji Kontakty w dokumentacji API.

**Uzupełniasz dane kontaktów, które już masz?**

1. Pobierz listę swoich kontaktów przez API, aby uzyskać identyfikator (ID) każdego kontaktu. Eksport do CSV nie zawiera kolumny z identyfikatorem kontaktu ani żadnych kolumn pól niestandardowych. Zobacz [Dostęp do API](../integrations/api-access.md), aby dowiedzieć się, jak uzyskać klucz i wywołać punkt końcowy.
2. Wypełnij wartości w swoim arkuszu kalkulacyjnym.
3. Użyj punktu końcowego API do aktualizacji kontaktów (zobacz [Dostęp do API](../integrations/api-access.md)), aby zapisać je z powrotem dla każdego kontaktu, ponieważ sam kreator importu nie posiada jeszcze mapowania kolumn pól niestandardowych. Każda aktualizacja dotyczy tylko wysłanych kluczy — wszelkie pominięte pola niestandardowe zachowują swoje bieżące wartości.

---

## Notatki (= Profil leada)

W **pełnym rekordzie** kontaktu (kliknij **Otwórz pełny rekord** w panelu szybkiego podglądu), panel **Notatki** to pojedyncze pole tekstowe — to samo pole, do którego w innych miejscach odnosi się nazwa "Profil leada". W formularzu **Edycji** kontaktu to samo pole jest oznaczone jako **Profil leada**, opisane jako "Wewnętrzne notatki o tym kontakcie", więc nie szukaj drugiego pola. Zapisuj wszystko, co jest istotne dla rozmowy: rodzaj działalności, problemy, wielkość firmy, ostatnią aktywność, wszystko, co pomaga spersonalizować kontakt.

**Jak wykorzystuje to AI:** w szablonie wiadomości — wiadomości masowej, wiadomości uzupełniającej (follow-up) czy instrukcjach dla agenta AI — możesz umieścić symbol zastępczy, taki jak `{{personal_context|write a one-line opener that references their business}}`. Gdy szablon zostanie wysłany do konkretnego kontaktu, AI odczyta jego notatki i napisze spersonalizowany wiersz, wykorzystując zawarte w nich informacje. Jeśli kontakt nie ma notatek, symbol zastępczy zostanie po prostu usunięty z wiadomości.

AI **nie** zapisuje tego za Ciebie — wypełniasz to Ty lub Twój zespół. Pomyśl o tym jak o ściądze, którą chciałbyś, aby przedstawiciel handlowy przeczytał przed wykonaniem telefonu. Jeśli chcesz, aby samo AI zapisało coś, czego dowiedziało się w rozmowie, użyj zamiast tego pola niestandardowego — zobacz [Pozwalanie AI na wypełnianie pól niestandardowych za Ciebie](#letting-the-ai-fill-custom-fields-for-you).

Edycja jest prosta: wpisz tekst w polu, a następnie kliknij **Zapisz notatkę** (lub **Odrzuć**, aby porzucić niezapisane zmiany). Nie ma oddzielnego tytułu ani daty dla każdego wpisu — jest to jeden ciągły blok tekstu na kontakt, więc jeśli chcesz prowadzić dziennik z datami, dodawaj datę samodzielnie przed każdym wpisem.

---

## Status

Każdy kontakt posiada plakietkę **Status**, która pokazuje, na jakim etapie podróży się znajduje:

| Status | Co to oznacza |
|---|---|
| **Nowy** | Właśnie dodany, jeszcze nie nawiązano kontaktu. |
| **Zaangażowany** | Aktywnie w trakcie rozmowy. |
| **Lead** | Wykazuje zainteresowanie zakupem. |
| **Klient** | Dokonał konwersji. |
| **Odszedł** | Był klientem, już nie jest aktywny. |
| **Spam** | Ukryty przed głównymi listami; bot AI nie będzie z nim wchodził w interakcje, włączona jest opcja „Nie przeszkadzać” i jest wykluczony z kampanii. |

Kliknij plakietkę **Status** bezpośrednio w tabeli kontaktów, aby zmienić go w wierszu — dotyczy to każdego statusu poza Spamem, który ustawia się poprzez masową akcję **Oznacz jako spam** (i jej potwierdzenie), ponieważ wiąże się to z dodatkowymi efektami ubocznymi. Odznaczanie spamu jest dostępne w ten sam sposób jako **Odznacz jako spam**.

---

## Przypisywanie kontaktu do członka zespołu

Przypisanie właściciela — przekazanie kontaktu jednemu członkowi zespołu, aby inni nie odpowiedzieli przez pomyłkę — ustawia się z poziomu ekranu **Czaty**, a nie strony Kontakty: otwórz rozmowę i użyj znajdującego się tam narzędzia przypisywania. Zobacz [Interfejs czatu](../chats/chat-interface.md), aby uzyskać pełny przewodnik. Tylko właściciele konta i użytkownicy z odpowiednimi uprawnieniami mogą zmieniać przypisanie.

---

## Używanie pól niestandardowych w wiadomościach masowych i szablonach

Pola niestandardowe świetnie sprawdzają się w wiadomościach wychodzących. Wszędzie tam, gdzie możesz napisać wiadomość — w wiadomościach rozsyłanych, szablonach WhatsApp, instrukcjach dla Agenta AI — możesz wstawić symbol zastępczy, taki jak:

```
Hey {{first_name}}, hope things are going well at {{company}}!
```

Gdy wiadomość zostanie wysłana, `{{first_name}}` i `{{company}}` zostaną zastąpione wartościami z profilu każdego kontaktu. Jeśli kontakt nie ma wypełnionego danego pola, symbol zastępczy pozostanie pusty.

Kilka wskazówek:

- **Używaj małych liter i podkreślników** — symbol zastępczy musi dokładnie odpowiadać nazwie pola (`{{company}}`, a nie `{{Company}}`).
- **Wbudowane pola również działają** — `{{first_name}}`, `{{last_name}}`, `{{email}}` oraz `{{phone_number}}` działają bez konieczności konfigurowania ich jako pól niestandardowych.
- **Łącz z Notatkami** — w przypadku treści personalizowanych przez AI użyj `{{personal_context|your instruction}}` zamiast stałego pola niestandardowego; AI napisze coś nowego w oparciu o Notatki kontaktu.
- **Nie można usunąć pola, które jest w użyciu** — jeśli szablon korzysta z `{{company}}`, system zablokuje usunięcie `company`, dopóki nie usuniesz go z tych szablonów.

---

## Potrzebujesz pomocy?

Dobra zasada dotycząca tego, co gdzie umieścić:

- **Krótki, ustrukturyzowany fakt, według którego będziesz filtrować lub scalać** → pole niestandardowe.
- **Akapit kontekstu do przeczytania przez AI lub Twój zespół** → Notatki.
- **Kto jest właścicielem konwersacji** → osoba przypisana, ustawiana w Czatach.

Nadal masz problem? Skontaktuj się z pomocą techniczną, a pomożemy Ci to skonfigurować.

---

## Następne kroki

- [Dodawanie nowego kontaktu](creating-contacts.md) — dodawanie kontaktów pojedynczo oraz pełny przewodnik po ekranie Kontaktów.
- [Importowanie kontaktów z pliku](importing-contacts.md) — importowanie danych z arkusza kalkulacyjnego.
- [Interfejs czatu](../chats/chat-interface.md) — miejsce, w którym zarządza się przypisywaniem kontaktów.
