Integración con Shopify

Conecta tu chatbot de ChatLab con tu tienda Shopify para ofrecer a tus clientes acceso en tiempo real a la información de productos y al seguimiento de pedidos directamente en el chat.

Importante: mejores prácticas de e-commerce

Tras completar la integración descrita a continuación, consulta la guía completa sobre cómo optimizar tu chatbot para e-commerce: Cómo configurar ChatLab para tu tienda de e-commerce

Qué ofrece la integración

Búsqueda de productos - Los clientes pueden buscar en tu catálogo de Shopify escribiendo una frase. El chatbot busca en títulos de productos, descripciones, tipos, etiquetas y proveedores, mostrando los productos activos coincidentes con:

• Nombre del producto, descripción y tipo
• Proveedor y etiquetas
• Precio o rango de precios (para productos con múltiples variantes)
• Variantes disponibles con SKU, precio comparativo, cantidad en inventario y estado de disponibilidad
• Imagen del producto y enlace directo a tu tienda

Puedes configurar la búsqueda de productos para mostrar solo aquellos con stock. Al activarlo, los artículos agotados se excluyen de los resultados. Una opción adicional te permite incluir productos disponibles para reserva (pre-order) incluso cuando el filtro de stock está activo. Consulta el Paso 4 para más detalles.

Detalles del pedido - Los clientes pueden consultar el estado de su pedido indicando su número de pedido y dirección de correo electrónico. Ambos datos se validan con los registros de tu tienda Shopify. El chatbot muestra:

• Referencia del pedido, fecha, total y moneda
• Artículos pedidos con nombres, cantidades, precios, SKU, título de la variante y proveedor
• Estado de preparación y datos de seguimiento (número, empresa de transporte, URL)
• Dirección de envío y dirección de facturación
• Método de envío y coste
• Datos de contacto del cliente (correo electrónico, nombre, teléfono)
• Motivo y fecha de cancelación (en pedidos cancelados)

Paso 1: Crear las credenciales de la API de Shopify

Importante para agencias y partners de Shopify: La aplicación de Shopify DEBE crearse en el Dev Dashboard de la organización propietaria de la tienda - empieza siempre desde el panel de administración de la propia tienda (Settings > Apps > Develop apps > Build apps in Dev Dashboard). Una aplicación creada por otra organización (por ejemplo, una agencia o partner de Shopify que trabaje en su propio Dev Dashboard) e instalada en la tienda mediante un enlace de instalación personalizado NO funcionará con ChatLab, aunque la instalación se complete con éxito y la aplicación aparezca entre las apps instaladas de la tienda con los permisos correctos. El motivo: ChatLab se conecta utilizando el Client ID y el Secret (concesión de credenciales de cliente de Shopify), y Shopify solo permite esta concesión para aplicaciones desarrolladas por la organización propietaria de la tienda - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (documentación de Shopify). Se trata de una limitación de Shopify, no de ChatLab. El síntoma es un error de conexión en ChatLab con el mensaje "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (provocado por el error OAuth shop_not_permitted de Shopify), incluso cuando el Client ID, el Secret y el subdominio de la tienda son correctos y la aplicación está instalada. Una señal inequívoca de una app procedente de otra organización: el panel de la tienda muestra "This custom app was built by a Shopify partner for your store." La solución para las agencias: no necesitas que lo haga el desarrollador del comerciante - pide al comerciante que añada tu usuario a SU organización con el rol de App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - documentación de Shopify), y luego crea la aplicación trabajando dentro de la organización del comerciante. El acceso de colaborador por sí solo no es suficiente: las aplicaciones creadas mientras trabajas en tu propia organización se quedan en tu organización.

1. Inicia sesión en tu panel de administración de Shopify
2. Ve a Settings > Apps
3. Haz clic en Develop apps
4. En la página de desarrollo de aplicaciones, haz clic en Build apps in Dev Dashboard - esto abrirá dev.shopify.com/dashboard
5. Haz clic en Create app e introduce un nombre (por ejemplo, "ChatLab Integration")

6. Una vez creada, desplázate hasta la sección Access y haz clic en Select scopes

7. En los alcances de acceso de Admin API, busca y activa estos permisos:
   • read_products
   • read_orders
8. Haz clic en Done

9. Haz clic en el botón Release para publicar tu aplicación
10. Ve a App settings y copia el Client ID y el Secret - guárdalos en un lugar seguro, los necesitarás para conectar con ChatLab

11. Ve a la sección Home y haz clic para instalar la aplicación en tu tienda

12. Selecciona tu tienda y confirma haciendo clic en Install

Paso 2: Localizar el subdominio de tu tienda

Tu subdominio es la parte que aparece antes de .myshopify.com en la URL de administración de Shopify. Por ejemplo, si tu URL de administración es https://pizza-delicious.myshopify.com/admin, tu subdominio es pizza-delicious.

Paso 3: Conectar Shopify en ChatLab

1. Inicia sesión en ChatLab y selecciona tu bot
2. Ve a la pestaña Connect (Conectar)

3. Haz clic en Connect (Conectar) en la tarjeta de Shopify
4. Introduce tu Client ID (del Paso 1)
5. Introduce tu Secret (del Paso 1)
6. Introduce tu Shopify subdomain (subdominio de Shopify, del Paso 2)

7. Haz clic en Connect (Conectar)

ChatLab comprobará automáticamente la conexión verificando que tus credenciales de API cuenten con los alcances de acceso requeridos. Si todo es correcto, verás un mensaje de confirmación.

Paso 4: Configurar las acciones de Shopify

Tras conectar la tienda, puedes habilitar y personalizar acciones individuales de IA. Ve a Settings > Actions (Ajustes > Acciones) y filtra por la plataforma Shopify.

Hay dos acciones disponibles:

• Shopify - product search - permite al chatbot buscar en tu catálogo de productos
• Shopify - order details - permite al chatbot consultar la información de los pedidos

Haz clic en el botón de activación de cada acción para habilitarla. También puedes personalizar la etiqueta de la acción (el mensaje que ven los usuarios mientras se ejecuta la acción) y las instrucciones que guían a la IA sobre cómo utilizar cada una.

Búsqueda de productos - Ajustes de inventario

La acción de búsqueda de productos incluye opciones de filtrado de inventario en su pestaña Product Search Settings (Ajustes de búsqueda de productos):

• Products in stock only (Solo productos en stock) - Al activarla, el chatbot solo muestra productos que actualmente tengan stock. Los productos agotados se excluyen de los resultados.
• Show products available for pre-order (Mostrar productos disponibles para reserva) - Esta opción aparece cuando se activa "Products in stock only". Al habilitarla, los productos que no tengan stock pero estén configurados para seguir vendiéndose en Shopify (reserva o pre-order) seguirán apareciendo en los resultados, marcados como disponibles para reserva.

Probar tu integración

Tras activar las acciones, abre el widget de tu chatbot y prueba con preguntas como:

• "Enséñame zapatillas de running" (prueba la búsqueda de productos)
• "¿Cuál es el estado de mi pedido #1001?" (prueba los detalles del pedido)

Comprueba que las respuestas coincidan con los datos de tu tienda Shopify y que los enlaces a los productos se abran correctamente.

Instalar el chatbot en tu tienda Shopify

Para añadir el widget de chat al escaparate de tu tienda Shopify:

1. En ChatLab, ve a la pestaña Deploy (Implementar) de tu bot
2. Selecciona la pestaña de plataforma Shopify
3. Copia el fragmento de código
4. En tu panel de administración de Shopify, ve a Online Store > Themes
5. Haz clic en el menú de tres puntos de tu tema activo y selecciona Edit code
6. Abre el archivo theme.liquid dentro de Layout
7. Pega el fragmento de código dentro de la sección <head>
8. Haz clic en Save

Para terminar, asegúrate de activar las acciones de IA disponibles para Shopify: Order details y Product Search.