Dokumentacijos turinys
Gautieji ir el. paštas
Užduotys
Failai
Analitika
Paskyra ir mokėjimai
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.

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.
// 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ė
nameiki 120 simbolių.phoneiki 32 simbolių, bent 5 skaitmenys. Tik rodomas komandai, niekada nenaudojamas susisiekti.avatarUrltikhttps:, iki 500 simbolių. Jei nepavyksta įkelti, rodomos inicialai.company:{ id?, name, website?, plan? }, viena įmonė kontaktui,nullpaš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.

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“ |
// 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