Profil odwiedzającego, tagi i działania

Twoja strona może powiedzieć zespołowi, kto pisze i co właśnie robił. Zespół widzi to w skrzynce odbiorczej obok rozmowy i na stronie kontaktu.

app.hrc.lt

Czym jest profil odwiedzającego

• Profil: imię, telefon, awatar, firma, tagi i do 50 własnych pól z typami.
• Działania: krótka historia tego, co robił odwiedzający (track).
• Wartości sesji: co jest ważne dla tej rozmowy, wysyłane z każdą wiadomością (setContext).

Profil należy do kontaktu i zostaje między rozmowami. Wartości sesji należą do wiadomości. Nie mieszają się.

// Po zalogowaniu, z podpisem obliczonym przez twój serwer
HrcWidget('identify', {
  externalId: String(customer.id),
  email: customer.email,
  name: customer.name,
  userHash: customer.supportHash,
  attributes: {
    plan: 'pro',
    signed_up_at: customer.createdAt,
    orders: customer.orderCount,
  },
  tags: customer.isVip ? ['vip'] : [],
});

// Później, na dowolnej stronie
HrcWidget('update', { attributes: { cart_items: 3, cart_total: 129.5 } });
HrcWidget('track', 'order-placed', { order_id: 'o-1042', total: 129.5 });

Własne pola

Klucze zarezerwowane (id, email, name, phone, company, tags, language, user_hash, wszystko, co zaczyna się od hrc_, i inne) oraz klucze wyglądające na sekrety (password, secret, token, cvv, card_number, iban, api_key) są odrzucane.

Imię, telefon, awatar i firma

• name do 120 znaków.
• phone do 32 znaków, co najmniej 5 cyfr. Tylko wyświetlany zespołowi, nigdy nie służy do kontaktu.
• avatarUrl tylko https:, do 500 znaków. Gdy się nie wczyta, widać inicjały.
• company: { id?, name, website?, plan? }, jedna firma na kontakt, null usuwa.

Tagi i działania

Tagi (setTags): do 20 na kontakt, małe litery, cyfry i myślnik, do 32 znaków.

Działania (track): nazwa z małych liter, cyfr, _, . i -, do 64 znaków. Najlepiej czyta się czas przeszły: plan-upgraded, checkout.failed. Do 10 właściwości. Przechowywanych jest 100 najnowszych działań, nie dłużej niż 180 dni. Pasek boczny pokazuje 5 najnowszych, strona kontaktu wszystkie.

app.hrc.lt

Działania służą obsłudze klienta („co właśnie robił”), a nie analityce.

Kto co może zmieniać

Każda wartość ma źródło. Niższe źródło nie nadpisuje wyższego: pole jest pomijane, a widżet zapisuje jedno ostrzeżenie w konsoli.

// Bez logowania: wartości mają źródło „z przeglądarki, niezweryfikowane”
HrcWidget('update', {
  attributes: { landing_page: 'pricing', utm_source: 'newsletter' },
});

userHash potwierdza tylko ID i e-mail. Wartości, od których coś zależy (plan, saldo, uprawnienia), wysyłaj ze swojego serwera przez REST API: wtedy ich źródłem jest zespół i przeglądarka nie może ich zmienić.

Kiedy dane są zapisywane

Dopóki odwiedzający nie wyśle wiadomości, nie prześle pliku i nie zostanie rozpoznany, nic nie jest zapisywane ani w jego przeglądarce, ani na serwerze. Do tego czasu zmiany profilu i do 20 działań czekają w pamięci widżetu i są wysyłane zaraz po powstaniu sesji. Przeładowanie strony je usuwa.

Prywatność

Wartości profilu, tagi i działania to dane osobowe kontaktu, a ich administratorem jest twoja firma. Nigdy nie wysyłaj haseł, danych kart płatniczych, danych o zdrowiu ani innych szczególnych kategorii danych. Usunięcie kontaktu usuwa też jego działania.