# Lankytojo profilis, žymos ir veiksmai

> Perduokite lankytojo planą, įmonę, savus laukus, žymas ir veiksmus iš savo svetainės. Komanda juos mato šalia pokalbio. Ribos ir privatumas.

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](https://hrc.lt/screens/lt/inbox-contact-profile.desktop.1600.89e6fde3.webp)

## 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](https://hrc.lt/screens/lt/contact-events.desktop.1600.f90e43c2.webp)

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](https://hrc.lt/dokumentacija/ai-agentai/rest-api#trusted-profile): 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.