Перейти до основного вмісту

Підключення Хорошоп

Автоматична інтеграція для магазинів на платформі Хорошоп. Товари синхронізуються автоматично, код універсальний для всіх мов.

⏱ Час: 15-20 хвилин (+ до 30 хв на завантаження товарів)

Крок 1: Реєстрація​

Через email​

  1. Перейдіть на spefix.com
  2. Натисніть "Спробувати безкоштовно"
  3. Заповніть форму:
    • Email — обов'язково
    • Номер телефону — обов'язково
    • ПІБ — опційно
  4. Перевірте пошту → скопіюйте пароль → увійдіть в кабінет

Через Google​

  1. Натисніть "Увійти через Google"
  2. Виберіть акаунт
  3. Введіть номер телефону
  4. Готово

Крок 2: Створити домен​

  1. У кабінеті знайдіть кнопку "Створити домен" (в хедері)

Кнопка створення домену

  1. Введіть URL вашого сайту
    Приклад: https://myshop.com.ua

Модальне вікно створення домену

  1. Натисніть "Створити"
Важливо

Вказуйте справжній домен сайту, на якому хочете підключити пошук.

Крок 3: Створити окремого користувача в Хорошоп​

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

Чому це важливо?​

  • Spefix отримає доступ тільки до товарів
  • Без доступу до замовлень, клієнтів, платежів
  • Ви зможете видалити користувача будь-коли → інтеграція припиниться

Як створити користувача в Хорошоп:​

  1. Увійдіть в адмінку Хорошоп
  2. Перейдіть: Налаштування → Адміни
  3. Натисніть "Додати"
  4. Заповніть дані:
    • Email (будь-який)
    • Пароль
  5. Налаштуйте Роль:
    • ✅ content-manager (з іншими також має працювати, але ця роль найбезпечніша)
  6. Збережіть користувача

Додаємо користувача в Хорошоп

Рекомендація

Назвіть користувача "Spefix" — так зрозуміліше для чого він потрібен.

Крок 4: Підключити Хорошоп у Spefix​

  1. У кабінеті Spefix перейдіть: Налаштування пошуку → Інтеграція
  2. Виберіть тип інтеграції: "Хорошоп"

Змінюємо тип інтеграції

Вибираємо Horoshop

  1. Введіть дані користувача:
    • Логін — email користувача з Хорошоп
    • Пароль — пароль користувача
  2. Натисніть "Надіслати"

Форма інтеграції Хорошоп

Крок 5: Дочекатись завантаження товарів​

Після підключення почнеться автоматичне завантаження та індексація товарів.

⏱ Час завантаження: 5-30 хвилин (залежно від кількості товарів)

Статус можна побачити в розділі Інтеграція:

  • Опрацювання — товари завантажуються
  • Готово — можна тестувати пошук
  • Помилка — зверніться до менеджера
Що робити поки чекаєте?

Поки товари завантажуються, можете скопіювати код інтеграції (наступний крок) і встановити його на сайт.

Крок 6: Встановити код на сайт​

  1. У розділі Інтеграція (під полями логіну/пароля) скопіюйте код віджету
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN"></script>

Код інтеграції для Хорошоп

  1. Встановіть код в Хорошоп:
    • Адмінка Хорошоп → Налаштування → Загальні налаштування → Скрипти
    • Вставте код перед закриваючим тегом </body>
    • Збережіть

Добавляємо код інтеграції в Хорошоп

Універсальний код

Для Хорошоп використовується один код на всі мовні версії сайту. Система автоматично визначає мову.

Важливо

Копіюйте код з вашого кабінету — токен індивідуальний для кожного сайту!

Крок 7: Налаштувати селектори кнопки​

Щоб віджет відкривався при кліку на вашу кнопку пошуку, потрібно прописати селектор цієї кнопки.

Знайти селектор кнопки​

  1. Відкрийте ваш сайт
  2. Натисніть F12 (консоль розробника)
    Або клікніть правою кнопкою миші → "Переглянути код"

Відкриття консолі

  1. Виберіть інструмент "Вибрати елемент" (стрілка в лівому верхньому куті)

  2. Клікніть на кнопку пошуку

  3. У коді знайдіть class або id кнопки

Знаходження селектора в коді

Приклади селекторів:

  • .search__input — клас
  • #search-btn — ID

Додати селектор у Spefix​

  1. Перейдіть: Налаштування пошуку → Встановлення
  2. Знайдіть блок "Список селекторів при кліку на який відображається віджет"
  3. Натисніть "Додати селектор"

Додавання селектора

  1. Введіть ваш селектор (наприклад, .search__input)
  2. Натисніть галочку праворуч від поля
  3. Якщо кнопок пошуку кілька — додайте кожен селектор окремо

Додавання селектора в Spefix - крок 2

Зберегти зміни​

  1. Прокрутіть вниз сторінки
  2. Натисніть "Зберегти" (з'явиться після змін)

Зберегти налаштування

Не впевнені?

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

💬 Telegram: @spefix_pm • 📧 [email protected]

Крок 8: Перевірити роботу​

  1. Відкрийте сайт в анонімній вкладці (Ctrl+Shift+N / Cmd+Shift+N)

  2. Клікніть на кнопку пошуку → має відкритися віджет Spefix ✅

  3. Спробуйте різні варіанти пошуку

Віджет не відкривається?

Перевірте в анонімній вкладці — через кеш зміни можуть не відобразитись одразу.

Не допомагає? Зверніться до менеджера — допоможемо налаштувати.

Готово! 🎉​

Spefix працює на вашому Хорошоп-магазині. Товари синхронізуються автоматично.

Що далі?​

Потрібна допомога?​

💬 Telegram: @spefix_pm
📧 Email: [email protected]

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

Тестовий період

14 днів безкоштовно — без картки, скасувати можна будь-коли