Kontakty

Przechowuj i zarządzaj zidentyfikowanymi osobami, które rozmawiają z Twoim agentem. Kontakty są tworzone automatycznie na podstawie weryfikacji tożsamości albo dodawane ręcznie lub przez import CSV.

Reserved integration fields remain read-only: instagram_username, stripe_customer_id, and source.

Kontakt to zidentyfikowana osoba, która rozmawiała z Twoim agentem — w odróżnieniu od anonimowego odwiedzającego. Każdy kontakt jest identyfikowany przez niezmienny Zewnętrzny ID pochodzący z Twojego własnego systemu, dzięki czemu ta sama osoba pozostaje jednym kontaktem niezależnie od sesji i urządzenia.

Kontakty znajdziesz w zakładce Kontakty swojego agenta.

Co przechowuje kontakt

Pole	Opis
Zewnętrzny ID	Niezmienny identyfikator z Twojego systemu (JWT `sub`). Unikalny dla danego agenta.
E-mail	Adres e-mail kontaktu.
Nazwa	Wyświetlana nazwa kontaktu.
Telefon	Numer telefonu kontaktu.
Atrybuty niestandardowe	Dowolne dodatkowe dane, które dołączysz (plan, firma, identyfikatory Stripe, …).
Ostatnia aktywność	Aktualizowana automatycznie za każdym razem, gdy kontakt prowadzi rozmowę.

Dane kontaktu są przechowywane, abyś mógł je przeglądać i segmentować. Ze względu na prywatność nigdy nie są wstrzykiwane do odpowiedzi agenta — zobacz Weryfikacja tożsamości → Prywatność.

Jak tworzone są kontakty

Automatycznie, na podstawie weryfikacji tożsamości (zalecane)

Gdy włączysz weryfikację tożsamości, Twój backend podpisuje JWT dla każdego zalogowanego użytkownika. Gdy zweryfikowany użytkownik rozmawia po raz pierwszy, Agentkit tworzy kontakt na podstawie danych z tokenu i łączy z nim rozmowę. Kolejne rozmowy aktualizują ten sam kontakt i odświeżają pole Ostatnia aktywność. Nie jest potrzebne osobne wywołanie API.

Ręcznie

Kliknij Dodaj kontakt, a następnie podaj Zewnętrzny ID (wymagany) oraz opcjonalnie imię i nazwisko, e-mail i telefon. Zewnętrzny ID musi być unikalny dla danego agenta.

Przez import CSV

Użyj opcji Importuj, aby zbiorczo utworzyć lub zaktualizować kontakty z arkusza kalkulacyjnego — patrz poniżej.

Importowanie kontaktów przez CSV

Kliknij Importuj i prześlij plik .csv. Pierwszy wiersz musi być wierszem nagłówka. Obsługiwane kolumny:

Kolumna	Wymagana	Uwagi
`external_id`	Tak	Unikalny identyfikator dla każdego kontaktu. Wiersze bez niego są pomijane.
`name`	Nie	Do 255 znaków.
`email`	Nie	Do 320 znaków.
`phone`	Nie	Do 50 znaków.

external_id,name,email,phone
import-001,Alice Imported,[email protected],+1 555 000 0001
import-002,Bob Imported,[email protected],+1 555 000 0002

Skorzystaj z linku Pobierz szablon w oknie importu, aby pobrać plik startowy.

Limity i zachowanie:

Maksymalny rozmiar pliku: 5 MB; do 10 000 wierszy na import.
Jeśli external_id już istnieje, wiersz aktualizuje ten kontakt zamiast tworzyć duplikat.
Po zakończeniu importu zobaczysz, ile kontaktów zostało przetworzonych, a ile pominiętych.

Wyszukiwanie kontaktów

Tabela Kontaktów obsługuje:

Wyszukiwanie po Zewnętrznym ID, e-mailu, imieniu i nazwisku oraz telefonie.
Stronicowanie dla dużych list kontaktów.
Przełącznik Kolumny do pokazywania lub ukrywania kolumn.