Про Custom Data в ConnectiveOne
Custom Data — це ваші власні таблиці всередині платформи. Ви створюєте структуру (колонки: місто, адреса, телефон…), заповнюєте дані вручну або імпортом з CSV/Excel — і бот може читати з них, шукати, зберігати нові записи. Це альтернатива зовнішнім таблицям (Google Sheets, Excel), які потрібно інтегрувати окремо.
Для чого це потрібно:
- Список магазинів з адресами — клієнт обирає місто, бот показує магазини
- Рейтинги після діалогу (C-SAT) — зберігаєте в таблицю, дивитеся в дашбордах
- Заявки на зворотний дзвінок — клієнт залишає контакти, оператор бачить список
- Категорії товарів, VIP-списки, будь-які довідники
Основні концепції
Таблиця (модель)
Таблиця — це як лист у Excel: у вас є колонки (поля) і рядки (записи). Ви самі визначаєте, які колонки потрібні: місто, адреса, телефон, дата тощо. В інтерфейсі це називається «модель» — технічна назва тієї самої таблиці.
Як це працює:
- Ви створюєте таблицю: даєте назву (наприклад, «Магазини») і додаєте колонки
- Для кожної колонки обираєте тип: текст, число, дата
- Заповнюєте дані — вручну або імпортом з CSV/Excel
- Таблиця з'являється в боті: сценарій може читати з неї і записувати нові рядки
Приклад: таблиця «Магазини» з колонками: місто, адреса, телефон, графік роботи
Типи колонок (полів)
Для кожної колонки обираєте тип даних:
- Текст короткий — назви, коди, телефони (до 255 символів)
- Текст довгий — коментарі, описи (без обмежень)
- Число — кількість, оцінка, ID
- Дата — дата події, термін
- Зв'язок з іншою таблицею — вибір значення зі списку (наприклад, пріоритет з таблиці «Пріоритети»)
Порада: для пошуку краще короткий текст; довгий текст — тільки для коментарів.
Рядки (записи)
Рядок — це один запис у таблиці: наприклад, один магазин з усіма даними (місто, адреса, телефон). В технічній документації це називають «запис».
Як бот зберігає нові рядки:
- Клієнт вводить дані в діалозі (наприклад, рейтинг або контакт для зворотного дзвінку)
- Сценарій збирає ці дані
- Дія «створити запис» додає новий рядок у вашу таблицю
- Дані з'являються в Custom Data і можуть використовуватися далі (дашборди, оператори)
Зв'язки між таблицями
Можна зробити так, щоб при додаванні рядка в одну таблицю ви обирали значення з іншої. Наприклад: таблиця «Завдання» має колонку «Пріоритет», і ви обираєте зі списку «Високий», «Середній», «Низький» з таблиці «Пріоритети». Це потрібно для складніших структур; для простих довідників можна обійтися без зв'язків.
Складні кейси
Custom Data підтримує й складніші налаштування: приховування полів, валідацію, графіки статистики, кольорову підсвітку рядків, карту або слайдер фото у модальному вікні. Якщо ваш бізнес-процес потребує такого — дивіться Складні кейси Custom Data та довідник розширених налаштувань.
Додаткові поля до картки клієнта
Можна додати до картки клієнта свої поля (дата народження, номер картки лояльності тощо). Для нових проєктів краще використовувати Client Fields (Налаштування → Поля клієнта) — це простіший спосіб. Custom Data з розширенням контактів — для існуючих проєктів, де це вже налаштовано.
Як зберігати дані з бота
Є два способи:
Автоматично — клієнт вводить дані в діалозі, і вони зберігаються в таблицю. Підходить для простих сценаріїв (наприклад, один рейтинг). Детальніше: Як зберегти дані зі сценарію
Через дії в сценарії — клієнт вводить кілька полів (назва, дата, контакт), а потім ви зберігаєте їх разом. Підходить для заявок, опитувань з кількома питаннями.
Для більшості задач достатньо стандартних дій: створити запис, знайти запис, оновити. Складні інтеграції (CRM, інші системи) потребують розробки — але це вже окрема історія.
Що це дає
- Свої таблиці в платформі — ви створюєте структуру, імпортуєте, бот працює
- Бот читає і пише — сценарій показує дані клієнту, шукає і зберігає нові рядки
- Імпорт з Excel/CSV — можна завантажити готовий список замість ручного введення
Поради
- Спочатку подумайте про колонки — які дані потрібні? Місто, адреса, телефон, дата? Краще продумати наперед, ніж переробляти пізніше.
- Для пошуку — короткий текст — якщо бот буде шукати за полем (наприклад, email або місто), краще використовувати короткий текст, а не довгий.
- Додайте унікальне поле — email, телефон або ID, щоб можна було однозначно знайти запис.
- Спочатку просте — для перших таблиць не потрібні зв'язки між таблицями. Простий список магазинів або рейтингів — достатньо.
- AI Magic — можна описати текстом, що потрібно, і система запропонує структуру таблиці.
Пов'язані документи
- Патерни та приклади: Патерни та приклади Custom Data — типові сценарії використання
- Складні кейси: Складні кейси Custom Data — графіки, валідація, підсвітка, карта
- Довідник опцій: Розширені налаштування моделей — повний перелік опцій
- Integrator Hub: Навігація по всіх інструкціях — центральна сторінка для інтеграторів
- How-to: Створити модель — інструкція зі створення моделі
- How-to: Зберегти дані зі сценарію — як зберігати дані автоматично
- How-to: Використати custom_modules__set — створення запису через action
- How-to: Використати custom_modules__get — отримання запису
- How-to: Створити зв'язок між таблицями — організація структурованих даних
- How-to: Розширити контакти клієнтів — додавання полів до таблиці Clients
- Reference: Довідник термінів — визначення термінів Custom Data, Модель, Поле, Запис