ШІ для продавців Prom.ua

Модуль 0 — Підготовка робочого місця

0.1 Що ми побудуємо

За цей курс ти крок за кроком збереш трьох AI-помічників для свого магазину на Prom.ua:

• Генератор карток — пише продаючі заголовки, описи й характеристики під SEO-правила Prom за хвилини, а не години.
• Чат-відповідач — ввічливо відповідає покупцям у чатах Prom українською, навіть коли ти спиш.
• Агент магазину — надсилає тобі нові замовлення в Telegram і допомагає з аналітикою.

Усе це працює на Claude Code — інструменті, який пише код замість тебе. Тобі не треба бути програмістом: ти описуєш завдання звичайними словами, а Claude робить.

0.2 Створюємо акаунт Claude

1. Відкрий сайт Claude

   Перейди на claude.ai та натисни Sign up.

2. Зареєструйся через Google або пошту

   Найшвидше — кнопка Continue with Google. Або введи email і підтверди код із листа.

3. Підтверди акаунт

   Введи імʼя, підтверди, що тобі є 18, — готово. Це твій безкоштовний акаунт Claude.

0.3 Встановлюємо Claude Code

Claude Code працює в «терміналі». Спершу поставимо те, без чого він не запуститься — програму Node.js, а потім сам Claude Code.

Крок А. Встановлюємо Node.js

1. Завантаж Node.js

   Відкрий nodejs.org і натисни велику зелену кнопку LTS (рекомендована версія). Завантажиться файл-інсталятор.

2. Встанови

   Запусти завантажений файл. І на Windows, і на Mac це звичайний інсталятор: тисни Продовжити → Прийняти умови → Встановити → Готово (нічого не змінюй). На Mac може спитати пароль від компʼютера — це нормально.

3. Перевір, що встановилось

   Відкрий термінал (на Windows — застосунок «PowerShell» або «Командний рядок», на Mac — «Terminal» через пошук Spotlight). Введи команду й натисни Enter:

   node -v

   Якщо зʼявилось щось на кшталт v22.3.0 — Node.js встановлено. ✅

Крок Б. Встановлюємо Claude Code

1. Введи команду встановлення

   У тому ж терміналі встав і натисни Enter:

   npm install -g @anthropic-ai/claude-code

   Зачекай 1–2 хвилини, поки все завантажиться. Побіжать рядки — це нормально.

2. Запусти Claude Code

   Введи коротку команду:

   claude

   Першого разу він попросить увійти — відкриється браузер, натисни авторизуватись акаунтом claude.ai (тим самим із уроку 0.2).

3. Перевір, що працює

   Коли побачиш привітання Claude Code прямо в терміналі — напиши йому: Привіт! Ти готовий допомагати з моїм магазином? Якщо відповів — усе працює. 🎉

0.4 Термінал за 10 хвилин

Термінал — це просто спосіб давати компʼютеру команди текстом. Тобі знадобиться всього кілька:

• cd назва_папки — зайти в папку
• cd .. — піднятись на папку вище
• ls (Mac) або dir (Windows) — показати, що в папці
• claude — запустити нашого помічника в цій папці

1. Створи робочу папку для магазину

   Зробимо окрему папку, де житимуть усі файли помічника. Введи по черзі:

   # створюємо папку на робочому столі
   cd Desktop
   mkdir prom-pomichnyk
   cd prom-pomichnyk

   Тепер ти «всередині» папки prom-pomichnyk.

2. Запусти тут Claude Code

   Просто введи claude — і помічник працюватиме саме в цій папці.

0.5 Отримуємо API-токен Prom.ua

API-токен — це таємний ключ, що дозволяє нашому помічнику безпечно працювати з твоїм магазином через офіційний інтерфейс Prom.ua.

1. Зайди в кабінет продавця Prom.ua

   Відкрий my.prom.ua і увійди у свій магазин.

2. Відкрий розділ API

   Перейди: Налаштування → Управління API → Створити токен.

3. Увімкни потрібні права

   При створенні постав галочки на права:

   • Товари — щоб AI працював із картками й залишками
   • Замовлення — щоб бачити нові замовлення
   • Повідомлення — щоб відповідати покупцям у чатах
4. Скопіюй і збережи токен

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

Модуль 1 — AI-картки товарів, що продають

1.1 SEO-заголовок, який виводить у топ

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

[Тип товару] + [Бренд/Модель] + [Ключова характеристика] + [Для кого/Призначення]

1. Відкрий Claude Code у своїй папці

   У терміналі: claude.

2. Дай йому промпт-заготовку

   Скопіюй цей промпт і встав, підставивши свій товар:

   Промпт: заголовок

   Ти — SEO-копірайтер маркетплейсу Prom.ua. Напиши 5 варіантів заголовка товару за формулою: [Тип] + [Бренд/Модель] + [Ключова характеристика] + [Призначення]. Довжина — до 70 символів, без КАПСУ, українською. Товар: «конструктор сумісний з Lego, Технік, тягач, 1200 деталей, для дітей 8+».
3. Обери найкращий і встав у Prom

   Claude видасть 5 варіантів — обери найточніший, скопіюй у поле «Назва товару» в кабінеті Prom.

1.2 Продаючий опис за структурою

Робоча структура опису (5 блоків): чіпляючий перший рядок → 3–5 вигод → характеристики → зняття заперечень → заклик до дії.

1. Дай Claude промпт опису
   Промпт: опис

   Напиши опис товару для картки Prom.ua за структурою: 1) чіпляючий перший рядок, 2) 4 вигоди списком, 3) ключові характеристики, 4) зняття 2 типових заперечень, 5) заклик до дії. Тон — дружній, без води. Мова — українська. Обсяг 600–900 символів. Товар: [встав назву і 3-4 факти про товар].
2. Перевір факти

   AI може «додумати» деталі. Звір характеристики зі своїми реальними — виправ, якщо треба.

3. Встав опис у картку

   Скопіюй у поле «Опис» товару в кабінеті Prom.

1.3 Характеристики та ключові слова

1. Попроси AI скласти характеристики

   Промпт: «Склади перелік характеристик для цього товару у форматі параметр: значення — максимально повно для картки Prom.ua». Заповнені характеристики = вище в пошуку й фільтрах.

2. Збери ключові слова

   Промпт: «Дай 15 пошукових запитів українською, за якими покупці шукають цей товар на Prom». Вплети найкращі в заголовок і перший абзац опису.

1.4 Масова генерація карток

1. Підготуй список товарів

   Зроби простий файл tovary.txt у папці магазину: один товар на рядок (назва + кілька фактів).

2. Доручи завдання Claude Code

   У терміналі (в папці магазину) попроси:

   Завдання Claude Code

   Прочитай файл tovary.txt. Для кожного товару згенеруй заголовок (до 70 символів) та опис (5 блоків) українською за моїми правилами SEO для Prom.ua. Збережи результат у файл kartky.csv з колонками: назва, заголовок, опис.

   Claude сам створить файл kartky.csv з готовими картками для всіх товарів.

3. Імпортуй у Prom

   Відкрий kartky.csv, перевір — і перенось у картки (вручну або через імпорт товарів Prom).

Модуль 2 — AI авто-відповіді в чатах Prom

2.1 Як влаштований чат Prom і API повідомлень

Коли покупець пише в чат твого магазину на Prom, повідомлення можна отримати не лише в кабінеті, а й через офіційний API — той самий «ключ», що ти отримав у Модулі 0. Наш помічник працюватиме так:

• кожні 2 хвилини зазирає, чи є нові повідомлення від покупців;
• якщо є — пише ввічливу відповідь українською за твоїми правилами;
• позначає чат як прочитаний, щоб не відповісти двічі.

Технічно це кілька адрес офіційного API Prom (їх Claude Code використає сам — тобі досить знати, що вони є):

# база API Prom (однакова для всіх запитів)
https://my.prom.ua/api/v1

# отримати нові повідомлення
GET  /messages/?is_read=false

# надіслати відповідь покупцю
POST /messages/

# позначити чат прочитаним
POST /messages/{chat_id}/read/

2.2 Claude Code збирає твій перший скрипт-відповідач

Спершу акуратно й безпечно збережемо токен, щоб він не лежав «у відкритому вигляді».

1. Поклади токен у файл .env

   У папці магазину (prom-pomichnyk) попроси Claude Code:

   Завдання Claude Code

   Створи файл .env і додай рядок PROM_TOKEN=сюди_мій_токен. Додай .env у .gitignore, щоб він нікуди не потрапив. Поясни одним реченням, що ти зробив.

   Потім встав свій токен замість сюди_мій_токен і збережи файл.

2. Доручи Claude Code зібрати відповідача

   Встав це завдання — Claude Code напише код сам:

   Завдання Claude Code

   Збери Python-скрипт chat_bot.py для магазину на Prom.ua. Він має: 1) брати токен із .env (PROM_TOKEN); 2) кожні 2 хвилини робити запит GET https://my.prom.ua/api/v1/messages/?is_read=false із заголовком Authorization: Bearer токен; 3) для кожного чату, де останнє повідомлення від покупця (author_role = buyer), формувати відповідь; 4) надсилати її через POST /messages/ (chat_id і текст); 5) одразу позначати чат прочитаним через POST /messages/{chat_id}/read/. Працюй за офіційною документацією Prom API. Поки що замість розумної відповіді постав заглушку «Дякуємо за звернення!». Поясни, як запустити.
3. Запусти й перевір

   Claude Code підкаже команду запуску (зазвичай python chat_bot.py). Напиши собі в чат магазину з іншого акаунта — і переконайся, що приходить відповідь-заглушка.

2.3 Системний промпт менеджера: тон і правила

«Системний промпт» — це інструкція для AI, як саме спілкуватися. Візьми цю заготовку, підстав назву магазину й підправ під себе:

1. Встав промпт у свій скрипт

   Попроси Claude Code:

   Завдання Claude Code

   У скрипті chat_bot.py заміни заглушку на справжню відповідь: бери текст останнього повідомлення покупця і відправляй його в AI (економну модель) разом із моїм системним промптом (я його дам). Відповідь AI надсилай покупцю. Системний промпт винеси в окрему змінну зверху файлу, щоб я міг легко його редагувати.
2. Передай товарний контекст (за бажанням)

   Щоб AI відповідав точніше, можна підкидати йому назву й характеристики товару із замовлення/картки. Попроси Claude Code додати це, коли базовий варіант уже працює.

2.4 Тест на справжніх повідомленнях і запуск

1. Режим чернетки (рекомендовано на старт)

   Попроси Claude Code зробити «режим чернетки»: бот не надсилає відповідь одразу, а показує її тобі (у термінал або в Telegram), і ти вирішуєш, відправляти чи ні. Так перевіриш якість без ризику.

2. Перевір на 10–15 реальних діалогах

   Подивись, де відповіді гарні, а де ні — і підправ системний промпт. Кілька ітерацій — і бот відповідає як ти.

3. Увімкни автопілот

   Коли якість влаштовує — переведи бота в авто-режим: відповідає сам, перевіряє чат кожні 2 хвилини.

Модуль 3 — Власний AI-агент магазину

3.1 Нові замовлення прямо в Telegram

1. Створи свого Telegram-бота

   У Telegram знайди @BotFather → команда /newbot → придумай імʼя. Він видасть токен бота — збережи його.

2. Дізнайся свій chat_id

   Напиши боту @userinfobot — він покаже твій chat_id (куди слати сповіщення).

3. Доручи Claude Code зібрати сповіщення
   Завдання Claude Code

   Додай у мого помічника сповіщення про замовлення. Кожні 5 хвилин роби запит GET https://my.prom.ua/api/v1/orders/list/?status=pending із моїм токеном. Для кожного нового замовлення (яке ще не надсилав) відправ мені в Telegram: номер замовлення, товари, суму, імʼя й телефон покупця. Токен бота і chat_id візьми з .env (TELEGRAM_TOKEN, TELEGRAM_CHAT_ID). Запамʼятовуй уже надіслані замовлення, щоб не дублювати.

3.2 Синхронізація залишків

Через API Prom можна не лише читати товари, а й оновлювати їх (залишки, ціни). Якщо ведеш облік у таблиці (Excel/Google Таблиці) — помічник зводитиме її з магазином.

1. Підготуй джерело залишків

   Найпростіше — Google Таблиця або файл: колонки «артикул» і «кількість».

2. Доручи Claude Code синхронізацію
   Завдання Claude Code

   Збери скрипт синхронізації залишків для Prom.ua. Він бере кількість із моєї таблиці (я дам посилання/файл), порівнює з товарами в магазині через API Prom і, де відрізняється, оновлює залишок. Працюй за офіційною документацією Prom API щодо редагування товарів. Спершу зроби «сухий прогін» — лише покажи, що змінив би, нічого не змінюючи. Я перевірю й дозволю реальне оновлення.

3.3 Планувальник: агент на автопілоті

1. Обʼєднай задачі в одному агенті
   Завдання Claude Code

   Зроби єдиний планувальник, який запускає мої задачі за розкладом: відповіді в чатах — кожні 2 хвилини, перевірка нових замовлень — кожні 5 хвилин, синхронізація залишків — раз на годину. Додай простий лог, щоб я бачив, що агент працює. Поясни, як запустити його однією командою.
2. Хай працює завжди

   Поки скрипт запущений на твоєму компʼютері — агент працює. Щоб він трудився 24/7 навіть із вимкненим ноутбуком, його ставлять на недорогий сервер (VPS). Це показуємо окремо на живих заняттях.

Модуль 4 — Реклама ProSale та аналітика з AI

4.1 ProSale з AI — без зливу бюджету

1. Вивантаж дані про товари й продажі

   З кабінету Prom вивантаж список товарів і статистику продажів (експорт у файл).

2. Дай Claude проаналізувати
   Завдання Claude Code

   Проаналізуй мій експорт товарів і продажів. Визнач: 1) товари-локомотиви (добре продаються, висока маржа) — їх рекламувати першими; 2) товари з показами, але без продажів — що з ними не так (ціна, картка, фото); 3) товари, які не варто рекламувати. Дай конкретні рекомендації по ProSale: на що ставити бюджет, на що — ні.

4.2 AI-аналітика магазину

1. Збери дані в одному місці

   Вивантаж замовлення за останні 1–3 місяці (експорт із кабінету Prom).

2. Попроси Claude зробити розбір
   Завдання Claude Code

   Зроби аналіз моїх замовлень за період: топ-10 товарів за виручкою, топ за кількістю, «мертві» позиції без продажів, середній чек, динаміка по тижнях. Сформулюй 5 простих висновків і 3 конкретні дії, які піднімуть продажі наступного місяця.

4.3 Фінальний проєкт і чек-лист запуску

Вітаю — якщо ти дійшов сюди, в тебе вже не «папка з уроками», а робоча система. Перевір себе за фінальним чек-листом: