Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/immortaln/presale-client-bot/archive/refs/heads/main.zipWordPress-плагін для тренування presale-агентів Crocoblock.
Агент спілкується з AI-клієнтом, після чого отримує структуровану оцінку за методологією компанії.
Версія: 0.3.1
Що вміє плагін
- Генерація випадкового сценарію клієнта (через OpenRouter)
- Рольова гра: AI виступає в ролі реалістичного клієнта
- Короткі відповіді клієнта + природне завершення діалогу
- Після 7 відповідей агента — система повідомляє «Клієнт пропав, напишіть фолоуап»
- Оцінка діалогу за 4 критеріями + Overall Score
- Збереження всіх результатів у таблицю (для тімліда)
- Обов’язкове поле з ніком агента
- Публічний шорткод з паролем (агенти не потребують доступу в адмінку)
Сторінки в адмінці
| Сторінка | Призначення |
|---|---|
| Chat | Тренування (адмін-версія) |
| Results | Таблиця всіх оцінених діалогів + детальний фідбек |
| Settings | API-ключ OpenRouter + моделі |
Шорткод (фронтенд)
[presale_training]
Або з паролем: [presale_training password="croc2026"]
За замовчуванням пароль: croc2026
Агенти заходять на сторінку → вводять пароль → працюють у чаті.
Бекенд їм не потрібен.
Налаштування (Settings)
| Поле | Опис |
|---|---|
| Ключ OpenRouter API | Обов’язковий. Без нього нічого не працює |
| Модель roleplay | Модель для клієнта (рекомендовано openrouter/free) |
| Резервні моделі roleplay | Список через кому (якщо основна недоступна) |
| Модель оцінювання | Модель для оцінки (рекомендовано openrouter/free) |
Безкоштовні моделі (рекомендовано)
Модель roleplay: openrouter/free Резервні моделі: meta-llama/llama-3.3-70b-instruct:free, google/gemma-4-31b-it:free Модель оцінювання: openrouter/free
Як працює оцінка
Після натискання «Оцінити розмову» AI аналізує діалог за критеріями:
- Discovery — чи збирав агент вимоги перед продажем
- Architecture — чи пропонував рішення під задачу клієнта (Outcome vs Feature)
- Commercial — порівняння цін, CTA, FOMO, refund, next step
- Tone — тон, ясність, відсутність «простынь»
Результат показується агенту одразу у вигляді карток зі скорами + повний фідбек.
Усі результати зберігаються в таблицю wp_presale_training_results.
Що потрібно для високого балу (80%+)
- Discovery — 1–2 уточнюючі питання до продажу
- Архітектура — показати, як плагіни вирішують задачу клієнта
- Комерція (мінімум 4–5 пунктів):
- Порівняння «окремі плагіни vs All Inclusive» з цифрами
- Пряме посилання на pricing/checkout
- 30-day money-back guarantee
- Згадка підтримки / Zoom
- Чіткий next step (summary / Zoom / follow-up)
- Тон — консультативний, короткі повідомлення, без води
REST API
| Endpoint | Метод | Опис |
|---|---|---|
/wp-json/training/v1/start |
POST | Генерація сценарію |
/wp-json/training/v1/chat |
POST | Відповідь AI-клієнта |
/wp-json/training/v1/evaluate |
POST | Оцінка діалогу |
Усі ендпоінти зараз публічні (permission_callback => __return_true), бо агенти працюють без логіну.
База даних
Таблиця: {prefix}_presale_training_results
Поля:
agent_namescenario_summaryoverall_score,discovery_score,architecture_score,commercial_score,tone_scorefeedbackmessagescreated_at
Важливі примітки
- Після оновлення коду деактивуйте і знову активуйте плагін (щоб створилася таблиця).
- Безкоштовні моделі OpenRouter мають ліміт ~50 запитів/день.
- Пароль від шорткоду зберігається в сесії браузера.
- Нік агента обов’язковий — без нього оцінка не запускається.
Швидкий старт
- Активувати плагін
- Presale Training → Settings → вставити OpenRouter API key
- Поставити безкоштовні моделі
- Створити сторінку і вставити
[presale_training] - Відкрити сторінку → ввести пароль
croc2026→ тренуватися