Centro de ayuda
Integraciones del chatbot

Integración con Shoper: AI Search, búsqueda en la tienda en tiempo real y estado del pedido

Última actualización:

Conecta tu chatbot de ChatLab con tu tienda Shoper para que los clientes puedan encontrar productos y consultar sus pedidos directamente en el chat. Los productos se encuentran mediante AI Search, que busca por significado en tu catálogo indexado de Shoper, o mediante la búsqueda en vivo en la tienda, que consulta la API de la tienda.

Ejemplo de conversación

Míralo en una conversación

Consulta un pedido

Requiere una tienda conectada y su acción de pedidos habilitada. Los campos disponibles dependen de la integración. La coincidencia de una dirección de correo no constituye prueba de identidad.

Ejemplo de ChatLabConversación ilustrativa

Visitante: ¿Dónde está mi pedido?

Reproduce el ejemplo o léelo abajo. No se utilizan datos reales de clientes.
1 / 5

El cliente pregunta por un pedido existente.

La reproducción se pausa cuando este ejemplo sale de la pantalla. Esto es una simulación, no un chat en vivo. Los controles del widget dentro de la reproducción no son interactivos.
Leer el ejemplo completo
  1. El cliente pregunta por un pedido existente.

    Visitante: ¿Dónde está mi pedido?

  2. La búsqueda predeterminada necesita ambos identificadores.

    Asistente: Por favor, indícame tu número de pedido y la dirección de correo utilizada en el pago.

  3. Usa datos ficticios en este ejemplo.

    Visitante: 41982, anna@example.com

  4. La acción consulta la tienda conectada.

    Comprobando el pedido 41982...

  5. Comunica únicamente la información devuelta por la tienda.

    Asistente: El pedido 41982 figura como enviado. La empresa de transporte es DPD. Por favor, consulta la página de seguimiento para ver las actualizaciones de entrega.

El ejemplo ilustra la experiencia del cliente. Las acciones disponibles y la información devuelta dependen de esta integración y de tu configuración.

Importante: mejores prácticas para e-commerce

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

Cómo encuentra productos el chatbot en Shoper: AI Search y búsqueda en vivo en la tienda

Hay dos formas en las que un chatbot de ChatLab encuentra productos en una tienda de Shoper. El chatbot utiliza una u otra, nunca ambas.

AI Search (recomendado) - ChatLab mantiene su propio índice de tu catálogo de Shoper y el chatbot busca en él por significado.

  • Los clientes preguntan en lenguaje natural, por ejemplo "un vestido rojo por menos de 300". El rango de precios se aplica como un filtro estricto y también se cotejan códigos de producto exactos (SKU, EAN).
  • El precio, el stock y las variantes se leen en vivo desde Shoper en el momento de responder, por lo que los clientes ven datos actualizados incluso entre actualizaciones del índice.
  • Los resultados aparecen como tarjetas de producto en el chat, hasta 5 por respuesta.
  • La indexación se inicia automáticamente al conectar la tienda. El catálogo no consume caracteres de entrenamiento.
  • Plan que necesitas: todos los planes E-commerce lo incluyen (Free 100 productos, Start 2.000, Grow 5.000, Scale 20.000). En un plan Universal, añade el complemento de integraciones de E-commerce ($30 al mes) más un paquete de productos de AI Search ($29 al mes, 5.000 productos) asignado al chatbot.

Búsqueda en vivo en la tienda - el chatbot envía la frase del cliente a la búsqueda de Shoper a través de la API de la tienda y responde con lo que la tienda devuelve.

  • No se indexa nada ni hay que sincronizar nada. Los datos están siempre en vivo.
  • Es una búsqueda por palabras clave: encuentra lo que la propia búsqueda de tu tienda encontraría para esa frase. No entiende descripciones de una necesidad, sinónimos ni errores tipográficos como lo hace AI Search.
  • Plan que necesitas: un plan Universal con el complemento de integraciones de E-commerce ($30 al mes). No se necesita ningún paquete de productos.

Cuando AI Search está activado, sustituye a la búsqueda en vivo en la tienda. El estado del pedido funciona igual en ambas vías. Una tercera opción, el entrenamiento mediante páginas escaneadas de la tienda, está disponible en cualquier plan y está pensada para contenido informativo como entregas y devoluciones, no para productos. Para una comparación completa consulta AI Search: cómo encuentra productos tu chatbot, y para los límites de productos consulta Planes y límites de E-commerce.

Qué ofrece la integración

Búsqueda en la tienda en tiempo real (búsqueda de productos por frase) - El chatbot envía la frase del cliente al buscador de Shoper. Realiza búsquedas en los nombres de los productos mediante coincidencia aproximada y devuelve hasta 10 productos coincidentes con:

  • Nombre y descripción del producto
  • Precio y SKU
  • Enlace directo a la página del producto en tu tienda
  • Imagen del producto
  • Estado del stock
  • Opcional: archivos adjuntos del producto (PDF, documentos)

También puedes activar el filtro de productos en stock para mostrar solo los artículos disponibles actualmente.

Order Details (detalles del pedido) - Los clientes pueden consultar el estado de su pedido indicando el ID del pedido y la dirección de correo electrónico asociada al mismo. Ambos datos se validan con los registros de tu tienda Shoper. El chatbot devuelve:

  • ID del pedido, fecha y estado actual
  • Total del pedido y moneda
  • Artículos del pedido con nombres, cantidades y precios
  • Dirección de entrega (calle, ciudad, código postal, país, teléfono)
  • Dirección de facturación
  • Notas del pedido

Dos formas de conectar tu tienda

Hay dos formas de conectar Shoper a ChatLab:

  • Método 1: Aplicación de ChatLab desde la Shoper App Store (recomendado) - instalación en un solo clic. La aplicación crea la conexión, habilita la búsqueda de productos y los detalles de los pedidos, y añade el widget de chat a tu tienda. No necesitas copiar claves de API.
  • Método 2: Configuración manual - creas un administrador de WebAPI en Shoper e introduces sus credenciales en ChatLab. Utilízalo solo si no puedes instalar la aplicación o si deseas conectar la tienda a un chatbot que gestionas de una manera específica.

Elige un método. No crees una segunda conexión con el Método 2 si la aplicación ya ha conectado la tienda.

Método 1: Instala la aplicación ChatLab desde la Shoper App Store

La aplicación gratuita de ChatLab en la Shoper App Store es la forma más rápida de empezar. No necesitas tener una cuenta previa en ChatLab ni un chatbot: ambos se crean para ti durante la instalación.

  1. En tu panel de administración de Shoper, ve a Add-ons and integrations > Applications (Complementos e integraciones > Aplicaciones), busca ChatLab - AI Chatbot for Customer Support and Sales e instálalo
  2. Abre la aplicación ChatLab en tu panel de Shoper: el panel de ChatLab se abrirá en una ventana nueva
  3. Establece tu contraseña (para una cuenta nueva) o inicia sesión con tu cuenta actual de ChatLab
  4. Si empezaste en el asistente de configuración del chatbot, confirma la vinculación de la tienda a ese chatbot; de lo contrario, se creará un chatbot para la tienda en tu cuenta
  5. Elige un plan o quédate en el plan gratuito; puedes mejorarlo más adelante en Account > Subscription (Cuenta > Suscripción)

Eso es todo. La tienda está conectada, las acciones de búsqueda de productos y detalles del pedido están activadas, y el chatbot aparecerá en tu tienda tan pronto como se complete la conexión. Continúa con Configurar acciones de Shoper más abajo para revisar las acciones, o abre Test & Deploy > Shoper (Probar e implementar > Shoper) en ChatLab para volver a ver los mismos pasos de instalación.

Método 2: Configuración manual

Usa este método cuando no puedas instalar la app. Antes de empezar, asegúrate de que:

  • Tu suscripción de ChatLab incluye la integración con Shoper
  • Tienes acceso al panel de administración de Shoper
  • Tu chatbot ya está creado en ChatLab

La configuración manual solo conecta los datos de la tienda. El widget de chat debe añadirse a tu tienda online por separado; consulta Instalar el chatbot en tu tienda Shoper al final de este artículo.

Paso 1: Crear un grupo de administradores

  1. En tu panel de administración de Shoper, ve a Settings > Store administrators (Configuración > Administradores de la tienda)

Panel de administración de Shoper mostrando la página de grupos de administradores|width=19

  1. Haz clic en MORE (Más) > Add administrators group (Añadir grupo de administradores)

Botón para añadir grupo en la página de grupos de administradores|width=60

  1. Introduce un nombre para el grupo (por ejemplo, "ChatLab Integration"), selecciona el tipo de acceso: 'access to webapi' (acceso a webapi) y guarda los cambios

Formulario para añadir grupo de administradores|width=60

Paso 2: Configurar los permisos del grupo

  1. Abre el grupo recién creado y ve a la configuración de permisos
  2. Concede acceso de lectura (Read) a los siguientes recursos:
    • Sales (Ventas) - lectura
    • Catalog (Catálogo) - lectura
    • Configuration (Configuración) - lectura

Configuración de permisos del grupo mostrando los permisos de lectura requeridos|width=60

Paso 3: Añadir un administrador de API

  1. Ve a Administrators (Administradores) y haz clic en Add administrator (Añadir administrador)

Página de administradores con el botón de añadir administrador|width=60

  1. Rellena el usuario y la contraseña, y asigna el administrador al grupo creado en el paso 1

Formulario para añadir administrador con campos de usuario, contraseña y selección de grupo|width=40

  1. Guarda el administrador. Anota el usuario (login) y la contraseña (password); los necesitarás en el siguiente paso.

Paso 4: Conectar Shoper en ChatLab

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

Pestaña Connect mostrando la tarjeta de integración de Shoper

  1. Haz clic en Connect en la tarjeta de Shoper
  2. Introduce tu Shop URL (el dominio de tu tienda Shoper, por ejemplo, myshop.shoper.pl)
  3. Introduce tu WebAPI Login (del paso 3)
  4. Introduce tu WebAPI Password (del paso 3)

Formulario de integración de Shoper con campos de URL de tienda, usuario y contraseña

  1. Haz clic en Initialize Configuration (Inicializar configuración) - esto obtiene los idiomas disponibles de tu tienda
  2. Selecciona el idioma correcto de la tienda en el desplegable Shop Language (esto determina qué versión de idioma de los datos del producto se devuelve)
  3. Haz clic en Connect

ChatLab comprueba la conexión automáticamente realizando una búsqueda de productos de prueba. Si se realiza con éxito, verás un mensaje de confirmación y tanto la búsqueda de productos como la consulta del estado del pedido quedarán activadas por defecto.

Configurar las acciones de Shoper

Tras conectarte mediante cualquiera de los dos métodos, puedes activar y personalizar acciones de IA individuales. Ve a Settings > Actions (Ajustes > Acciones) y filtra por la plataforma Shoper.

Acciones de Shoper en Settings que muestran la búsqueda de productos y los detalles del pedido

Entre las acciones estándar se incluyen:

  • Shoper - product search - permite que el chatbot busque en tu catálogo de productos
  • Shoper - order details - permite que el chatbot consulte información sobre los pedidos

La configuración de la conexión activa las acciones estándar. Revisa su estado y desactiva las que no quieras que usen los clientes. Abre una acción para editarla y luego usa Enable (Activar) o Update (Actualizar) en su cuadro de diálogo. 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 el modo en que la IA utiliza cada acción.

Para la búsqueda de productos, haz clic en el botón Edit (Editar) y ve a la pestaña Product Search Settings (Ajustes de búsqueda de productos). Hay dos opciones adicionales disponibles:

  • Include product attachments - al activarse, el chatbot incluye archivos adjuntos del producto (archivos PDF, documentos) en los resultados de búsqueda
  • Products in stock only - al activarse, el chatbot solo devuelve productos que están actualmente en stock

Product Search Settings que muestra las opciones de filtro de archivos adjuntos y de stock

AI Search para Shoper: catálogo, reindexación y ajustes

En un plan E-commerce, o en un plan Universal cuando se asigna un paquete de productos de AI Search al chatbot, AI Search está activo y sustituye a la búsqueda en vivo en la tienda. La indexación se inicia automáticamente al conectar la tienda.

  • Comprueba el catálogo - abre Training > E-commerce catalog (Entrenamiento > Catálogo de e-commerce) y revisa las pestañas Products (Productos) y Categories (Categorías). En Shop > Products (Tienda > Productos) verás el panel Product catalog (Catálogo de productos) y la tarjeta AI Search packs on this chatbot (Paquetes de AI Search en este chatbot).
  • Programa la reindexación - usa Schedule auto-retrain (Programar autoentrenamiento) en Training > E-commerce catalog. La reindexación puede ejecutarse incluso a diario y está disponible en todos los planes E-commerce y con cualquier paquete de productos. Train now (Entrenar ahora) o Retrain (Reentrenar) la ejecuta bajo demanda. Las actualizaciones son incrementales: se omiten los productos sin cambios y se eliminan del índice los productos borrados.
  • Revisa la acción - en Settings > Actions (Ajustes > Acciones), abre Shoper - AI product search. Sus opciones son Include product card, Products in stock only y Number of products to return.
  • Muestra fichas de producto - activa Enable Offer Cards en Settings > Model & Advanced (Ajustes > Modelo y avanzado). Consulta Offer Cards.

Si el catálogo supera el límite de productos, la indexación se detiene al alcanzar el límite y el propietario del chatbot recibe un correo electrónico. Las opciones de la acción de búsqueda en vivo en la tienda descritas anteriormente no se aplican necesariamente a AI Search.

Cómo probar tu integración

Tras activar las acciones, abre Test & Deploy (Probar e implementar) y prueba con:

  • "Muéstrame zapatillas de running" (prueba la búsqueda de productos)
  • "¿Cuál es el estado de mi pedido 12345?" (prueba los detalles del pedido; proporciona el correo electrónico correspondiente a un pedido al que tengas autorización para acceder)

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

Instala el chatbot en tu tienda de Shoper

Si has usado el Método 1 (la aplicación), el widget de chat ya está en tu tienda y no tienes que añadir nada más. Si has usado el Método 2 (configuración manual), abre Test & Deploy > Shoper (Probar e implementar > Shoper) en ChatLab, cambia a Manual Installation (Instalación manual), copia el código y pégalo en el panel de administración de Shoper, en Add-ons and integrations > Custom integrations (Complementos e integraciones > Integraciones personalizadas), dentro del campo Page header (Encabezado de página). Consulta Cómo añadir un chatbot a tu sitio web para ver todos los detalles.

Artículos relacionados