🛍️ Sincronización de Shopify

La extensión de Sincronización de Shopify de Botoscope te permite conectar tu tienda Shopify existente a tu bot de Telegram. Los productos se importan automáticamente de Shopify a WooCommerce, y los pedidos realizados a través del bot se envían de vuelta a Shopify, manteniendo tu inventario y gestión de pedidos en un solo lugar.

✨ Características Clave

• 🔄 Sincronización automática de productos — importa todos los productos activos de Shopify a WooCommerce
• 📦 Envío de pedidos de vuelta — los pedidos del bot se envían de vuelta a Shopify automáticamente
• 🖼️ Sincronización de medios — las imágenes de los productos se importan junto con los productos
• 🏷️ Soporte de variantes — las variantes de productos de Shopify se convierten en productos variables de WooCommerce
• 🔔 Webhooks — actualizaciones en tiempo real cuando los productos se crean, actualizan o eliminan en Shopify
• 🛒 Modo catálogo listo — las URLs de productos de Shopify se almacenan para que los clientes puedan ser redirigidos a tu tienda Shopify para completar la compra (opcional)

🔧 Paso 1: Activa la Extensión

1. Ve a la pestaña de Extensiones en Botoscope
2. Encuentra Sincronización de Shopify y actívala ON
3. La pestaña de Sincronización de Shopify aparecerá en la navegación superior

🏪 Paso 2: Crea una App de Shopify

Botoscope se conecta a tu tienda Shopify a través de una App Personalizada Legada. Esto te da un token de API permanente — sin flujo OAuth, sin Panel de Socios, sin proceso de revisión.

Ve a tu Admin de Shopify:

https://admin.shopify.com/store/TU-TIENDA/settings/apps/development

Verás dos opciones. Haz clic en “Permitir desarrollo de app personalizada legada” — esto debe estar habilitado antes de que puedas crear la app.

💡 ¿Por qué legado? A partir de enero de 2026, Shopify movió todo el desarrollo de nuevas apps a su Panel de Desarrollo, que requiere aprobación de Datos de Cliente Protegidos para acceso a pedidos. Las Apps Personalizadas Legadas evitan este requisito por completo ya que la app es privada solo para tu tienda.

🔑 Paso 3: Configura los Permisos de la App

Después de habilitar el desarrollo legado, haz clic en “Crear una app” y completa con cualquier nombre (por ejemplo, Botoscope).

Luego ve a Credenciales de API → Alcances de acceso de Admin API y habilita:

Haz clic en Guardar y luego en Instalar app.

📋 Paso 4: Copia tus Credenciales

Después de la instalación, ve a Credenciales de API. Verás tres valores — cópialos todos:

⚠️ Importante: El token de acceso de Admin API se muestra solo una vez. Cópialo inmediatamente y guárdalo de forma segura — no puedes recuperarlo de nuevo sin reinstalar la app.

⚙️ Paso 5: Ingresa las Credenciales en Botoscope

Ve a Botoscope → pestaña Extensiones y completa:

💡 Consejo: Si el campo de Token de Acceso API está lleno, Botoscope lo usa directamente. El ID de Cliente y el Secreto solo se usan como respaldo si no se proporciona un token.

Haz clic en Guardar.

🔄 Paso 6: Sincroniza Productos

Ve a la pestaña Sincronización de Shopify y haz clic en “Sincronizar Productos” para importar todos los productos activos de tu tienda Shopify a WooCommerce.

La barra de progreso mostrará:

Se encontraron 42 productos. Sincronizando...
Sincronizados 42 de 42 productos. ¡Hecho!

Los productos se importan con:

• Título, descripción, precio
• Imágenes
• Variantes → productos variables de WooCommerce
• Categorías (del tipo de producto de Shopify)
• Etiquetas
• SKU

🛒 Modo Catálogo

Si usas Botoscope en modo solo catálogo (sin pago de WooCommerce), las URLs de productos de Shopify se almacenan automáticamente durante la sincronización. Cuando un cliente toca el botón “Detalles” en la tienda de Telegram, se le lleva directamente a la página del producto en tu tienda Shopify para completar la compra allí.

Para habilitar esto:

1. Ve a Botoscope → Controles del Sistema
2. Habilita “Desactivar carrito y pago”
3. Habilita “Mostrar botón Ver en el Sitio Web”

✅ Mejores Prácticas

• 🔄 Re-sincroniza después de cambios importantes — si editas productos en masa en Shopify, ejecuta una sincronización manual para actualizar WooCommerce
• 🔑 Guarda tu token de forma segura — el token shpat_ no se puede recuperar, solo regenerar
• 🧹 Limpia la caché del token si cambias de tienda — ejecuta esto en tu base de datos si cambias las credenciales de la tienda (para solucionar problemas):

DELETE FROM wp_options WHERE option_name = 'botoscope_shopify_access_token_cache';

• 🏪 Una tienda por instalación de Botoscope — cada sitio de WordPress se conecta a una tienda Shopify
• 📦 Las variantes se convierten en productos variables — los productos de Shopify con múltiples variantes son totalmente compatibles

❓ Solución de Problemas

⚠️ Fallo en el registro de Webhook

• Asegúrate de que el campo de Token de Acceso API esté lleno (no solo ID/Secreto de Cliente)
• Verifica que los cuatro alcances estén habilitados en tu app de Shopify
• Si cambiaste las credenciales, limpia la caché del token (comando SQL arriba) e intenta de nuevo

Productos no aparecen después de la sincronización

• Verifica que los productos estén Activos en Shopify (los productos en borrador no se importan)
• Asegúrate de que la extensión de Sincronización de Shopify esté activada en la pestaña de Extensiones
• Nota: el plan gratuito admite hasta 9 productos (ordenados por orden de menú).

Pedidos no enviados a Shopify

• Verifica que el alcance write_orders esté habilitado en las credenciales de tu app de Shopify