• Блог
  • Гайди
  • Як підключити розумний пошук до Horoshop: покрокова інструкція

Як підключити розумний пошук до Horoshop: покрокова інструкція

Як підключити розумний пошук до Horoshop: покрокова інструкція

Стандартний пошук 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 за допомогою логіна і пароля окремого користувача. Не свого основного акаунту — а спеціально створеного з обмеженими правами. Це безпечно: користувач бачить тільки товари, без доступу до замовлень, клієнтів чи платежів.

  1. Адмінка Horoshop → Налаштування → Адміни → "Додати"
  2. Вводиш email і пароль
  3. Обираєш роль — content-manager
  4. Зберігаєш

Назви користувача "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

Поділитися:

Хочете такий результат?

14 днів безкоштовно. Інтеграція за 15 хвилин.