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

Два входи до тих самих налаштувань видимості: (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. Відкрити редактор полів картки клієнта

  1. Перейдіть до модуля Налаштування через меню або за адресою /settings-page.
  2. У бічному меню знайдіть розділ «Налаштування» (операторська панель) та розгорніть його.
  3. Натисніть на пункт «Редактор полів у картці клієнта» (/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. Налаштувати відображення

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

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

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

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

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

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

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

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

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

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