NB TGSHOP — Інструкція з налаштування

🚀

Початок роботи

Вхід в адмін-панель

Перейдіть за посиланням адмін-панелі вашого магазину

Введіть логін та пароль, які вам надав адміністратор

Натисніть «Увійти» — ви потрапите на Дашборд

Інтерфейс адмін-панелі

Панель складається з двох частин:

Бокове меню (Sidebar) — навігація між розділами: Дашборд, Категорії, Товари, Замовлення та інші
Основна область — контент обраного розділу з таблицями, формами та фільтрами

Ролі користувачів

Адміністратор — має повний доступ до управління товарами, замовленнями, клієнтами, контентом та налаштуваннями магазину.

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

📊

Дашборд

Статистичні карточки

У верхній частині Дашборду ви побачите ключові показники:

Товари / Ліміт Категорії Замовлення Клієнти / Ліміт Адміни / Ліміт

Графік продажів

Інтерактивний графік показує суми оплачених та неоплачених замовлень, а також кількість замовлень за період.

Доступні періоди:

7 днів Місяць 30 днів 90 днів Рік

Останні замовлення

Таблиця з 5 останніми замовленнями: номер, клієнт, статус, сума та дата. Швидкий доступ до актуальних замовлень без переходу в розділ.

📁

Категорії

Створення категорії

Натисніть «Додати категорію»

Введіть назву — Slug (URL-ідентифікатор) створюється автоматично

Оберіть батьківську категорію (якщо потрібна підкатегорія)

Увімкніть «Відображати на головному екрані», якщо хочете показати категорію на головній сторінці міні-додатку

Завантажте зображення (буде автоматично конвертовано у формат WebP)

Натисніть «Зберегти»

Ієрархія (дерево категорій)

Категорії відображаються у вигляді дерева з рівнями вкладеності. Використовуйте кнопки «Розгорнути дерево» / «Згорнути дерево» для зручної навігації.

Функція «Переміщення гілки» дозволяє перемістити категорію разом з усіма дочірніми категоріями в інше місце дерева.

Імпорт / Експорт

Імпорт: Завантажте файл CSV або XLSX з колонками:

Колонка	Опис	Обов'язкова
`category_name`	Назва категорії	Так
`category_name_parent`	Назва батьківської категорії	Ні
`link_image`	Посилання на зображення	Ні

Експорт: Натисніть «Експортувати Excel» — завантажиться файл з усіма категоріями.

📦

Товари

Типи товарів

Тип	Коли використовувати
Звичайний	Товар без варіацій — один артикул, одна ціна
Варіативний	Товар з варіаціями (розмір, колір тощо) — кожна варіація має свій артикул, ціну та зображення

Створення звичайного товару

Натисніть «Додати товар» та оберіть тип «Звичайний»

Заповніть: Артикул, Назва, Категорія, Ціна

За потреби вкажіть Акційну ціну (буде показана як знижка)

Оберіть Наявність та позначте «Популярний», якщо потрібно

Завантажте зображення товару

Додайте опис у візуальному редакторі (підтримується форматування тексту)

Натисніть «Зберегти»

Варіативний товар

Для варіативного товару додайте варіації — кожна з власним:

Артикулом варіації
Назвою (наприклад: «Червоний / L»)
Ціною та акційною ціною
Наявністю
Зображенням (опціонально)

Артикул батьківського товару (article_parent) об'єднує всі варіації в одну картку товару в міні-додатку.

Характеристики товару

У формі товару ви можете прив'язати характеристики (атрибути). Оберіть атрибут зі списку та введіть значення. Характеристики відображаються на сторінці товару в міні-додатку.

Імпорт / Експорт товарів

Експорт: Натисніть «Експортувати Excel» — завантажиться повна таблиця товарів.

Імпорт: Завантажте файл CSV або XLSX з колонками:

Колонка	Опис
`article_parent`	Артикул батьківського товару (для варіацій)
`article`	Артикул товару/варіації
`name`	Назва
`category`	Назва категорії
`price`	Ціна
`sale_price`	Акційна ціна
`stock`	Наявність (1/0)
`popular`	Популярний (1/0)
`description`	Опис товару
`label_variant`	Назва варіації
`image`	Посилання на зображення
`attr:slug`	Значення характеристики (наприклад: attr:color)

Для великих файлів автоматично використовується чанковий імпорт з прогрес-баром — не закривайте сторінку під час завантаження.

🏷️

Характеристики

Керування атрибутами

Перейдіть в розділ «Характеристики»

Натисніть «Додати» та введіть назву атрибуту (наприклад: Колір, Розмір, Матеріал)

Slug створюється автоматично (використовується при імпорті: attr:color)

Позначте «Фільтрувати», якщо хочете, щоб цей атрибут був доступний як фільтр у міні-додатку

Вкажіть порядок сортування

Після створення атрибуту ви зможете прив'язувати його до товарів у формі редагування товару.

🎟️

Промокоди

🔒 Розділ доступний залежно від вашого тарифу. Якщо пункт меню позначено замком — функція не входить у поточний тариф.

Створення промокоду

Розділ «Промокоди» знаходиться у меню під «Товари». Натисніть «Додати промокод» та заповніть параметри:

Параметр	Опис
Код	Текст промокоду (літери, цифри, `-` та `_`). Автоматично переводиться у ВЕЛИКІ літери, наприклад `SUMMER26`
Тип знижки	Відсоток (%) — знижка у відсотках від суми; Фіксована сума — знижка у грошах
Розмір знижки	Значення знижки (для відсотка — не більше 100)
Користувачі	Оберіть конкретних клієнтів зі списку. Якщо порожньо — промокод діє для всіх
Використань на користувача	Скільки разів один клієнт може застосувати код. `0` — без обмежень
Дата завершення	Дата, після якої промокод стає недійсним (необов'язково)
Активний	Увімкнення/вимкнення промокоду без видалення

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

Як клієнт застосовує промокод

У кошику міні-додатку клієнт вводить код у поле «Промокод» та натискає «Застосувати»

Система перевіряє код (активність, термін дії, обмеження користувача та ліміт використань) і перераховує підсумкову суму

У кошику відображаються Сума, Знижка та Разом зі знижкою

При оформленні знижка повторно перевіряється на сервері та зберігається у замовленні

Розмір знижки перераховується сервером за реальною сумою кошика — некоректний або прострочений код буде відхилено з повідомленням.

🛒

Замовлення

Статуси замовлення

Новий → В обробці → Оплачено → Відправлено → Завершено

Замовлення також може бути Скасовано на будь-якому етапі.

Фільтри

Використовуйте фільтри для швидкого пошуку замовлень:

Пошук — за номером замовлення
Клієнт — вибір із списку з пошуком
Статус — Новий, В обробці, Оплачено, Відправлено, Завершено, Скасовано
Спосіб оплати — На картку, На пошті, Онлайн (WayForPay)
Статус оплати — Очікування, Успішна, Невдала
Дата від / до — фільтрація за періодом

Створення замовлення вручну

Натисніть «Додати замовлення»

Оберіть клієнта та вкажіть статус

Додайте товари до складу замовлення — оберіть товар, варіацію та кількість

Вкажіть адресу доставки, телефон та спосіб оплати

Натисніть «Зберегти» — сума порахується автоматично

Перегляд деталей

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

Перегляд замовлення клієнтом (міні-додаток)

У міні-додатку клієнт відкриває «Мої замовлення» та натискає на потрібне замовлення — відкривається картка з повною інформацією:

Статус та дата замовлення
Спосіб оплати та адреса доставки (якщо вказана)
Список товарів з фото, варіацією, ціною та кількістю
Підсумки: сума, знижка за промокодом (якщо застосовано) та Разом

👥

Клієнти

База клієнтів

Тут зберігаються всі користувачі, які взаємодіяли з вашим Telegram-ботом. Для кожного клієнта доступна інформація:

ПІБ — ім'я клієнта
chat_id — ідентифікатор Telegram-чату
Email та Телефон

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

Імпорт клієнтів

Завантажте базу клієнтів файлом CSV або XLSX. Колонки визначаються автоматично за заголовками у першому рядку (підтримуються укр/рос/англ назви):

Колонка	Опис
`name`	Ім'я клієнта (`имя`, `фио`, `піб`...)
`phone`	Телефон (`телефон`, `номер`...)
`chat_id`	Telegram чат ID (`чат`, `telegram_chat_id`...)

Телефон очищується від зайвих символів і приводиться до формату +380XXXXXXXXX
Дублікати оновлюються за chat_id або телефоном (нові клієнти додаються)
Значення chat_id автоматично заповнює внутрішній ідентифікатор користувача — окрема колонка не потрібна

Якщо у файлі Excel номер телефону відображається у вигляді 3,8E+11 — заздалегідь задайте колонці формат «Текстовий», інакше цифри будуть втрачені самим Excel.

Відправка повідомлення

Натисніть кнопку «Надіслати повідомлення» біля потрібного клієнта

Введіть текст повідомлення

За потреби прикріпіть фото або файл (зображення, PDF, документи)

Натисніть «Надіслати» — повідомлення буде доставлено в Telegram клієнту

Натисніть «Експортувати клієнтів» для вивантаження всієї бази клієнтів у файл.

💬

Вхідні (Inbox)

Чат з клієнтами

Розділ «Вхідні» — це центр комунікації з клієнтами через Telegram.

Ліва панель — список усіх діалогів з клієнтами. Показує останнє повідомлення, час та кількість непрочитаних
Права панель — потік повідомлень обраного діалогу

Оберіть діалог зліва, введіть відповідь та натисніть «Надіслати». Повідомлення буде доставлено клієнту в Telegram.

При нових повідомленнях в пункті меню «Вхідні» з'являється лічильник непрочитаних та звукове сповіщення.

Відповідь на конкретне повідомлення

Можна відповісти на окреме повідомлення — клієнт побачить це як нативну відповідь у Telegram (з цитатою).

Наведіть на повідомлення та натисніть «↩ Відповісти» під ним — над полем вводу з’явиться цитата

Введіть відповідь і надішліть. Щоб скасувати — натисніть хрестик у блоці цитати

Якщо клієнт відповів на якесь із ваших повідомлень — у діалозі над його відповіддю буде показано цитату того повідомлення, на яке він відповів.

Шаблони відповідей

Зберігайте часті відповіді як шаблони, щоб вставляти їх одним натисканням.

Створюйте та редагуйте шаблони у «Налаштування» → «Налаштування чату» (заголовок + текст)

У вікні чату натисніть кнопку шаблонів біля поля вводу та оберіть потрібний — текст підставиться у відповідь

Форматування тексту

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

Ця функція доступна в тарифах, що включають Inbox.

📢

Розсилки

Масова розсилка

Перейдіть в розділ «Розсилки»

Введіть текст повідомлення

За потреби прикріпіть зображення або файл (фото, PDF, відео, аудіо, архіви)

Натисніть «Надіслати всім»

Після завершення ви побачите результат:

Всього користувачів — скільки клієнтів у базі
Успішно надіслано — скільки отримали повідомлення
Помилок — скільки не вдалось доставити (наприклад, клієнт заблокував бота)

Форматування та історія

Текст розсилки підтримує форматування: жирний, курсив, підкреслення, закреслення, код, спойлер, посилання та цитату
Усі розсилки зберігаються в історії — натисніть «Переглянути», щоб побачити текст і детальний статус доставки по кожному отримувачу

Ця функція доступна в тарифах, що включають Розсилки.

⭐

Відгуки

🔒 Розділ доступний залежно від вашого тарифу. Якщо пункт меню позначено замком — функція не входить у поточний тариф.

Як працюють відгуки

Клієнти залишають відгуки з оцінкою (зірки) прямо в міні-додатку. Кожен новий відгук спочатку потрапляє на модерацію і з’являється в магазині лише після вашого підтвердження.

Модерація відгуків

Перейдіть у розділ «Відгуки» (над пунктом «Адміни»). Лічильник біля пункту показує кількість відгуків, що очікують перевірки

Нові відгуки позначені статусом «На перевірці» та відображаються вгорі списку

Натисніть «Опублікувати», щоб відгук з’явився в міні-додатку, або «Видалити», щоб прибрати його

Якщо клієнт залишив відгук анонімно — замість імені відображатиметься «Анонім».

Блок відгуків на головній

Увімкніть або вимкніть блок у розділі «Налаштування» → «Кастомізація шаблону» → «Блоки головної сторінки» перемикачем «Відгуки»

Перетягуванням змініть позицію блоку серед інших блоків головної сторінки

На головній відображається карусель з 5 останніх опублікованих відгуків (ім’я або «Анонім», оцінка зірками, текст)
Під каруселлю — кнопка «Усі відгуки»: відкриває вікно з усіма опублікованими відгуками (найновіші зверху)
У шапці цього вікна є кнопка «Залишити відгук» — форма з оцінкою, текстом і опцією «анонімно»
Якщо опублікованих відгуків ще немає, але блок увімкнено — клієнт одразу бачить кнопку «Залишити відгук»

Блок відгуків підтримує всі кольорові шаблони магазину, включно з темною темою.

💎

Бонусна система

🔒 Програма лояльності доступна залежно від вашого тарифу. Якщо блок налаштувань накрито замком — функція не входить у поточний тариф.

Що це

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

Налаштування

Відкрийте «Налаштування» → «Бонусна система» та увімкніть програму перемикачем. Далі задайте параметри:

Параметр	Опис
Відсоток нарахування	Скільки відсотків від суми замовлення повертається бонусами після виконання замовлення
Відсоток списання	Яку максимальну частку замовлення можна оплатити бонусами
Бонус за відгук	Фіксована кількість бонусів, яку отримує клієнт після публікації його відгуку
Нараховувати на акційні товари	Чи нараховувати/списувати бонуси на товари зі знижкою

Натисніть «Зберегти» — зміни одразу застосуються в міні-додатку.

Як це працює для клієнта

Нарахування за замовлення відбувається автоматично, коли замовлення переходить у статус «Виконано» — клієнт отримує повідомлення в Telegram
Бонус за відгук нараховується після того, як ви опублікуєте відгук на модерації
Списання: у кошику клієнт може застосувати наявні бонуси для часткової оплати (у межах заданого відсотка)

Якщо програма вимкнена або не входить у тариф — бонуси не нараховуються, не списуються і не показуються клієнтам.

🎁

Подарунок від суми

🔒 Функція доступна залежно від тарифу. Якщо блок налаштувань накрито замком — вона не входить у поточний тариф.

Що це

Механіка, що мотивує підняти суму замовлення: при досягненні заданого порогу обраний товар автоматично додається в кошик як подарунок за 1 ₴. У кошику клієнт бачить прогрес-бар із порогами та підказкою, скільки лишилось до наступного подарунка.

Налаштування

Відкрийте «Налаштування» → «Подарунок від суми» та увімкніть функцію перемикачем. Далі:

Параметр	Опис
Текст у прогрес-барі	Обов'язковий заголовок над шкалою. Можна вставити змінну `{remaining}` — скільки лишилось до наступного подарунка
Рівні подарунків	Для кожного рівня — сума замовлення та товар-подарунок зі списку. Рівнів може бути декілька

Натисніть «Зберегти» — зміни одразу застосуються в міні-додатку.

Як це працює для клієнта

Сума кошика для порогів рахується без урахування подарунків
При досягненні порогу подарунок сам додається в кошик за 1 ₴; якщо сума опускається нижче — прибирається
Подарунки накопичувальні: за кожен досягнутий поріг — свій подарунок
Ціна подарунка фіксована (1 ₴), на нього не діють промокоди та бонуси

Якщо функція вимкнена або не входить у тариф — подарунки не додаються і прогрес-бар не показується.

🔑

Адміністратори та ролі

Додавання та редагування користувача

Перейдіть у розділ «Адміни» та натисніть «Додати користувача»

У спливаючому вікні заповніть Логін, оберіть Роль і за потреби задайте Пароль

Натисніть «Зберегти» — вікно закриється, користувач з’явиться у списку

Щоб змінити користувача — натисніть «Редагувати» навпроти нього (відкриється те саме вікно). Поле пароля залиште порожнім, щоб не змінювати його

Ролі та доступи

Роль визначає, які розділи адмін-панелі бачить користувач. Недоступні пункти меню позначаються замком 🔒 і не відкриваються.

Роль	Доступ
Адміністратор	Повний доступ до магазину (усі розділи)
Менеджер	Замовлення, Клієнти, Вхідні, Розсилки (+ Підтримка)
Контент	Товари, Категорії, Характеристики, Сторінки, Банери (+ Підтримка)

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

Кількість адміністраторів обмежена вашим тарифним планом.

🔗

Інтеграції

Telegram бот

Відкрийте @BotFather у Telegram та створіть нового бота командою /newbot

Скопіюйте отриманий Token та вставте в поле «Token Telegram Bot»

Введіть привітальне повідомлення — його побачить клієнт при першому зверненні до бота

Натисніть «Зберегти Telegram»

Натисніть «Зареєструвати webhook» — бот почне приймати повідомлення

Реєстрація webhook обов'язкова! Без неї бот не буде отримувати повідомлення та замовлення.

Головний міні-додаток (Main Mini App)

Щоб працювали прямі посилання на міні-додаток, увімкніть його як головний у @BotFather: Bot Settings → Configure Mini App. Це потрібно для:

«Поділитися товаром» — у картці товару є кнопка «поділитися»; одержувач за посиланням одразу потрапляє на сторінку цього товару в міні-додатку
Переадресація з браузера — якщо міні-додаток відкрили у звичайному браузері (не в Telegram), користувача автоматично перекидає в бота. Ім’я бота визначається автоматично — нічого вказувати не треба

Окремо нічого вказувати в адмінці не потрібно — достатньо налаштованого токена та головного міні-додатку в BotFather.

Нова Пошта

Отримайте API-ключ у особистому кабінеті Нової Пошти

Вставте ключ у поле «API токен» та натисніть «Зберегти»

Натисніть «Синхронізувати» — система завантажить усі міста, відділення та поштомати

Після синхронізації клієнти зможуть обирати місто та відділення Нової Пошти при оформленні замовлення.

WayForPay (онлайн-оплата)

Зареєструйтесь на WayForPay та отримайте дані мерчанта

Заповніть поля: merchantAccount, merchantSecretKey, merchantDomainName

Натисніть «Зберегти WayForPay»

Домен вказуйте без https://, наприклад: example.com

SalesDrive (CRM)

Автоматична передача замовлень із міні-додатку у CRM SalesDrive, а також експорт категорій і товарів.

У кабінеті SalesDrive створіть форму та скопіюйте Form ID (API ключ)

Заповніть поля «Form ID (API ключ)» та «Домен SalesDrive» (наприклад yourdomain.salesdrive.me) і натисніть «Зберегти SalesDrive»

Натисніть «Перевірити підключення», щоб переконатися, що зв'язок встановлено

За потреби вивантажте наявні дані кнопками «Експорт категорій» та «Експорт товарів»

Після підключення нові замовлення автоматично потраплятимуть у SalesDrive. Доступність інтеграції залежить від вашого тарифу.

Horoshop

Імпорт категорій і товарів із вашого магазину на Horoshop у NB Shop.

У полі «Адреса сайту» вкажіть домен вашого магазину Horoshop (наприклад https://your-domain.com)

Заповніть Логін і Пароль доступу до API та натисніть «Зберегти Horoshop»

Натисніть «Перевірити підключення»

Вкажіть ID каталогу для вивантаження (0 — кореневий розділ)

Натисніть «Імпорт категорій», а потім «Імпорт товарів»

Спочатку імпортуйте категорії, потім товари — так товари одразу прив'яжуться до своїх категорій.

Google Analytics (GA4)

Збір аналітики подій міні-додатку: перегляди товарів і категорій, додавання в кошик та обране, оформлення замовлень.

Створіть ресурс Google Analytics 4 та скопіюйте Measurement ID (формат G-XXXXXXXXXX)

Вставте його у поле «Measurement ID (GA4)» та натисніть «Зберегти»

Події почнуть надходити у GA4 — перевірити можна в розділах Realtime та DebugView

Персональні дані клієнтів (телефон, ПІБ) в аналітику не передаються. Доступність інтеграції залежить від вашого тарифу.

⚙️

Налаштування

Валюта магазину

Вкажіть валюту, яка буде відображатися біля цін у міні-додатку (наприклад: UAH, грн, ₴).

Іконка мінідодатку (favicon)

Завантажте власну іконку, яка відображатиметься на вкладці Telegram Mini App.

У розділі «Налаштування» → «Налаштування магазину» знайдіть блок «Іконка мінідодатку (favicon)»

Натисніть «Вибрати файл» та оберіть квадратне зображення (PNG, JPG або WEBP)

Натисніть «Завантажити іконку» — нова іконка одразу з'явиться у попередньому перегляді

Рекомендуємо квадратне зображення — воно автоматично масштабується. Кнопка «Видалити іконку» повертає стандартну.

Кастомізація шаблону

Стиль кутів банера — Заокруглені або Гострі
Посилання для кнопки «Чат» — URL, який відкривається при натисканні на чат у міні-додатку
Стиль навігації — оберіть вигляд нижньої панелі:
Стандартний — класична навбара Бульбашка — круглі кнопки-пілюлі
Набір іконок — Unicode символи або SVG-іконки
Блоки головної сторінки — перетягуйте блоки для зміни порядку, вмикайте/вимикайте:
Банери Новинки Категорії Популярні Розпродаж
Показувати кнопку «Відкрити» — перемикач

📄

Сервісні сторінки

Що це

Власні інформаційні сторінки (наприклад «Про нас», «Доставка та оплата», «Гарантія», «Контакти»), які відображаються у кабінеті клієнта в міні-додатку.

Створення сторінки

Перейдіть у розділ «Сторінки» та натисніть «Додати сторінку»

У вікні введіть Заголовок та наповніть Текст у візуальному редакторі (жирний, курсив, заголовки, списки, посилання, кольори, цитати)

Натисніть «Зберегти» — сторінка з’явиться у списку

Перетягуванням змініть порядок сторінок — у такому ж порядку вони показуються клієнту

Кнопки «Редагувати» та «Видалити» керують наявними сторінками

Як це бачить клієнт

Список сторінок відображається у кабінеті міні-додатку (між полем Email та кнопкою «Зберегти»). При натисканні відкривається вікно з оформленим вмістом сторінки та хрестиком для закриття.

🎨

Банери та Шаблони

Банери

Завантажуйте зображення для слайдера на головній сторінці міні-додатку:

Перейдіть в розділ «Банери»

Натисніть «Вибрати зображення» та завантажте банер

Банер автоматично з'явиться у слайдері на головному екрані

Рекомендований розмір банера — широкий горизонтальний формат. Зображення автоматично оптимізуються.

Перехід при натисканні на банер

Для кожного банера можна налаштувати перехід у категорію — клієнт натискає на банер і одразу потрапляє у потрібний розділ каталогу.

У картці банера в полі «Перехід при натисканні» оберіть категорію зі списку

Зміни зберігаються одразу. Щоб прибрати перехід — оберіть «Без переходу»

Банери без обраної категорії залишаються просто зображеннями (без переходу).

Шаблони (теми оформлення)

Оберіть кольорову тему для вашого міні-додатку:

Шаблон	Опис	Палітра
Свіжий лайм	Яскравий лаймовий шаблон
Апельсин	Теплий апельсиновий шаблон у насичених помаранчевих відтінках
Лісові ягоди	Глибокий фіолетовий шаблон з відтінками стиглих лісових ягід
Блакитний місяць	Стильний синій шаблон з ефектом liquid glass у холодних відтінках
Нічний графіт	Темна преміальна тема: графітовий фон і неоново-бірюзовий акцент. Ідеально для техніки та вейпів

Натисніть «Вибрати» біля потрібного шаблону — зміни застосуються одразу.