🛍️ Синхронізація Shopify

🛍️ Shopify Синхронізація

Розширення Shopify Синхронізація від Botoscope дозволяє підключити ваш існуючий магазин Shopify до вашого Telegram-бота. Продукти автоматично імпортуються з Shopify у WooCommerce, а замовлення, зроблені через бота, повертаються в Shopify — зберігаючи управління запасами та замовленнями в одному місці.

✨ Основні функції

  • 🔄 Автоматична синхронізація продуктів — імпорт всіх активних продуктів Shopify у WooCommerce
  • 📦 Повернення замовлень — замовлення з бота автоматично відправляються назад у Shopify
  • 🖼️ Синхронізація медіа — зображення продуктів імпортуються разом з продуктами
  • 🏷️ Підтримка варіантів — варіанти продуктів Shopify стають змінними продуктами WooCommerce
  • 🔔 Вебхуки — оновлення в реальному часі, коли продукти створюються, оновлюються або видаляються в Shopify
  • 🛒 Готовність до каталожного режиму — URL-адреси продуктів Shopify зберігаються, щоб клієнти могли бути перенаправлені до вашого магазину Shopify для завершення покупки (опціонально)

🔧 Крок 1: Активуйте розширення

  1. Перейдіть на вкладку Розширення в Botoscope
  2. Знайдіть Shopify Синхронізація і увімкніть його ВКЛ
  3. Вкладка Shopify Синхронізація з’явиться у верхній навігації

🏪 Крок 2: Створіть додаток Shopify

Botoscope підключається до вашого магазину Shopify через Застарілий Користувацький Додаток. Це дає вам постійний API токен — без OAuth потоку, без Панелі Партнера, без процесу перевірки.

Перейдіть до вашого Shopify Адміністратора:

https://admin.shopify.com/store/YOUR-STORE/settings/apps/development

Ви побачите два варіанти. Натисніть “Дозволити розробку застарілих користувацьких додатків” — це має бути увімкнено перед тим, як ви зможете створити додаток.

💡 Чому застарілий? З січня 2026 року Shopify переніс всю нову розробку додатків на їхню Панель Розробника, яка вимагає затвердження Захищених Даних Клієнтів для доступу до замовлень. Застарілі Користувацькі Додатки повністю обходять цю вимогу, оскільки додаток є приватним лише для вашого магазину.

🔑 Крок 3: Налаштуйте дозволи додатка

Після увімкнення застарілої розробки натисніть “Створити додаток” і заповніть будь-яке ім’я (наприклад, Botoscope).

Потім перейдіть до API облікові дані → Доступ до обсягів Admin API і увімкніть:

Обсяг Призначення
read_products Читати дані продуктів з Shopify
write_products Оновлювати продукти (для майбутніх функцій)
read_orders Читати дані замовлень
write_orders Повернути замовлення бота в Shopify

Натисніть Зберегти, а потім Встановити додаток.

📋 Крок 4: Скопіюйте ваші облікові дані

Після встановлення перейдіть до API облікові дані. Ви побачите три значення — скопіюйте всі з них:

Поле Приклад
API ключ (ID клієнта) de56a5f47189cc1694dd233be84e2146
API секретний ключ shpss_3f295566ed87s400ac669ce2b1ab108v
Токен доступу до Admin API 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

⚠️ Важливо: Токен доступу до Admin API показується лише один раз. Скопіюйте його негайно і збережіть безпечно — ви не зможете отримати його знову без перевстановлення додатка.

⚙️ Крок 5: Введіть облікові дані в Botoscope

Перейдіть до Botoscope → вкладка Розширення і заповніть:

Поле Що ввести
URL магазину your-store.myshopify.com (без https://)
ID клієнта Ваш API ключ
Секрет клієнта Ваш API секретний ключ
Токен доступу до API Ваш токен доступу до Admin API (shpat_...)

💡 Порада: Якщо поле Токен доступу до API заповнено, Botoscope використовує його безпосередньо. ID клієнта і Секрет використовуються лише як резерв, якщо токен не надано.

Натисніть Зберегти.

🔄 Крок 6: Синхронізуйте продукти

Перейдіть на вкладку Shopify Синхронізація і натисніть “Синхронізувати продукти”, щоб імпортувати всі активні продукти з вашого магазину Shopify у WooCommerce.

Панель прогресу покаже:

Знайдено 42 продукти. Синхронізація...
Синхронізовано 42 з 42 продуктів. Готово!

Продукти імпортуються з:

  • Назва, опис, ціна
  • Зображення
  • Варіанти → змінні продукти WooCommerce
  • Категорії (з типу продукту Shopify)
  • Теги
  • SKU

🛒 Каталожний режим

Якщо ви використовуєте Botoscope в лише каталожному режимі (без оформлення замовлення WooCommerce), URL-адреси продуктів Shopify автоматично зберігаються під час синхронізації. Коли клієнт натискає кнопку “Деталі” в телеграм-магазині, він потрапляє безпосередньо на сторінку продукту у вашому магазині Shopify, щоб завершити покупку там.

Щоб увімкнути це:

  1. Перейдіть до Botoscope → Системні налаштування
  2. Увімкніть “Вимкнути кошик і оформлення замовлення”
  3. Увімкніть “Показати кнопку Переглянути на сайті”

✅ Найкращі практики

  • 🔄 Пересинхронізуйте після значних змін — якщо ви масово редагуєте продукти в Shopify, виконайте ручну синхронізацію, щоб оновити WooCommerce
  • 🔑 Зберігайте ваш токен безпечно — токен shpat_ не може бути відновлений, лише згенерований знову
  • 🧹 Очистіть кеш токенів при зміні магазинів — виконайте це у вашій базі даних, якщо ви змінюєте облікові дані магазину (для усунення несправностей):
DELETE FROM wp_options WHERE option_name = 'botoscope_shopify_access_token_cache';
  • 🏪 Один магазин на одну установку Botoscope — кожен сайт WordPress підключається до одного магазину Shopify
  • 📦 Варіанти стають змінними продуктами — багатоваріантні продукти Shopify повністю підтримуються

❓ Усунення несправностей

⚠️ Реєстрація вебхука не вдалася

  • Переконайтеся, що поле Токен доступу до API заповнено (не лише ID клієнта/Секрет)
  • Перевірте, що всі чотири обсяги увімкнені у вашому додатку Shopify
  • Якщо ви змінили облікові дані, очистіть кеш токенів (SQL команда вище) і спробуйте знову

Продукти не з’являються після синхронізації

  • Перевірте, що продукти Активні в Shopify (чернетки продуктів не імпортуються)
  • Переконайтеся, що розширення Shopify Синхронізація активовано на вкладці Розширення
  • Примітка: безкоштовний план підтримує до 9 продуктів (впорядкованих за порядком меню).

Замовлення не відправляються в Shopify

  • Перевірте, що обсяг write_orders увімкнено у ваших облікових даних додатка Shopify
0
Чудово! 
Помилка!