# Контакти і списки

> Проста CRM у розділі «Контакти»: додавання та імпорт CSV, етапи, мітки, списки в меню, нагадування, поля й дані з вашої системи через API.

Розділ «Контакти» це проста CRM для вашої команди. Тут усі, з ким ви спілкуєтеся, з етапом, відповідальним, мітками, полями, нотатками й нагадуваннями.

![Список контактів з етапами, мітками, нагадуваннями та списками в меню](https://hrc.lt/screens/uk/contacts-list.desktop.2400.eee4dab5.webp)

## Як з'являються контакти

- **Самі.** Коли хтось пише через чат-віджет чи ел. поштою, або ваш сайт його розпізнає.
- **Вручну.** Кнопка «Новий контакт». Досить імені або ел. пошти. Якщо така пошта вже належить контакту, застосунок покаже його й не створить другий.
- **З CSV-файлу.** Кнопка «Імпорт CSV», див. нижче.
- **Через API.** З вашої системи, див. [Дані з вашої системи](#api).

Введена вручну ел. пошта пов'язується з контактом, тож відповідь людини на ваш лист потрапляє до того самого контакту. Така адреса залишається непідтвердженою, доки людина не відповість на ваш лист.

## Імпорт і експорт

«Імпорт CSV» має чотири кроки:

1. **Файл:** `.csv` до 5 МБ і 5000 рядків. Роздільник (`,`, `;` або табуляція) і кодування визначаються самі.
2. **Стовпці:** для кожного стовпця виберіть, куди його записати: ім'я, ел. пошта, телефон, компанія, етап, мітки, нотатка, ваше поле або нові дані. Звичні назви розпізнаються п'ятьма мовами.
3. **Налаштування:** що робити, якщо контакт уже є (оновити чи пропустити), і яку мітку, список, етап чи відповідального дати всім імпортованим. До імпорту видно, скільки буде нових, наявних і пропущених.
4. **Імпорт:** перебіг і результат. Пропущені рядки з причиною можна завантажити.

![Імпорт CSV: стовпці файлу зіставлені з полями контакту](https://hrc.lt/screens/uk/contacts-import.desktop.1600.90e95590.webp)

Експорт: меню ⋯, «Експорт CSV». У файлі видимі стовпці, ел. пошта й телефон, до 10 000 рядків. Файл відкривається в Excel.

## Етап, відповідальний і мітки

- **Етап:** Потенційний клієнт, Спілкуємося, Клієнт, Колишній клієнт, Не підходить або Без етапу.
- **Відповідальний:** один учасник команди. У списку «Мої» ваші контакти.
- **Мітки:** короткі назви з кольором, наприклад «VIP». Мітками керують у меню ⋯, «Мітки». Мітка, яку надсилає сайт чи API, додається до списку сама.

Етап і відповідального можна змінити просто в рядку списку.

## Списки в меню

«Усі» показує всі контакти, згори найсвіжіша активність. Щоб бачити лише тих, хто вам писав, відкрийте «Фільтри» й виберіть «З розмовами».

Під «Контактами» в меню завжди є «Усі», «Мої» й «Нагадування». Власні списки створюються кнопкою «Новий список»:

- **Додам людей сам:** позначте людей у списку й виберіть «До списку».
- **За фільтрами:** список оновлюється сам, наприклад усі клієнти, з якими ви не спілкувалися 30 днів. Виберіть фільтри й натисніть «Зберегти як список».

Список бачить уся команда або лише ви. Компанія може мати до 50 спільних списків, а кожен учасник до 20 власних.

![Вікно нового списку: додам людей сам або за фільтрами](https://hrc.lt/screens/uk/contacts-new-list.desktop.1600.442f4694.webp)

## Список із реєстру

Кнопка «Новий список» має ще два варіанти: «За реєстром компаній» і «За реєстром постачальників послуг». Вони заповнюють новий список компаніями з реєстру.

1. **Фільтри:** для компаній вид діяльності й місто (включити або виключити, можна кілька), кількість працівників, річний дохід, код ПДВ, ел. пошта, телефон і сайт. Для постачальників послуг категорія послуг, місто, ел. пошта, телефон і сайт.
2. **Скільки знайдено:** одразу видно, скільки компаній відповідає фільтрам.
3. **Приклад даних:** показує, який вигляд мають дані. Тут завжди показано ті самі зразкові компанії, а не результати вашого пошуку.
4. **Скільки додати:** введіть число й натисніть «Створити список і додати». Компанії стають контактами в новому списку. Вікно можна закрити, додавання триватиме.

Ми імпортуємо й одразу перевіряємо адреси e-mail. Безкоштовно, раз на 30 днів: адресу, перевірену за останні 30 днів, повторно не перевіряємо. Кожен контакт отримує значок Дійсний, Ризикований або Недійсний ([Перевірка e-mail](#email-check)).

Рахуються лише нові додані компанії. Ті, що вже є в контактах, лише потрапляють до списку й не рахуються. Безкоштовно можна додати 100 компаній загалом, більше дає додаток «Компанії з реєстрів» ([Оплата](https://hrc.lt/uk/docs/account/billing)).

## Нагадування й останній контакт

З контактом можна запланувати нагадування, дзвінок або зустріч: час, тривалість, місце або посилання на зустріч і короткий опис, наприклад «Зателефонувати щодо пропозиції». Для одного контакту можна запланувати кілька записів. Запис призначено відповідальному за контакт, а якщо його немає, тому, хто його запланував.

- Список «Нагадування» це стрічка за часом: пропущені записи, сьогодні з лінією «Зараз», завтра, цей тиждень, пізніше й нещодавно виконані ([Нагадування і ваш календар](https://hrc.lt/uk/docs/contacts/calendar)).
- Біля запису натисніть «Виконано» або «Відкласти». Якщо дзвінок чи зустріч не відбулися, оберіть «Не відбулося» в меню ⋯.
- У списку «Усі» колонка «Нагадування» показує найближчий запис, наприклад «через 2 год», «Завтра 09:00» або «Пропущено, 2 дн. тому».
- Коли настає час, приходить сповіщення в Telegram, якщо Telegram під'єднано й увімкнено «Нагадування про контакти» ([Сповіщення](https://hrc.lt/uk/docs/inbox/notifications)).
- Заплановані записи можна бачити й у своєму календарі Google, Apple чи Outlook ([Під'єднати календар](https://hrc.lt/uk/docs/contacts/calendar#subscribe)).

**Останній контакт** рахується сам: ваша відповідь у будь-якому каналі, новий лист зі сторінки контакту або записаний контакт (дзвінок, зустріч чи інше). Нотатки не рахуються.

![Стрічка нагадувань: пропущені записи, сьогодні з лінією «Зараз» і що попереду](https://hrc.lt/screens/uk/contacts-reminders.desktop.1600.3f660df8.webp)

## Сторінка контакту

Угорі видно етап, відповідального, мітки й найближчий запланований запис, а під ними швидкі дії: «Написати лист», «Нотатка», «Записати контакт», «Запланувати» й «Відкрити розмову».

- **Заплановано:** нагадування, дзвінки й зустрічі контакту за часом, пропущені першими. Минулі показує кнопка «Раніше».
- **Активність:** розмови, нотатки, дзвінки, активність на сайті й зміни в одній стрічці, з фільтрами.
- **Нотатки** бачить лише команда.
- **Написати лист** надсилає через під'єднану поштову скриньку компанії ([Поштові скриньки](https://hrc.lt/uk/docs/inbox/mailboxes)).

![Сторінка контакту із запланованими записами, нотаткою, дзвінком, розмовами й полями](https://hrc.lt/screens/uk/contact-page.desktop.1600.6a8562d8.webp)

## Поля

Поля це дані вашої компанії про клієнтів, наприклад «Кінець договору». Типи: текст, число, дата, так чи ні, вибір і посилання. До 30 полів.

Кожне поле має ключ. Якщо сайт чи API надсилає значення з тим самим ключем, воно показується з назвою поля. Інші значення видно в блоці «Інші дані» з джерелом, а «Зробити полем» перетворює значення на поле.

## Масові дії

Позначте рядки або «Позначити всіх», потім змініть етап, відповідального, мітки, список чи нагадування, експортуйте або видаліть. Видаляти можуть лише власники, і застосунок спершу запитає.

## Перевірка e-mail

Позначте контакти або весь список і натисніть «Перевірити e-mail». Перед початком застосунок покаже, скільки кредитів потрібно і скільки їх у вас. Якщо кредитів бракує, власник може їх поповнити. Перевірка йде у фоні й показує поступ.

Результат видно значком у рядку контакту і на сторінці контакту: Дійсний, Ризикований, Недійсний або Застаріла. Перевірка діє 3 місяці, потім вона застаріває. Фільтр «Перевірка e-mail» показує лише контакти з дійсною адресою або з іншим результатом, зокрема Не перевірено. Ціни й кредити: [Додатки й оплата](https://hrc.lt/uk/docs/account/billing).

## Дані з вашої системи

Тариф, замовлення чи дату договору можна надсилати самим:

- **Із сайту** через JavaScript API чат-віджета: [Профіль відвідувача](https://hrc.lt/uk/docs/widget/visitor-profile).
- **Зі свого сервера** через [REST API](https://hrc.lt/uk/docs/ai-agents/rest-api) або [MCP](https://hrc.lt/uk/docs/ai-agents/mcp) з ключем AI-агента. Потрібна область «Розмови й повідомлення» з правом зміни.

- **`contact_upsert`** (`/private/contact/upsert`): створює або оновлює контакт за ел. поштою чи ID користувача на вашому сайті. Контакти не об'єднує.
- **`contact_event_create`** (`/private/contact/event-create`): записує, що людина зробила у вашій системі. До 20 подій за раз, їх видно в «Активності».
- **`contact_set_profile`** (`/private/contact/set-profile`): змінює профіль відомого контакту ([Надійні поля](https://hrc.lt/uk/docs/ai-agents/rest-api#trusted-profile)).

Ці значення мають джерело «команда», тож ні сайт, ні браузер їх не змінять.

```js
// З вашого сервера: створює або оновлює клієнта за ел. поштою.
// Ці значення мають джерело "team".
// Використовує hrc() з прикладу Node.js.
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'],
});

// Що клієнт зробив у вашій системі: видно в Активності.
await hrc('/private/contact/event-create', {
  companyId: me.companyId,
  contactId,
  events: [
    {
      name: 'order-placed',
      props: [{ key: 'total', type: 'number', value: 1240 }],
    },
  ],
});
```

Через MCP AI-агенти також знаходять і читають контакти, змінюють етап і відповідального, пишуть нотатки, ставлять нагадування й ведуть списки. Видаляти контакти, мітки, списки й поля вони не можуть.