🛍️ Shopify Sync

Botoscope’s Shopify Sync extension lets you connect your existing Shopify store to your Telegram bot. Products are imported from Shopify into WooCommerce automatically, and orders placed through the bot are pushed back to Shopify — keeping your inventory and order management in one place.

✨ Key Features

• 🔄 Automatic product sync — import all active Shopify products into WooCommerce
• 📦 Order push-back — orders from the bot are sent back to Shopify automatically
• 🖼️ Media sync — product images are imported along with products
• 🏷️ Variants support — Shopify product variants become WooCommerce variable products
• 🔔 Webhooks — real-time updates when products are created, updated, or deleted in Shopify
• 🛒 Catalog mode ready — Shopify product URLs are stored so customers can be redirected to your Shopify store to complete checkout (optional)

🔧 Step 1: Activate the Extension

1. Go to the Extensions tab in Botoscope
2. Find Shopify Sync and toggle it ON
3. The Shopify Sync tab will appear in the top navigation

🏪 Step 2: Create a Shopify App

Botoscope connects to your Shopify store via a Legacy Custom App. This gives you a permanent API token — no OAuth flow, no Partner Dashboard, no review process.

Go to your Shopify Admin:

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

You will see two options. Click “Allow legacy custom app development” — this must be enabled before you can create the app.

💡 Why legacy? As of January 2026, Shopify moved all new app development to their Dev Dashboard which requires Protected Customer Data approval for order access. Legacy Custom Apps bypass this requirement entirely since the app is private to your store only.

🔑 Step 3: Configure App Permissions

After enabling legacy development, click “Create an app” and fill in any name (e.g. Botoscope).

Then go to API credentials → Admin API access scopes and enable:

Click Save and then Install app.

📋 Step 4: Copy Your Credentials

After installation, go to API credentials. You will see three values — copy all of them:

⚠️ Important: The Admin API access token is shown only once. Copy it immediately and store it safely — you cannot retrieve it again without reinstalling the app.

⚙️ Step 5: Enter Credentials in Botoscope

Go to Botoscope → tab Extensions and fill in:

💡 Tip: If the API Access Token field is filled, Botoscope uses it directly. The Client ID and Secret are only used as a fallback if no token is provided.

Click Save.

🔄 Step 6: Sync Products

Go to tab Shopify Sync and click “Sync Products” to import all active products from your Shopify store into WooCommerce.

The progress bar will show:

Found 42 products. Syncing...
Synced 42 of 42 products. Done!

Products are imported with:

• Title, description, price
• Images
• Variants → WooCommerce variable products
• Categories (from Shopify product type)
• Tags
• SKU

🛒 Catalog Mode

If you use Botoscope in catalog-only mode (no WooCommerce checkout), Shopify product URLs are stored automatically during sync. When a customer taps the “Details” button in the telegram store, they are taken directly to the product page on your Shopify store to complete the purchase there.

To enable this:

1. Go to Botoscope → System Controls
2. Enable “Disable cart and checkout”
3. Enable “Show View on Website button”

✅ Best Practices

• 🔄 Re-sync after major changes — if you bulk-edit products in Shopify, run a manual sync to update WooCommerce
• 🔑 Store your token safely — the shpat_ token cannot be recovered, only regenerated
• 🧹 Clear token cache if switching stores — run this in your database if you change store credentials (for troubleshooting):

DELETE FROM wp_options WHERE option_name = 'botoscope_shopify_access_token_cache';

• 🏪 One store per Botoscope install — each WordPress site connects to one Shopify store
• 📦 Variants become variable products — multi-variant Shopify products are fully supported

❓ Troubleshooting

⚠️ Webhook registration failed

• Make sure the API Access Token field is filled in (not just Client ID/Secret)
• Check that all four scopes are enabled in your Shopify app
• If you changed credentials, clear the token cache (SQL command above) and try again

Products not appearing after sync

• Check that products are Active in Shopify (draft products are not imported)
• Make sure the Shopify Sync extension is activated in Extensions tab
• Note: the free plan supports up to 9 products (ordered by menu order).

Orders not pushed to Shopify

• Verify write_orders scope is enabled in your Shopify app credentials