Pereiti prie turinio
HRC pagalba
Dokumentacijos turinys

Lankytojo profilis, žymos ir veiksmai

Atnaujinta

Jūsų svetainė gali pasakyti komandai, kas rašo ir ką jis ką tik darė. Komanda tai mato gautuosiuose šalia pokalbio ir kontakto puslapyje.

Kontakto šoninė juosta su įmone, planu, žymomis ir paskutiniais veiksmais

Kas yra lankytojo profilis

  • Profilis: vardas, telefonas, nuotrauka, įmonė, žymos ir iki 50 savų laukų su tipais.
  • Veiksmai: trumpa istorija to, ką lankytojas darė (track).
  • Sesijos reikšmės: kas svarbu šiam pokalbiui, siunčiama su kiekviena žinute (setContext).

Profilis priklauso kontaktui ir išlieka tarp pokalbių. Sesijos reikšmės priklauso žinutėms. Jos nesimaišo.

js
// Po prisijungimo, su jūsų serverio apskaičiuotu parašu
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'] : [],
});

// Vėliau, bet kuriame puslapyje
HrcWidget('update', { attributes: { cart_items: 3, cart_total: 129.5 } });
HrcWidget('track', 'order-placed', { order_id: 'o-1042', total: 129.5 });

Savi laukai

Taisyklė Reikšmė
Raktas Mažosios raidės, skaičiai, _ ir -, prasideda raide, iki 40 simbolių. Didžiosios raidės paverčiamos mažosiomis.
Tipai Tekstas (1 iki 255 simbolių), skaičius, true/false, data.
Data JS Date arba ISO 8601 tekstas (2026-11-02) rakte, kuris baigiasi _at arba _date.
Kiekis Iki 50 laukų kontaktui.
Pašalinti null arba ''.
Neleidžiama Objektai ir masyvai (įmonė yra atskiras laukas).

Rezervuoti raktai (id, email, name, phone, company, tags, language, user_hash, viskas, kas prasideda hrc_, ir kiti) ir į slaptažodžius panašūs raktai (password, secret, token, cvv, card_number, iban, api_key) atmetami.

Vardas, telefonas, nuotrauka ir įmonė

  • name iki 120 simbolių.
  • phone iki 32 simbolių, bent 5 skaitmenys. Tik rodomas komandai, niekada nenaudojamas susisiekti.
  • avatarUrl tik https:, iki 500 simbolių. Jei nepavyksta įkelti, rodomos inicialai.
  • company: { id?, name, website?, plan? }, viena įmonė kontaktui, null pašalina.

Žymos ir veiksmai

Žymos (setTags): iki 20 kontaktui, mažosios raidės, skaičiai ir brūkšnelis, iki 32 simbolių.

Veiksmai (track): pavadinimas iš mažųjų raidžių, skaičių, _, . ir -, iki 64 simbolių. Geriausiai skaitosi būtasis laikas: plan-upgraded, checkout.failed. Iki 10 savybių. Saugomi naujausi 100 veiksmų, ne ilgiau kaip 180 dienų. Šoninėje juostoje matomi 5 naujausi, kontakto puslapyje visi.

Kontakto puslapis su profilio laukais, šaltiniais ir veiksmais

Veiksmai skirti pagalbai („ką jis ką tik darė“), ne analitikai.

Kas ką gali keisti

Kiekviena reikšmė turi šaltinį. Žemesnis šaltinis neperrašo aukštesnio: toks laukas praleidžiamas, o valdiklis parašo vieną įspėjimą konsolėje.

Šaltinis Kas rašo Programoje rodoma
Komanda Narys programoje, DI agentas per MCP ar REST API „nustatė komanda“
Jūsų svetainė SDK, kai sesija atpažinta su galiojančiu userHash „iš jūsų svetainės“
Naršyklė SDK neatpažintoje sesijoje „iš naršyklės, nepatvirtinta“
js
// Be prisijungimo: reikšmės saugomos kaip „iš naršyklės, nepatvirtinta“
HrcWidget('update', {
  attributes: { landing_page: 'pricing', utm_source: 'newsletter' },
});

userHash patvirtina tik ID ir el. paštą. Reikšmės, nuo kurių kas nors priklauso (planas, balansas, teisės), siųskite iš savo serverio per REST API: tada jų šaltinis yra komanda, ir naršyklė jų pakeisti negali.

Kada duomenys išsaugomi

Kol lankytojas neparašo žinutės, neįkelia failo ir nėra atpažintas, niekas neišsaugoma nei jo naršyklėje, nei serveryje. Iki tol profilio pakeitimai ir iki 20 veiksmų laukia valdiklio atmintyje ir išsiunčiami iškart atsiradus sesijai. Perkrovus puslapį jie dingsta.

Privatumas

Profilio reikšmės, žymos ir veiksmai yra kontakto asmens duomenys, o jūsų įmonė yra jų valdytoja. Niekada nesiųskite slaptažodžių, mokėjimo kortelių duomenų, sveikatos ar kitų ypatingų kategorijų duomenų. Ištrynus kontaktą ištrinami ir jo veiksmai.

Neradote atsakymo? Parašykite mums