# Kontaktai ir sąrašai

> Paprasta CRM skiltyje Kontaktai: pridėjimas ir CSV importas, etapai, žymos, sąrašai meniu, priminimai, laukai ir duomenys iš jūsų sistemos per API.

Skiltis Kontaktai yra paprasta CRM jūsų komandai. Čia visi žmonės, su kuriais bendraujate, su etapu, atsakingu nariu, žymomis, laukais, pastabomis ir priminimais.

![Kontaktų sąrašas su etapais, žymomis, priminimais ir sąrašais meniu](https://hrc.lt/screens/lt/contacts-list.desktop.2400.d0430aa8.webp)

## Kaip atsiranda kontaktai

- **Patys.** Kai kas nors parašo per pokalbių valdiklį ar el. paštu, arba jūsų svetainė jį atpažįsta.
- **Ranka.** Mygtukas „Naujas kontaktas“. Užtenka vardo arba el. pašto. Jei toks el. paštas jau priklauso kontaktui, programa parodo jį ir nesukuria antro.
- **Iš CSV failo.** Mygtukas „Importuoti CSV“, žr. žemiau.
- **Per API.** Iš jūsų sistemos, žr. [Duomenys iš jūsų sistemos](#api).

Ranka įvestas el. paštas susiejamas su kontaktu, todėl žmogaus atsakymas į jūsų laišką patenka pas tą patį kontaktą. Toks adresas lieka nepatvirtintas, kol žmogus atsakys į jūsų laišką.

## Importas ir eksportas

„Importuoti CSV“ veda per keturis žingsnius:

1. **Failas:** `.csv` iki 5 MB ir 5000 eilučių. Skirtukas (`,`, `;` ar tabuliacija) ir koduotė atpažįstami patys.
2. **Stulpeliai:** kiekvienam stulpeliui pasirinkite, kur jį dėti: vardas, el. paštas, telefonas, įmonė, etapas, žymos, pastaba, jūsų laukas arba nauja informacija. Įprasti pavadinimai atpažįstami penkiomis kalbomis.
3. **Nustatymai:** ką daryti, jei kontaktas jau yra (atnaujinti arba praleisti), ir kokią žymą, sąrašą, etapą ar atsakingą duoti visiems importuotiems. Prieš importą matote, kiek bus naujų, esamų ir praleistų.
4. **Importas:** eiga ir rezultatas. Praleistas eilutes su priežastimi galite atsisiųsti.

![CSV importas: failo stulpeliai priskiriami kontakto laukams](https://hrc.lt/screens/lt/contacts-import.desktop.1600.1bc7a86f.webp)

Eksportas: meniu ⋯, „Eksportuoti CSV“. Faile yra matomi stulpeliai, el. paštas ir telefonas, iki 10 000 eilučių. Failas atsidaro Excel.

## Etapas, atsakingas ir žymos

- **Etapas:** Potencialus klientas, Bendraujame, Klientas, Buvęs klientas, Netinkamas arba Be etapo.
- **Atsakingas:** vienas komandos narys. Sąraše „Mano“ matote savo kontaktus.
- **Žymos:** trumpi pavadinimai su spalva, pvz. „VIP“. Žymas tvarkote meniu ⋯, „Žymos“. Žyma, kurią atsiunčia svetainė ar API, atsiranda sąraše pati.

Etapą ir atsakingą galite keisti tiesiai sąrašo eilutėje.

## Sąrašai meniu

„Visi“ rodo visus kontaktus, naujausia veikla viršuje. Norėdami matyti tik tuos, kurie jums rašė, spauskite „Filtrai“ ir pasirinkite „Su pokalbiais“.

Po Kontaktais meniu visada yra „Visi“, „Mano“ ir „Priminimai“. Savo sąrašus kuriate mygtuku „Naujas sąrašas“:

- **Žmones pridėsiu pats:** pažymėkite žmones sąraše ir pasirinkite „Į sąrašą“.
- **Pagal filtrus:** sąrašas atsinaujina pats, pvz. visi klientai, su kuriais nekalbėjote 30 dienų. Pasirinkite filtrus ir spauskite „Išsaugoti kaip sąrašą“.

Sąrašą mato visa komanda arba tik jūs. Įmonė gali turėti iki 50 bendrų sąrašų, o kiekvienas narys iki 20 savo.

![Naujo sąrašo langas: žmones pridėsiu pats arba pagal filtrus](https://hrc.lt/screens/lt/contacts-new-list.desktop.1600.8c312321.webp)

## Sąrašas iš registro

Mygtukas „Naujas sąrašas“ turi dar dvi galimybes: „Pagal įmonių registrą“ ir „Pagal paslaugų tiekėjų registrą“. Jos užpildo naują sąrašą įmonėmis iš registro.

1. **Filtrai:** įmonėms veiklos rūšis ir miestas (įtraukti arba neįtraukti, galima kelis), darbuotojų skaičius, metinės pajamos, PVM kodas, el. paštas, telefonas ir tinklapis. Paslaugų tiekėjams paslaugų kategorija, miestas, el. paštas, telefonas ir tinklapis.
2. **Kiek rasta:** iškart matote, kiek įmonių atitinka filtrus.
3. **Duomenų pavyzdys:** parodo, kaip atrodo duomenys. Čia visada rodomos tos pačios pavyzdinės įmonės, ne jūsų paieškos rezultatai.
4. **Kiek pridėti:** įrašykite skaičių ir spauskite „Sukurti sąrašą ir pridėti“. Įmonės tampa kontaktais naujame sąraše. Langą galite uždaryti, pridėjimas tęsis.

Importuojame ir iš karto patikriname el. pašto adresus. Nemokamai, kartą per 30 d.: adreso, patikrinto per paskutines 30 d., dar kartą netikriname. Kiekvienas kontaktas gauna ženkliuką Galiojantis, Rizikingas arba Netinkamas ([El. pašto patikrinimas](#email-check)).

Skaičiuojamos tik naujai pridėtos įmonės. Jau esančios kontaktuose tik įtraukiamos į sąrašą ir nesiskaičiuoja. Nemokamai galite pridėti 100 įmonių iš viso, daugiau duoda priedas „Įmonės iš registrų“ ([Mokėjimai](https://hrc.lt/dokumentacija/paskyra/mokejimai)).

## Priminimai ir paskutinis kontaktas

Su kontaktu galite suplanuoti priminimą, skambutį arba susitikimą: laiką, trukmę, vietą arba susitikimo nuorodą ir trumpą aprašymą, pvz. „Paskambinti dėl pasiūlymo“. Vienam kontaktui galite suplanuoti kelis įrašus. Įrašas skirtas kontakto atsakingam, o jei jo nėra, tam, kas jį suplanavo.

- Sąrašas „Priminimai“ yra laiko juosta: praleisti įrašai, šiandiena su linija „Dabar“, rytojus, ši savaitė, vėliau ir neseniai atlikti ([Priminimai ir kalendorius](https://hrc.lt/dokumentacija/kontaktai/kalendorius)).
- Prie įrašo spauskite „Atlikta“ arba „Atidėti“. Jei skambutis ar susitikimas neįvyko, meniu ⋯ pasirinkite „Neįvyko“.
- Sąraše „Visi“ stulpelis „Priminimas“ rodo artimiausią įrašą, pvz. „po 2 val.“, „Rytoj 09:00“ arba „Praleista, prieš 2 d.“.
- Atėjus laikui gaunate pranešimą Telegram, jei Telegram prijungtas ir įjungta „Priminimai apie kontaktus“ ([Pranešimai](https://hrc.lt/dokumentacija/gautieji/pranesimai)).
- Suplanuotus įrašus galite matyti ir savo Google, Apple ar Outlook kalendoriuje ([Prijungti kalendorių](https://hrc.lt/dokumentacija/kontaktai/kalendorius#subscribe)).

**Paskutinis kontaktas** skaičiuojamas pats: jūsų atsakymas bet kuriuo kanalu, naujas laiškas iš kontakto puslapio arba užfiksuotas kontaktas (skambutis, susitikimas ar kita). Pastabos nesiskaičiuoja.

![Priminimų laiko juosta: praleisti įrašai, šiandiena su linija „Dabar“ ir kas laukia](https://hrc.lt/screens/lt/contacts-reminders.desktop.1600.f38888ab.webp)

## Kontakto puslapis

Viršuje matote etapą, atsakingą, žymas ir artimiausią suplanuotą įrašą, o po jais greitus veiksmus: „Rašyti laišką“, „Pastaba“, „Užfiksuoti kontaktą“, „Suplanuoti“ ir „Atidaryti pokalbį“.

- **Suplanuota:** kontakto priminimai, skambučiai ir susitikimai laiko tvarka, praleisti pirmi. Ankstesnius rodo mygtukas „Ankstesni“.
- **Veikla:** pokalbiai, pastabos, skambučiai, veikla svetainėje ir pakeitimai viename sraute, su filtrais.
- **Pastabos** matomos tik komandai.
- **Rašyti laišką** siunčia per prijungtą įmonės pašto dėžutę ([Pašto dėžutės](https://hrc.lt/dokumentacija/gautieji/pasto-dezutes)).

![Kontakto puslapis su suplanuotais įrašais, pastaba, skambučiu, pokalbiais ir laukais](https://hrc.lt/screens/lt/contact-page.desktop.1600.8755646e.webp)

## Laukai

Laukai yra jūsų įmonės informacija apie klientus, pvz. „Sutarties pabaiga“. Tipai: tekstas, skaičius, data, taip arba ne, pasirinkimas ir nuoroda. Iki 30 laukų.

Kiekvienas laukas turi raktą. Jei svetainė ar API atsiunčia reikšmę tuo pačiu raktu, ji rodoma su lauko pavadinimu. Kitos reikšmės rodomos dalyje „Kita informacija“ su šaltiniu, o „Paversti lauku“ iš jos sukuria lauką.

## Masiniai veiksmai

Pažymėkite eilutes arba „Žymėti visus“, tada keiskite etapą, atsakingą, žymas, sąrašą ar priminimą, eksportuokite arba ištrinkite. Ištrinti gali tik savininkai, ir programa prieš tai paklausia.

## El. pašto patikrinimas

Pažymėkite kontaktus arba visą sąrašą ir spauskite „Patikrinti el. paštus“. Prieš pradedant programa parodo, kiek kreditų reikės ir kiek jų turite. Jei kreditų trūksta, savininkas gali juos papildyti. Tikriname fone ir rodome eigą.

Rezultatas rodomas ženkliuku kontakto eilutėje ir kontakto puslapyje: Galiojantis, Rizikingas, Netinkamas arba Pasenęs. Patikrinimas galioja 3 mėnesius, paskui jis pasenęs. Filtras „El. pašto patikrinimas“ parodo tik kontaktus su galiojančiu adresu arba su kitu rezultatu, taip pat ir nepatikrintus. Kainos ir kreditai: [Priedai ir mokėjimai](https://hrc.lt/dokumentacija/paskyra/mokejimai).

## Duomenys iš jūsų sistemos

Planą, užsakymus ar sutarties datą galite siųsti patys:

- **Iš svetainės** su pokalbių valdiklio JS API: [Lankytojo profilis](https://hrc.lt/dokumentacija/valdiklis/lankytojo-profilis).
- **Iš savo serverio** per [REST API](https://hrc.lt/dokumentacija/ai-agentai/rest-api) arba [MCP](https://hrc.lt/dokumentacija/ai-agentai/mcp) su DI agento raktu. Reikia srities Pokalbiai ir žinutės su keitimo teise.

- **`contact_upsert`** (`/private/contact/upsert`): sukuria arba atnaujina kontaktą pagal el. paštą ar jūsų naudotojo ID. Kontaktų nesujungia.
- **`contact_event_create`** (`/private/contact/event-create`): įrašo, ką žmogus padarė jūsų sistemoje. Iki 20 įvykių per kartą, jie rodomi Veikloje.
- **`contact_set_profile`** (`/private/contact/set-profile`): keičia žinomo kontakto profilį ([Patikimi laukai](https://hrc.lt/dokumentacija/ai-agentai/rest-api#trusted-profile)).

Šios reikšmės turi šaltinį „komanda“, todėl nei svetainė, nei naršyklė jų nepakeis.

```js
// Iš jūsų serverio: sukuria arba atnaujina klientą pagal el. paštą.
// Šių reikšmių šaltinis "team".
// Naudoja hrc() iš Node.js pavyzdžio.
const { contactId, wasCreated } = await hrc('/private/contact/upsert', {
  companyId: me.companyId,
  email: 'jane@example.com',
  name: 'Jane Doe',
  company: { name: 'Acme', plan: 'Pro' },
  stage: 'customer',
  set: [
    { key: 'orders', type: 'number', value: 14 },
    { key: 'contract_end', type: 'date', value: '2027-03-31' },
  ],
  addTags: ['vip'],
});

// Ką klientas padarė jūsų sistemoje: rodoma Veikloje.
await hrc('/private/contact/event-create', {
  companyId: me.companyId,
  contactId,
  events: [
    {
      name: 'order-placed',
      props: [{ key: 'total', type: 'number', value: 1240 }],
    },
  ],
});
```

DI agentai per MCP taip pat randa ir skaito kontaktus, keičia etapą ir atsakingą, rašo pastabas, nustato priminimus ir tvarko sąrašus. Ištrinti kontaktų, žymų, sąrašų ir laukų jie negali.