🛍️ Shopify Sync

Rozszerzenie Shopify Sync od Botoscope pozwala na połączenie istniejącego sklepu Shopify z Twoim botem Telegram. Produkty są automatycznie importowane z Shopify do WooCommerce, a zamówienia złożone przez bota są przesyłane z powrotem do Shopify — utrzymując zarządzanie zapasami i zamówieniami w jednym miejscu.

✨ Kluczowe funkcje

• 🔄 Automatyczna synchronizacja produktów — importuj wszystkie aktywne produkty Shopify do WooCommerce
• 📦 Przesyłanie zamówień z powrotem — zamówienia z bota są automatycznie przesyłane z powrotem do Shopify
• 🖼️ Synchronizacja mediów — obrazy produktów są importowane wraz z produktami
• 🏷️ Wsparcie dla wariantów — warianty produktów Shopify stają się zmiennymi produktami WooCommerce
• 🔔 Webhooks — aktualizacje w czasie rzeczywistym, gdy produkty są tworzone, aktualizowane lub usuwane w Shopify
• 🛒 Tryb katalogowy gotowy — adresy URL produktów Shopify są przechowywane, aby klienci mogli zostać przekierowani do Twojego sklepu Shopify w celu dokończenia zakupu (opcjonalnie)

🔧 Krok 1: Aktywuj rozszerzenie

1. Przejdź do zakładki Rozszerzenia w Botoscope
2. Znajdź Shopify Sync i przełącz na WŁĄCZONY
3. Zakładka Shopify Sync pojawi się w górnej nawigacji

🏪 Krok 2: Utwórz aplikację Shopify

Botoscope łączy się z Twoim sklepem Shopify za pomocą Legacy Custom App. Daje to stały token API — bez przepływu OAuth, bez Partner Dashboard, bez procesu przeglądu.

Przejdź do panelu administracyjnego Shopify:

https://admin.shopify.com/store/TWOJ-SKLEP/settings/apps/development

Zobaczysz dwie opcje. Kliknij “Zezwól na rozwój aplikacji niestandardowych legacy” — to musi być włączone, zanim będziesz mógł utworzyć aplikację.

💡 Dlaczego legacy? Od stycznia 2026 roku Shopify przeniosło cały nowy rozwój aplikacji do swojego Dev Dashboard, który wymaga zatwierdzenia Protected Customer Data dla dostępu do zamówień. Legacy Custom Apps całkowicie omijają to wymaganie, ponieważ aplikacja jest prywatna tylko dla Twojego sklepu.

🔑 Krok 3: Skonfiguruj uprawnienia aplikacji

Po włączeniu rozwoju legacy, kliknij “Utwórz aplikację” i wypełnij dowolną nazwę (np. Botoscope).

Następnie przejdź do API credentials → Admin API access scopes i włącz:

Kliknij Zapisz, a następnie Zainstaluj aplikację.

📋 Krok 4: Skopiuj swoje dane uwierzytelniające

Po instalacji przejdź do API credentials. Zobaczysz trzy wartości — skopiuj wszystkie:

⚠️ Ważne: Token dostępu Admin API jest wyświetlany tylko raz. Skopiuj go natychmiast i przechowuj bezpiecznie — nie możesz go odzyskać bez ponownej instalacji aplikacji.

⚙️ Krok 5: Wprowadź dane uwierzytelniające w Botoscope

Przejdź do Botoscope → zakładka Rozszerzenia i wypełnij:

💡 Wskazówka: Jeśli pole Token dostępu API jest wypełnione, Botoscope używa go bezpośrednio. ID klienta i tajny klient są używane tylko jako zapas, jeśli nie podano tokenu.

Kliknij Zapisz.

🔄 Krok 6: Synchronizuj produkty

Przejdź do zakładki Shopify Sync i kliknij “Synchronizuj produkty”, aby zaimportować wszystkie aktywne produkty z Twojego sklepu Shopify do WooCommerce.

Pasek postępu pokaże:

Znaleziono 42 produkty. Synchronizacja...
Zsynchronizowano 42 z 42 produktów. Gotowe!

Produkty są importowane z:

• Tytuł, opis, cena
• Obrazy
• Warianty → zmienne produkty WooCommerce
• Kategorie (z typu produktu Shopify)
• Tagi
• SKU

🛒 Tryb katalogowy

Jeśli używasz Botoscope w trybie tylko katalogowym (bez kasy WooCommerce), adresy URL produktów Shopify są automatycznie przechowywane podczas synchronizacji. Gdy klient naciśnie przycisk “Szczegóły” w sklepie telegram, zostanie bezpośrednio przeniesiony na stronę produktu w Twoim sklepie Shopify, aby tam dokończyć zakup.

Aby to włączyć:

1. Przejdź do Botoscope → Kontrola systemu
2. Włącz “Wyłącz koszyk i kasę”
3. Włącz “Pokaż przycisk Zobacz na stronie”

✅ Najlepsze praktyki

• 🔄 Ponowna synchronizacja po dużych zmianach — jeśli masowo edytujesz produkty w Shopify, uruchom ręczną synchronizację, aby zaktualizować WooCommerce
• 🔑 Przechowuj swój token bezpiecznie — token shpat_ nie może być odzyskany, tylko zregenerowany
• 🧹 Wyczyść pamięć podręczną tokenów, jeśli zmieniasz sklepy — uruchom to w swojej bazie danych, jeśli zmieniasz dane uwierzytelniające sklepu (do rozwiązywania problemów):

DELETE FROM wp_options WHERE option_name = 'botoscope_shopify_access_token_cache';

• 🏪 Jeden sklep na instalację Botoscope — każda strona WordPress łączy się z jednym sklepem Shopify
• 📦 Warianty stają się zmiennymi produktami — produkty wielowariantowe Shopify są w pełni obsługiwane

❓ Rozwiązywanie problemów

⚠️ Rejestracja webhooków nie powiodła się

• Upewnij się, że pole Token dostępu API jest wypełnione (nie tylko ID klienta/tajny klient)
• Sprawdź, czy wszystkie cztery zakresy są włączone w Twojej aplikacji Shopify
• Jeśli zmieniłeś dane uwierzytelniające, wyczyść pamięć podręczną tokenów (komenda SQL powyżej) i spróbuj ponownie

Produkty nie pojawiają się po synchronizacji

• Sprawdź, czy produkty są Aktywne w Shopify (produkty w wersji roboczej nie są importowane)
• Upewnij się, że rozszerzenie Shopify Sync jest aktywowane w zakładce Rozszerzenia
• Uwaga: darmowy plan obsługuje do 9 produktów (uporządkowanych według kolejności w menu).

Zamówienia nie są przesyłane do Shopify

• Zweryfikuj, czy zakres write_orders jest włączony w danych uwierzytelniających Twojej aplikacji Shopify