Identyfikowanie użytkowników
Domyślnie widżet traktuje odwiedzających jako anonimowych. Wywołaj uj.identify, aby powiązać opinie, głosy, komentarze, powiadomienia i rozmowy z kontem klienta.
Podstawowa identyfikacja
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
firstName: 'Ada',
lastName: 'Lovelace',
avatar: 'https://example.com/avatar.jpg'
}
});user.id jest wymagane. Użyj stabilnego identyfikatora z bazy danych zamiast adresu e-mail lub nazwy wyświetlanej, które mogą się zmienić. email jest opcjonalne, ale zdecydowanie zalecane, aby UserJot mógł dopasować użytkownika w różnych tablicach, wiadomościach przekazywanych e-mailem i rozmowach. Przekazanie email powoduje powiązanie wyłącznie z istniejącym kontem UserJot, którego adres e-mail został potwierdzony.
Kiedy wywołać identify
Wywołaj uj.identify, gdy aplikacja rozpozna zalogowanego użytkownika. Ponowne wywołanie z dokładnie tym samym zestawem danych, gdy sesja jest nadal aktywna, nie powoduje żadnych zmian. Po wygaśnięciu sesji lub zmianie dowolnego pola (w tym adresu e-mail lub cech) SDK wysyła nowe żądanie. Przekazanie innego użytkownika natychmiast przełącza sesję.
Gdy użytkownik wyloguje się z aplikacji, wywołaj uj.logout():
if (user) {
uj.identify({
user: {
id: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
}
});
} else {
uj.logout();
}Dodawanie cech
Cechy to niestandardowe atrybuty przypisane do profilu użytkownika, widoczne obok jego zgłoszeń i rozmów w panelu.
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
traits: {
plan: 'pro',
seats: 12,
trialing: false
}
}
});Wartości cech mogą być ciągami znaków, liczbami, wartościami logicznymi lub null (monthlySpend, jeśli jest przesyłany, musi być liczbą nieujemną). Zarezerwowane klucze (takie jak id, email, role lub companies) są ignorowane, a informacja o nich jest zwracana w result.warnings. Pełną listę znajdziesz w dokumentacji SDK.
Dodawanie firm
W przypadku produktów B2B przypisz użytkownikowi co najmniej jedną firmę:
uj.identify({
user: { id: 'user-123', email: 'ada@example.com' },
companies: [
{
id: 'acme',
name: 'ACME Inc.',
domain: 'acme.com',
logo: 'https://acme.com/logo.png',
traits: { plan: 'enterprise', arr: 24000 }
}
]
});id jest wymagane dla każdej firmy. name, domain, logo (adres URL HTTPS) i traits są opcjonalne. Jeśli włączono opcję Wymagaj podpisanych tokenów w Ustawieniach → Logowanie, firmy przekazane poza podpisanym JWT są ignorowane i wyświetlane jest ostrzeżenie UNSIGNED_COMPANY_IGNORED.
Co zwraca identify
Po załadowaniu skryptu SDK uj.identify zwraca obietnicę:
const result = await uj.identify({
user: { id: 'user-123', email: 'ada@example.com' }
});
result.viewer; // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings; // fields the server ignored or adjustedLimity żądań i błędy
Limit szybkości i ograniczanie liczby ponowień po stronie klienta: Liczba żądań identyfikacji jest ograniczona do 30 na minutę i 300 na godzinę dla każdego adresu IP i obszaru roboczego. Przekroczenie limitu godzinowego powoduje blokadę na 1 godzinę. Po otrzymaniu HTTP
429SDK wprowadza lokalny okres oczekiwania (uwzględniającRetry-After, ograniczony do przedziału od 1 sekundy do 1 godziny, domyślnie 60 sekund), dzięki czemu pętle ponawiania żądań kończą się lokalnie i nie przeciążają API.Odrzucone wywołania: Jeśli serwer odrzuci wywołanie identyfikacji (na przykład z powodu nieprawidłowego tokenu, włączonej opcji Wymagaj podpisanych tokenów bez tokenu, konfliktu adresu e-mail skutkującego
409lub członka usuniętego zgodnie z RODO, dla którego zwracane jest403/member_erased), obietnica zostanie odrzucona z błędemIDENTIFY_FAILED, a odwiedzający pozostanie anonimowy.
Tożsamość a konwersacje
Gdy funkcja Rozmowy jest włączona:
Zidentyfikowani użytkownicy nie widzą prośby o podanie danych i otrzymują odpowiedzi zespołu na adres e-mail przypisany do ich konta.
Anonimowi odwiedzający mogą prowadzić rozmowy jako goście, przypisane do przeglądarki. W zależności od ustawień widżetu można też opcjonalnie zbierać ich dane kontaktowe.
W widżecie anonimowi odwiedzający mogą przesyłać opinie i reagować na aktualizacje, natomiast głosowanie na opinie, dodawanie komentarzy i otwieranie dzwonka powiadomień wymaga wywołania uj.identify. Edytowanie lub usuwanie własnych postów i komentarzy w widżecie wymaga podpisanej tożsamości.
Jeśli w Ustawieniach → Logowanie włączono opcję Wymagaj podpisanych tokenów, niepodpisane wywołania identify są odrzucane z kodem HTTP 403, a odwiedzający pozostaje anonimowy. Użyj funkcji Podpisana tożsamość, aby weryfikować konta po stronie serwera.
Którą metodę uwierzytelniania wybrać?
Metoda | Gdzie działa | Zabezpieczenia | Plan | Przewodnik |
|---|---|---|---|---|
Bez podpisu ( | Widżet w aplikacji | Dostarczane przez przeglądarkę (można sfałszować) | Wszystkie plany | Ten artykuł |
Podpisana tożsamość (JWT HS256) | Widżet w aplikacji (oraz linki do portalu publicznego, gdy włączono automatyczne logowanie) | JWT zweryfikowany przez serwer | Starter & Professional (wymagany w trybie ścisłym) | |
Automatyczne logowanie | Portal publiczny i osadzenia w treści ( | JWT HS256 zweryfikowany przez serwer | Starter & Professional | |
Logowanie jednokrotne (SSO) | Przekierowanie do logowania w portalu publicznym | JWT HS256 zweryfikowany przez serwer | Professional | |
SDK Swift ( | Aplikacje na iOS i macOS | Bez podpisu lub podpis HMAC-SHA256 | Starter & Professional (wymaga automatycznego logowania) |
Następny krok
Weryfikuj tożsamość użytkowników w swoim backendzie za pomocą funkcji Podpisana tożsamość.