Sincronización de comercio externo

Resumen

Canales e integraciones → Comercio externo (/es/integrations/commerce) mantiene el proceso de pago en Shopify o WooCommerce mientras refleja datos compatibles en OrderInChat. El widget, la IA de WhatsApp e Instagram, automatizaciones y etiquetas de envío opcionales usan los datos reflejados.

Esta integración no clona el tema fuente y no reemplaza el proceso de pago externo.

Conexión de Shopify

OrderInChat utiliza OAuth de Shopify, por lo que no tienes que copiar tokens manualmente.

1. En el panel de socios de Shopify, crea una aplicación llamada Order in Chat.
2. Agrega la URL de callback https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback a URL(s) de redirección permitidas.
3. Concede estos alcances de API de administrador: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. En OrderInChat, ve a Canales e integraciones → Comercio externo, elige Shopify, ingresa la URL de la tienda HTTPS (por ejemplo, https://your-store.myshopify.com) y haz clic en Conectar con Shopify.
5. Aprueba los permisos en Shopify. Regresarás automáticamente a OrderInChat. Luego haz clic en Probar conexión, Registrar webhooks y Sincronizar ahora.

Si no puedes usar OAuth, expande la sección Configuración manual de tokens y pega el token de acceso de la API de administrador y la clave secreta de la API de la aplicación personalizada. La clave secreta de la API es necesaria para verificar las firmas HMAC de los webhooks de Shopify. OrderInChat cifra las credenciales y nunca las muestra nuevamente.

Guías oficiales: Aplicaciones personalizadas de Shopify y Tokens de acceso de la API de administrador.

Conexión de WooCommerce

En WordPress, abre WooCommerce → Configuración → Avanzado → REST API, crea una clave con permiso de lectura para sincronización solo de espejo, o permiso de lectura/escritura si los cambios del Editor en masa deben escribirse de nuevo en WooCommerce, e ingresa la URL de la tienda HTTPS, la clave del consumidor y la clave secreta del consumidor. Para sincronizar páginas y publicaciones de WordPress, también ingresa un nombre de usuario de WordPress y Contraseña de aplicación de Usuarios → Perfil.

Guía oficial: API REST de WooCommerce.

Algunos hosts rechazan la autenticación HTTP básica. El conector puede reintentar solicitudes de WooCommerce con autenticación de cadena de consulta; las credenciales se ocultan de los registros.

Comportamiento de sincronización

1. Guarda y prueba la conexión.
2. Registrar webhooks — crea suscripciones en la tienda externa para que los cambios en productos, pedidos y clientes notifiquen a OrderInChat casi en tiempo real. OrderInChat también comprueba los cambios de forma periódica por si se pierde un webhook.
3. Selecciona los recursos a reflejar.
4. Ejecuta la sincronización inicial.

Por seguridad, OrderInChat verifica cada webhook y vuelve a comprobar los datos con Shopify o WooCommerce antes de guardarlos. Las comprobaciones periódicas detectan los webhooks perdidos solo mientras Use como fuente de comercio esté habilitado. Si el estado del webhook muestra un error y la conexión está inactiva, utiliza Registrar webhooks y Sincronizar ahora después de realizar cambios en la tienda fuente; Probar conexión por sí solo no actualiza productos. Las actualizaciones repetidas no crean registros duplicados.

El peso de envío de las variantes de Shopify se importa del peso de la variante en Shopify; el editor de productos lo muestra en la unidad de peso configurada de la tienda. Los metafields de dimensión llamados length, width o height se convierten a centímetros. Las descripciones de productos de Shopify provienen de la descripción propia del producto, no de secciones o banners de tema compartidos; el texto del tema no se convierte en una descripción específica del producto. Los productos en borrador y archivados no se muestran a los clientes.

Cuando tu tienda usa comercio externo, los clientes compran a través de la URL del producto fuente. El pago del carrito de OrderInChat y los flujos de pago de WhatsApp están desactivados para esa tienda.

Ubicaciones de inventario

Las ubicaciones de Shopify y los niveles de inventario por variante se reflejan en registros de almacén/ubicación de OrderInChat. El stock de productos y variantes muestra el total de todas las ubicaciones para chat y pago. El núcleo de WooCommerce expone un valor total de stock, por lo que se refleja en una ubicación virtual predeterminada; el stock en varias ubicaciones de plugins de WooCommerce requiere un plugin compatible.

Puedes agregar tus propias ubicaciones de OrderInChat en Catálogo → Inventario. Las celdas de stock del Editor en masa se expanden por ubicación. Enviar inventario a Shopify actualiza solo la ubicación seleccionada y requiere el permiso write_inventory. Los campos de stock bloqueados no se sobrescriben con una sincronización de inventario posterior.

Etiquetas de envío

Las etiquetas de envío de OrderInChat están desactivadas por defecto. Actívalas solo si OrderInChat debe ser el único lugar donde se crean etiquetas. Incluso cuando están habilitadas, OrderInChat no compra una etiqueta cuando el pedido externo ya tiene información de cumplimiento o seguimiento.

Fragmento de widget

Shopify: Registrar webhooks también intenta instalar automáticamente el widget de chat en tu tienda de Shopify. Aún puedes pegar el fragmento en Liquid personalizado si es necesario. Concede write_script_tags en la aplicación personalizada si la instalación automática falla.

WooCommerce: La API REST no puede inyectar scripts de tema. Copia el fragmento de JavaScript o PHP de la página de integración en el pie de página del tema o en functions.php.

Páginas → Base de conocimientos

Cuando Páginas y publicaciones está habilitado, las páginas/artículos/políticas de Shopify y las páginas/publicaciones de WooCommerce se agregan (o se actualizan) en la base de conocimientos de OrderInChat para respuestas de IA. Los títulos de políticas coincidentes de Shopify también llenan los campos de tienda de devoluciones/términos. Esto no es una clonación completa de tema/CMS.

Limitaciones de la API

La integración informa datos no soportados o no disponibles en lugar de inventar valores. Las limitaciones comunes incluyen:

• Shopify no expone todas las configuraciones de pago a través de la API de administrador.
• Los precios de envío calculados por el transportista permanecen calculados en el proceso de pago externo.
• La REST de WooCommerce no incluye páginas de WordPress sin una Contraseña de Aplicación de WordPress.
• Las reseñas y reservas requieren una API de plataforma o aplicación que exponga esos recursos.
• Los complementos de productos se reflejan solo cuando la API fuente tiene un equivalente real.