Стандартний пошук Horoshop шукає по точному збігу. Покупець написав "ноутбукь" з помилкою або "Samsung" кирилицею — нічого не знайде. Магазин втрачає продаж, хоча товар є в каталозі. Spefix вирішує це через одну інтеграцію — по API, без розробника, за одну робочу годину.
| Етап | Час |
|---|---|
| Реєстрація і створення домену | 5–10 хв |
| Створення користувача в Horoshop | 5 хв |
| Підключення API і імпорт товарів | 5–30 хв |
| Вставка коду на сайт | 5 хв |
| Налаштування віджету | 10–15 хв |
| Загалом | 30–60 хв |
Що не так зі стандартним пошуком Horoshop
Horoshop — хороша платформа. Але вбудований пошук робить "пошук за назвою", а не "розуміння наміру покупця". Покупець пише "пилос" — нуль результатів. Пише "Самсунг" — нуль. Забув перемкнути розкладку і набрав "nhfycajhvfnjh" — нуль. Шукає "стільців" замість "стілець" — нуль. Пише "кроси" замість "кросівки" — нуль.
Це не недолік Horoshop — це стандартне обмеження більшості платформних пошуків. Вони не обробляють опечатки, транслітерацію, розкладку, морфологію і синоніми.
В магазинах на Horoshop без спеціалізованого пошуку типовий рівень нульових результатів — 15–35% запитів. Кожен четвертий-п'ятий покупець, що шукає щось на вашому сайті — нічого не знаходить і йде.
Що змінюється після підключення Spefix
Spefix підключається до Horoshop через API — товари синхронізуються автоматично, один код працює для всіх мовних версій сайту. Після підключення пошук починає розуміти покупців: опечатки, кирилиця/латиниця для брендів, неправильна розкладка, відмінки, синоніми — все обробляється автоматично. Можна задати і власний словник синонімів: "кросівки = кеди = sneakers" — і пошук буде розуміти всі варіанти.
Що потрібно перед підключенням
- Магазин на Horoshop з активним доменом
- Доступ до адмінпанелі Horoshop — для створення окремого користувача і вставки коду
- Обліковий запис Spefix — реєстрація безкоштовна, тріал 14 днів без картки
Жодних інших технічних вимог.
Покрокова інструкція підключення
Крок 1. Реєстрація в Spefix
Переходиш на spefix.com, натискаєш "Спробувати безкоштовно". Реєстрація через email або Google-акаунт. Після входу в кабінет — створюєш домен: натискаєш "Створити домен" і вводиш URL свого магазину (наприклад, https://myshop.com.ua).
Крок 2. Створення окремого користувача в Horoshop
Spefix підключається до Horoshop через API за допомогою логіна і пароля окремого користувача. Не свого основного акаунту — а спеціально створеного з обмеженими правами. Це безпечно: користувач бачить тільки товари, без доступу до замовлень, клієнтів чи платежів.
- Адмінка Horoshop → Налаштування → Адміни → "Додати"
- Вводиш email і пароль
- Обираєш роль — content-manager
- Зберігаєш
Назви користувача "Spefix" — так одразу зрозуміло для чого він. Якщо захочеш відключити інтеграцію — просто видалиш цього користувача. Не впевнений як створити користувача — напиши в підтримку, проведемо через це за 2 хвилини.
Крок 3. Підключення API в кабінеті Spefix
В кабінеті Spefix переходиш: Налаштування пошуку → Інтеграція. Обираєш тип інтеграції "Horoshop" і вводиш логін та пароль користувача, якого створив на попередньому кроці. Натискаєш "Надіслати".
Spefix підключається до API Horoshop і починає автоматичне завантаження товарів. Для магазину з 3 000–5 000 товарів це займає 5–30 хвилин. Статус видно прямо в кабінеті: "Опрацювання" → "Готово". Якщо статус "Помилка" — не розбирайся сам, просто напиши в підтримку з посиланням на кабінет.
Деталі підключення — в базі знань Spefix для Horoshop.
Крок 4. Встановлення коду на сайт
Поки товари завантажуються — можна одразу встановити код. В розділі "Інтеграція" копіюєш один рядок JavaScript:
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN"></script>
Вставляєш в Horoshop: Адмінка → Налаштування → Загальні налаштування → Скрипти — перед закриваючим тегом </body>. Зберігаєш.
Один код працює на всіх сторінках і всіх мовних версіях магазину. Токен індивідуальний — копіюй з кабінету, а не з цієї статті. Якщо не знаєш куди вставити код — скинь нам доступ і ми вставимо самі.
Крок 5. Налаштування віджету
В кабінеті Spefix налаштуй зовнішній вигляд віджету: кольори, шрифт, кількість підказок. Також потрібно вказати CSS-селектор вашої кнопки пошуку, щоб віджет відкривався при кліку на неї. Якщо не знаєте як його знайти — напишіть нам в Telegram @spefix_pm і ми допоможемо за 5 хвилин.
Крок 6. Перевірка
Відкриваєш магазин в анонімній вкладці (Ctrl+Shift+N) — це важливо, бо звичайна вкладка може показувати кешовану версію. Клікаєш на пошук — має відкритися віджет Spefix. Тестуєш:
- "Самсунг" — має знайти товари Samsung
- "навюшники" — має знайти навушники
- "nhfycajhvfnjh" — має знайти трансформатори
Якщо бачиш результати — все працює. Більшість власників магазинів у цей момент одразу тестують найстрашніший запит зі своєї аналітики — той, що давав нульові результати місяцями. І бачать товар.
А вже наступного ранку в кабінеті Spefix з'являться перші дані: що шукали покупці, скільки з них нічого не знайшли, які запити найпопулярніші. Зазвичай ця цифра дивує — навіть тих, хто думав що "з пошуком все ок".
Типові проблеми і як їх вирішити
Віджет не з'являється. Перевір в анонімній вкладці — кеш може блокувати зміни. Якщо не допомагає — найчастіша причина: код вставлений не в той розділ скриптів.
Деякі товари не знаходяться. Перевір статус імпорту в кабінеті Spefix — там видно скільки товарів завантажено і чи є помилки. Можливо товари позначені як "не в наявності" і виключені з індексу.
Віджет не відповідає дизайну. Налаштуй кольори в кабінеті Spefix. Для глибшої кастомізації — CSS-overrides в шаблоні Horoshop.
Більше сценаріїв — в базі знань. Але чесно: не треба витрачати час на дебаг самостійно. Напишіть нам — і ми розберемось разом. Telegram @spefix_pm або [email protected].
Підключення займає до години. Розробник не потрібен. Покупці, які раніше бачили "Нічого не знайдено" — починають знаходити товари вже сьогодні.
Спробуй Spefix на своєму магазині — 14 днів безкоштовно, без картки → spefix.com


