Типи даних і поля
«Типи даних» — місце, де ви самі вирішуєте, з яких полів складаються клієнт, угода, товар, завдання, додатковий контакт і операція «Фінансів»: які поля є, які обов'язкові, що видно в списку, у формі створення й у картці, і в якому порядку. Змінили тут — і одразу бачите це в розділі, на телефоні, в імпорті та в тому, що читає ШІ, без жодної правки коду.
На цій сторінці
Можливості
- Одна таблиця на тип: вбудовані поля (ID, назва, телефон, етап…) разом із вашими власними.
- Власні поля восьми типів: «Рядок», «Цифри», «Дата», «Час», «Так/Ні», «Список», «Гіперпосилання», «Текст»; для «Рядка» і «Списку» — мультивибір.
- «Текст» — для довгих записів (умови, інструкції, коментарі): у картці показується з абзацами й «Розгорнути», редагується шторкою збоку з підказкою поля; у формах поле росте разом із текстом.
- «Обов'язкове поле» діє насправді: без значення запис не збережеться ні вручну, ні через API, ні у ШІ.
- «Вивести в списку», «Вивести при створенні», для угод — «Вивести в угоді», для товарів — «Вивести в угоді» і «Вивести в накладних».
- Порядок перетягуванням, блоки картки з перейменуванням.
- Поле угоди лише для вибраних воронок.
- Поле клієнта також у картці угоди й у завданні.
- Контроль унікальності, показ дублів, поле у фільтрі списку.
1Налаштування
Дорога: Налаштування›Типи даних«Налаштування → Типи даних» і тип: «Клієнти», «Угоди», «Товари», «Завдання», «Дод. контакти», «Фінанси» (поля операції: «Вивести при створенні» — шторка «Новий платіж», «Вивести в списку» — колонка журналу; стаття «Фінанси», розділ 1б). Поля власних розділів — Налаштування›Типи даних›Власні розділи«Налаштування → Типи даних → Власні розділи» (стаття «Власні розділи»).
Швидкий шлях із самого розділу: ⋮›Налаштувати поля«⋮ → Налаштувати поля» у «Клієнтах», «Угодах», «Завданнях», «Товарах» і у власних розділах; у картці угоди — ⋮›Налаштувати поля угоди«⋮ → Налаштувати поля угоди». Пункт видно адміністратору.
На сторінці типу — пошук полів, таблиця з колонками «Увімкнено», «Назва», «Тип поля», «Обов'язкове поле», «Вивести в списку», «Вивести при створенні», «Блок», «ID» і «⋮» поля, внизу — сторінки, «Рядків на сторінці» (25 / 50 / 100) і «Всього». У «Завданнях» над полями ще таблиця «Типи завдань» (стаття «Довідники»).
Змінювати поля може людина з доступом до налаштувань (адміністратор або з галочкою «Налаштування CRM»).
2Додати своє поле
- Натисніть «Додати» під таблицею або ⋮›Додати поле«⋮ → Додати поле» вгорі.
- У шторці «Користувацьке поле» заповніть «Назва », «Тип поля », «Блок *» (або «+ Новий блок…»).
- Для «Списку» введіть «Варіанти списку *» по одному, кожен — клавішею Enter.
- За потреби задайте «Значення за замовчуванням» — воно підставиться в новий запис.
- Для полів клієнта є «Також відображати у розділах»: «Угоди» (внизу «Даних угоди» блоком «Поля клієнта» і колонкою в списку угод) і «Завдання» (у шторці завдання, у блоці про клієнта).
- Поставте потрібні прапорці (розділ 3) і натисніть «Зберегти».
Ключ поля (латиницею) створюється з назви сам і видно в колонці «ID»; нове поле угоди одразу стоїть у картці.
3Прапорці: обов'язкове, у списку, при створенні, в угоді
| Прапорець | Що робить |
|---|---|
| «Обов'язкове поле» | Без значення запис не створиться; наявне значення не можна стерти |
| «Вивести в списку» | Колонка в таблиці розділу |
| «Вивести при створенні» | Поле у шторці нового запису («Нова угода», «Новий клієнт»…) |
| «Вивести в угоді» (угоди) | Рядок у «Даних угоди» картки, на місці за порядком таблиці |
| «Вивести в угоді» (товари) | Колонка у вікні «Додати товар зі складу» |
| «Вивести в накладних» (товари) | Зберігається для шаблонів документів |
| «Видно колегам» (люди) | Поле в картці людини в «Структурі»; без галочки — лише сама людина й адміністратор (стаття Люди: картки й анкети) |
| «Додати у фільтр» | Фільтр за цим полем у списку розділу |
| «Дозволити мультивибір» | Кілька значень для «Рядка» або кілька варіантів для «Списку» |
Прапорці в рядку таблиці зберігаються одразу після кліку. Якщо поле приховане при створенні, обов'язковість при створенні не вимагається.
3аПідказка поля
Підказка — одне речення під полем у формі створення: що станеться або звідки значення («Без клієнта угоду не збережуть. Новий створиться сам.»). Її бачать усі, хто заповнює форму, і ШІ-співробітники в описі розділу, тому людина й ШІ заповнюють поле однаково.
- Колонка «Підказка (бачать люди і ШІ)» — клацніть по тексту в рядку поля, напишіть і натисніть Enter (Esc — скасувати). До 300 знаків.
- У вбудованих полів (ID, Назва, Телефон, Клієнт…) уже є типова підказка; її можна змінити або стерти, а кнопка «Типова» повертає її.
- У шторці власного поля — поле «Підказка» під назвою.
- У формах розділів (угода, клієнт, контакт, завдання, товар, платіж, запис власного розділу) підказка з'являється під полем, коли воно у фокусі або під курсором; на телефоні — завжди. Порожня підказка — рядка нема.
- Пишіть наслідок, а не повтор назви: не «Телефон клієнта», а «За номером шукаються клієнт, дублі й переписки».
3бВибрати поля для «Головного» картки
Клієнт, товар і завдання показують угорі картки блок «Головне» — до восьми полів, які дивляться щодня. Решта полів не зникає: вони стоять у згорнутих групах із назвами за змістом («Повідомлення клієнту», «Для ШІ», «Реквізити», «Додаткові поля»…), і кожна група відкривається одним натиском.
Картка угоди з 02.11.2026 показує всі поля одним списком «Дані угоди», без «Головного» й груп, — у порядку цієї сторінки. Позначки «У головному» і «Група в картці» для угоди зберігаються й діють для ШІ й ролей, але картка угоди їх не використовує.
- Відкрийте Налаштування›Типи даних›Угоди«Налаштування → Типи даних → Угоди» (або «Клієнти», «Товари», «Завдання»).
- Поставте або зніміть галочку «У головному» в рядку поля — картка зміниться одразу для всіх.
- У колонці «Група в картці» впишіть назву групи, де поле стоятиме поза «Головним», і натисніть Enter; можна вибрати наявну групу зі списку.
- Щоб повернути типову групу, зітріть назву й натисніть Enter.
| Розділ | Типово в «Головному» |
|---|---|
| Угода | Клієнт (з телефоном), Етап, Сума, Доставка / ТТН, Головний відповідальний, Джерело, Дата завершення |
| Клієнт | Назва компанії, Номери телефонів, Сегмент, Головний відповідальний, Джерело, Остання угода, Сума угод, Теги |
| Товар | Назва, Артикул, Папка, Ціна, Собівартість, В наявності, Од. виміру, Бренд |
| Завдання | Назва, Статус, Головний відповідальний, Дата завершення, Пріоритет, Угода / клієнт, Тип, Коментар |
- Типову групу власного поля Helomi бере з назви: «Відправка пов. …» — «Повідомлення клієнту», «Коментар для ШІ…» — «Для ШІ», «Юридична адреса», «Код ЄДРПОУ», «Рахунок», «Накладна» — «Реквізити», поля з оплатою — «Оплата», з доставкою — «Доставка», решта — «Додаткові поля». Поле зі своїм блоком (не «Додаткові поля») стоїть у групі з назвою блоку.
- Над таблицею видно, скільки полів зараз у «Головному». Типово їх не більше восьми; більше можна, але тоді картку доведеться гортати.
- У «Головному» поля стоять у типовому порядку розділу, а додані вами — після них, у порядку таблиці. Порядок таблиці керує ще й колонками списку.
- Які групи розгорнуті, кожен вирішує для себе: розгорнута група лишається розгорнутою на всіх ваших пристроях.
Поле, яке заповнюють рідко, краще лишити в групі: у заголовку групи видно, скільки полів заповнено («Реквізити · 2 з 5»), а порожні з'являються за «Показати порожні».
4Порядок і блоки
- Тягніть рядок за «↕» — порядок спільний для вбудованих і власних полів і однаковий у списку, формі створення й картці. Під час пошуку перетягування вимкнене.
- ⋮›Перейменувати блок…«⋮ → Перейменувати блок…» вгорі сторінки змінює назву блоку картки для всіх його полів.
5Системні поля із замком
Вбудовані поля мають позначку «системне». Їх не можна видалити чи змінити тип; прапорці, без яких запис не існує (наприклад «Увімкнено» в ID, назви, клієнта, етапу, воронки угоди), заблоковані й сірі. Прочерк «—» означає, що для цього поля прояву нема (наприклад, колонки в шторці). Решту прапорців вбудованих полів можна вмикати й вимикати, а рядки — переставляти.
6Поле лише для окремих воронок
Для угоди, коли воронок більше однієї, у шторці поля є «Воронки продажів»: «Усі воронки» (і ті, що з'являться згодом) або «Лише вибрані». Картка й «Нова угода» показують поле тільки у вибраних воронках; у таблиці це видно в колонці «Воронка продажів». Імпорт і ШІ можуть записати таке поле в будь-яку угоду.
7Унікальність і дублі
- «Контроль унікальності» — те саме значення в іншого запису не збережеться. Якщо дублі вже є, система попередить і запропонує ввімкнути все одно.
- «Відобразити дублі» — у «⋮» поля з'явиться «Показати дублі»: список повторюваних значень із номерами записів.
8Вимкнути або видалити поле
- Зніміть «Увімкнено» — поле зникне з карток, списків і фільтрів, значення збережуться.
- ⋮›Видалити«⋮ → Видалити» прибирає поле разом з усіма значеннями після підтвердження; дані не відновити. Поля, що прийшли з імпорту KeepinCRM, лише вимикаються.
- Зміна типу не перетворює старі значення: вони лишаються текстом і можуть показуватися некоректно.
На телефоні рядок таблиці стає карткою: назва з «↕» і «⋮», під нею тип, блок і ID, далі пігулки прапорців.
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «Потрібна назва поля» | Порожня «Назва» | Впишіть назву |
| «Для списку потрібні варіанти: введіть варіант і натисніть Enter» | Тип «Список» без варіантів | Додайте хоча б один варіант |
| «Поле «…» у цій сутності вже є» | Така назва вже зайнята | Дайте іншу назву |
| «Увімкнути унікальність не можна: є N повторюваних значень…» | Дублі вже є | «Показати дублі», виправте або підтвердіть примусово |
| «Системне поле (з імпорту) не видаляється — лише архівується» | Поле прийшло з KeepinCRM | Зніміть «Увімкнено» |
| «Виберіть хоча б одну воронку або «Усі воронки»» | «Лише вибрані» без жодної воронки | Позначте воронку |
| «Заповніть обов'язкове поле «…»» (у розділі) | Поле позначено обов'язковим | Заповніть його або зніміть прапорець тут |
Для ШІ-співробітників
- Поля кожного розділу з прапорцями й варіантами —
describe_section("<key>")(deals,clients,tasks,products, slug власного розділу). Обов'язкові поля діють для ШІ так само, як для людини: запис без них повертає помилку з назвою поля. - Власні поля в запитах передаються в об'єкті
customза ключем поля. - У кожного поля в
describe_sectionєhint— та сама підказка, що людина бачить під полем: заповнюйте поле так, як вона каже. - Поля угоди, клієнта, товару й завдання мають ще
main(поле в «Головному» картки) іgroup(згорнута група картки) — так ШІ знає, що людина бачить одразу, а що в групах. Змінює їх лише людина в «Типах даних». - Змінювати поля вбудованих розділів і розділів людей ШІ не може: «Налаштування CRM» для ШІ закриті завжди. З правом творця «Свої розділи» ШІ читає поля будь-якого розділу (
fields_list) і змінює лише поля своїх розділів (fields_create,fields_update,fields_builtin_update,fields_delete— видалення чекає підтвердження людини). Докладно — стаття «ШІ-творець».
Додаткова інформація
- Пов'язані статті: Угоди, Клієнти, Завдання, Склад і товари, Воронки, етапи, переходи, Власні розділи, Налаштування: огляд.
- Тип «Формула» є в коді для полів товарів (варіант Prom), але в шторці його вибрати не можна.
Цю саму статтю читають ШІ-співробітники Helomi: help("settings-fields")