Як налаштувати відображення полів у картці клієнта?

Два входи до тих самих налаштувань видимості: (1) сторінка Поля клієнтів — там же визначення полів і одна кнопка «Зберегти» в заголовку на все; (2) цей пункт меню «Редактор полів у картці клієнта» (/settings-page/op-settings/client-fields) — лише блок видимості (перемикачі + JSON), збереження верхньою кнопкою «Зберегти» в макеті op-settings. На сторінці op-settings є посилання повернутися до Полів клієнтів, якщо потрібно змінити схему полів.

Налаштування відображення полів дозволяє обрати, які поля показувати операторам у картці клієнта та в таблиці клієнтів. Кастомні поля мають бути визначені, щоб з’явитися в списку видимості.

Коли знадобиться

Потрібно приховати або показати стандартні поля (телефон, ім’я, тип клієнта тощо).
Потрібно показати кастомні поля, створені в «Поля клієнтів».
Треба змінити порядок відображення полів у картці клієнта.

Що важливо знати

Видимість можна змінити і на Поля клієнтів (зручно, коли редагуєте поля й видимість разом). Ця сторінка потрібна, коли змінюєте лише видимість або звикли до меню op-settings. Кастомні поля мають існувати в конфігурації, інакше їх не буде серед перемикачів.
Стандартні поля — нативні колонки OpClients: phone, bot_id, bot_name, fullName (від full_name). Їх можна лише показувати або приховувати. Поля clientType, whiteLabel у прикладі — можуть бути кастомними в extra_data або застарілими.
Формат JSON — кожен ключ = назва поля, значення true = показувати, false = приховувати. Порядок ключів визначає порядок відображення.

Перед початком

Ви увійшли в систему з правами адміністратора або супервайзера.
У вас є права на збереження налаштувань операторської панелі (canSave для секції settings).
Для кастомних полів: вони вже додані в «Поля клієнтів» (або ви керуєте видимістю лише стандартних полів).

Покрокова інструкція

1. Відкрити редактор полів картки клієнта

Перейдіть до модуля Налаштування через меню або за адресою /settings-page.
У бічному меню знайдіть розділ «Налаштування» (операторська панель) та розгорніть його.
Натисніть на пункт «Редактор полів у картці клієнта» (/settings-page/op-settings/client-fields).

2. Зрозуміти формат JSON

Конфігурація — це JSON-об’єкт. Ключ = назва поля, значення = показувати (true) чи приховувати (false):

{
  "phone": true,
  "bot_id": true,
  "bot_name": true,
  "fullName": true
}

Нативні поля OpClients (доступні без створення):

phone — телефон
bot_id — ID бота
bot_name — назва бота (з join)
fullName — повне ім’я (колонка full_name)

Примітка: У прикладі на сторінці можуть бути clientType, whiteLabel — це кастомні поля в extra_data або застарілі ключі. Їх потрібно створювати в «Поля клієнтів», якщо вони використовуються.

Кастомні поля — додайте ключі полів, створених у «Поля клієнтів», зі значенням true для показу.

3. Налаштувати відображення

Використайте перемикачі та/або JSON видимості (як у блоці на сторінці «Поля клієнтів»).
Натисніть «Зберегти» у верхній частині екрана налаштувань операторської панелі (зберігаються зміни в налаштуваннях op-settings, зокрема client_card_fields).

4. Використання вкладених об’єктів (extra_data)

Для окремих кастомних полів з extra_data можна використовувати вкладений об’єкт з прапорцем extra_data_flag. Деталі — у підказці на сторінці.

Що відбувається після

Налаштування зберігаються в client_card_fields (OpSettings).
Оператори бачать лише обрані поля в картці клієнта та в таблиці клієнтів.
Порядок полів відповідає порядку ключів у JSON.

Як переконатися, що все вдалось

Відкрийте картку клієнта в операторській панелі та перевірте, що відображаються лише обрані поля.
Перевірте таблицю клієнтів у модулі Broadcast.

Пов'язані матеріали

Поля клієнтів — об’єднана сторінка (актуальний режим)
Налаштувати операторів
Налаштувати чати

Важливі примітки

⚠️ Кастомні поля: спочатку визначте їх у «Поля клієнтів», якщо це ще не зроблено на вашому інстансі.
💡 JSON має бути валідним: перевірте синтаксис (коми, дужки).
💡 Якщо JSON порожній або невалідний, використовується стандартне відображення за замовчуванням.