Centro de ayuda
Integraciones del chatbot

Integración con CS-Cart: AI Search, búsqueda en vivo en la tienda y estado del pedido

Última actualización:

Conecta tu chatbot de ChatLab con tu tienda CS-Cart para que los clientes puedan encontrar productos y consultar sus pedidos directamente en el chat. Los productos se encuentran mediante AI Search, que busca en tu catálogo indexado de CS-Cart según el significado, o mediante la búsqueda en vivo en la tienda, que consulta la API de la tienda. La forma más rápida de conectarse es mediante el complemento de ChatLab para CS-Cart, que también añade el widget de chat a tu escaparate. Conectarse manualmente con una clave de API sigue disponible como alternativa.

Conversación de ejemplo

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.

Antes de empezar

Crea o selecciona primero un chatbot. Necesitas permisos para gestionar sus integraciones y acceso a los ajustes de conexión de la cuenta externa. Si la casilla Connect (Conectar) muestra un aviso de mejora de plan o de contacto, comprueba que tu suscripción incluya esta integración. Mantén la privacidad de las credenciales de la API; nunca las pegues en el código incrustado del sitio web.

Para el complemento, necesitas CS-Cart 4.18.1 o posterior y una cuenta de administrador de CS-Cart que tenga permiso para instalar complementos y gestionar administradores y grupos de usuarios. El complemento está diseñado para la edición estándar de CS-Cart, no para Multi-Vendor.

Importante: Buenas prácticas para E-commerce

Después de completar la integración siguiente, 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 CS-Cart: 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 CS-Cart. El chatbot utiliza una o la otra, nunca ambas.

AI Search (recomendado) - ChatLab mantiene su propio índice de tu catálogo de CS-Cart 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 los códigos de producto exactos (SKU, EAN).
  • El precio, el stock y las variantes se leen en vivo desde CS-Cart en el momento de responder, por lo que los clientes ven datos actualizados incluso entre las actualizaciones del índice.
  • Los resultados aparecen como fichas 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 necesario: 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 CS-Cart a través de la API de la tienda y responde con lo que devuelve la tienda.

  • No se indexa nada y no es necesario mantener nada sincronizado. Los datos siempre están 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 comprende descripciones de necesidades, sinónimos ni erratas de la misma manera que AI Search.
  • Plan necesario: un plan Universal con el complemento de integraciones de E-commerce ($30 al mes). No se requiere 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 de la misma manera en ambos métodos. Una tercera opción, el entrenamiento sobre páginas escaneadas de la tienda, está disponible en cualquier plan y está pensada para contenido informativo como envíos 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 vivo en la tienda (búsqueda de productos por frase) - El chatbot envía la frase del cliente a la búsqueda de CS-Cart y devuelve los productos coincidentes con:

  • Nombre y descripción del producto
  • Precio
  • SKU (código de producto)
  • Enlace directo al producto en tu tienda
  • Imagen del producto
  • Variantes disponibles (tallas, colores, etc.)

Puedes configurar en qué campos del producto se busca (nombre, descripción corta, descripción completa, palabras clave) y cuántos resultados devolver.

Order Details (Detalles del pedido) - Los clientes pueden consultar el estado del pedido proporcionando su ID de pedido y su dirección de correo electrónico. El chatbot devuelve:

  • Estado del pedido
  • Artículos pedidos con nombres, precios, cantidades, imágenes del producto y variantes elegidas
  • Total del pedido y coste de envío
  • Empresa de transporte, número de seguimiento y estado del envío
  • Nombre del destinatario y dirección de entrega completa
  • Teléfono del cliente

Recomendado: Conectar con el complemento de ChatLab

El complemento de ChatLab para CS-Cart es la forma más fácil de conectarse. Un complemento es una extensión que instalas en el panel de administración de CS-Cart. Este conecta tu tienda con tu chatbot (búsqueda de productos y estado de pedidos) y añade el widget de chat a tu escaparate de una sola vez, sin tener que copiar claves. Lo descargas desde ChatLab como un archivo .tgz y lo subes a tu tienda.

Descargar el complemento

Selecciona tu chatbot y ve a Test & Deploy (Probar y desplegar). En la sección Deploy (Desplegar), despliega Online store platforms (Plataformas de tiendas online) y haz clic en CS-Cart. La pestaña Plugin Installation (Instalación del plugin) está seleccionada de forma predeterminada. Haz clic en Download the ChatLab add-on (.tgz) (Descargar el complemento de ChatLab (.tgz)).

Test & Deploy tab with CS-Cart selected and the Download the ChatLab add-on (.tgz) button highlighted

Tu navegador guardará el complemento como chatlab.tgz. No lo descomprimas: CS-Cart necesita el archivo tal cual. El botón siempre entrega la versión actual del complemento (1.0.2 en el momento de escribir este documento).

El mismo botón de descarga está disponible en otros dos lugares:

  • Pestaña Connect (Conectar) - haz clic en Connect (Conectar) en la casilla de CS-Cart. Se abrirá el cuadro de diálogo CS-Cart Integration (Integración de CS-Cart) con las instrucciones del complemento y el botón Download the ChatLab add-on (.tgz). En un plan E-commerce, la misma casilla también se encuentra en la pestaña Shop (Tienda) bajo Connect your store (Conectar tu tienda).
  • Asistente de configuración - al crear un chatbot y elegir CS-Cart como plataforma, el paso Connect CS-Cart muestra el método Plugin or app (Plugin o aplicación) con el mismo enlace Download the ChatLab add-on (.tgz).

CS-Cart Integration dialog with the add-on instructions and the download button highlighted

Instalar el complemento en CS-Cart

  1. Inicia sesión en tu panel de administración de CS-Cart.
  2. Ve a Add-ons > Downloaded add-ons (Complementos > Complementos descargados).
  3. Abre el menú del engranaje y elige Manual installation (Instalación manual).
  4. Sube el archivo chatlab.tgz que descargaste. CS-Cart instalará el complemento.

Conectar tu tienda

  1. En tu panel de administración de CS-Cart, ve a Marketing > ChatLab AI Chatbot.
  2. Haz clic en Continue (Continuar). Se abrirá una nueva pestaña del navegador con ChatLab.
  3. Inicia sesión con tu cuenta de ChatLab, o crea una, y elige el chatbot para esta tienda cuando se te solicite.
  4. Se te redirigirá de nuevo a CS-Cart automáticamente. La página ahora mostrará ChatLab is connected (ChatLab está conectado), tu cuenta de ChatLab, el nombre del chatbot y una Live preview (Vista previa en vivo) del chatbot.
  5. Abre tu escaparate y envía un mensaje de prueba. Para comprobar los datos de la tienda, pregunta también por un producto y por un pedido que puedas verificar en el panel de administración.

Si empezaste en el asistente de configuración de ChatLab, vuelve a esa pestaña del navegador. Mostrará Waiting for the connection... (Esperando la conexión...) y continuará automáticamente en cuanto la tienda esté conectada.

Si CS-Cart indica que la solicitud de conexión no es válida o ha caducado, tu sesión de CS-Cart finalizó mientras iniciabas sesión en ChatLab. Abre de nuevo Marketing > ChatLab AI Chatbot y haz clic en Continue otra vez.

Qué configura el complemento

  • Conexión de la tienda - el complemento crea un usuario de API dedicado de solo lectura en tu tienda. El usuario pertenece a un grupo de usuarios llamado ChatLab API y solo puede ver el catálogo, los pedidos, los idiomas y los estados de los pedidos. Tu propia clave de API de administrador no se modifica. La búsqueda de productos y los detalles del pedido se habilitan para el chatbot automáticamente.
  • Widget de chat - el widget se añade a todas las páginas del escaparate, sin necesidad de pegar código. Si tu tienda utiliza el consentimiento de cookies del complemento GDPR de CS-Cart, el widget aparece listado allí como un servicio funcional y respeta la elección de cada visitante.
  • Idioma del catálogo - a partir de la versión 1.0.2, el complemento envía el idioma predeterminado de tu escaparate, de modo que el chatbot lee los nombres de productos, descripciones y categorías en el idioma que ven tus clientes. ChatLab lo muestra como Shop Language (Idioma de la tienda) en el cuadro de diálogo CS-Cart Integration. Si ya habías elegido un idioma manualmente para esta tienda, este se mantendrá.
  • Moneda de la tienda - a partir de la versión 1.0.2, el complemento también envía la moneda principal de tu tienda, por lo que los precios en el chat mostrarán la moneda correcta. ChatLab lo muestra como Shop currency (Moneda de la tienda) en el mismo diálogo, marcado como Sent by the ChatLab add-on (Enviado por el complemento de ChatLab). Si configuraste una moneda manualmente, se mantendrá.

Para revisar estos ajustes en ChatLab, selecciona tu chatbot, abre la pestaña Connect y haz clic en Modify (Modificar) en la casilla de CS-Cart. Cuando AI Search está activado para el chatbot, la indexación de tu catálogo comienza automáticamente tras conectarse la tienda.

La conexión de la tienda CS-Cart está disponible como una función prémium. Si tu plan no la incluye, el complemento seguirá añadiendo el widget de chat a tu escaparate, pero la búsqueda de productos y el estado del pedido permanecerán desactivados hasta que mejores tu plan.

Si pegaste el código del widget de ChatLab en tu tema anteriormente, los compradores verán dos widgets de chat. La página del complemento te avisará con A ChatLab widget is already on your storefront (Ya hay un widget de ChatLab en tu escaparate). Elimina el código de tu tema, o desmarca Show the chat widget on the storefront (Mostrar el widget de chat en el escaparate) en la sección Storefront widget (Widget del escaparate) y haz clic en Save (Guardar).

Actualizar desde una versión anterior

Las versiones anteriores a la 1.0.2 no envían el idioma del catálogo ni la moneda de la tienda. Para actualizar:

  1. Descarga el complemento actual de ChatLab como se describe arriba.
  2. En tu panel de administración de CS-Cart, ve a Add-ons > Downloaded add-ons, elige Manual installation en el menú de engranaje, sube el nuevo chatlab.tgz y haz clic en Upload & install (Subir e instalar).
  3. CS-Cart detectará que el complemento ya está instalado y te preguntará cómo reemplazarlo. Haz clic en Use the safe way (Usar el método seguro): CS-Cart desinstalará la versión anterior e instalará la nueva. La configuración del complemento en CS-Cart se eliminará, por lo que la tienda dejará de estar conectada.
  4. Abre Marketing > ChatLab AI Chatbot, haz clic en Continue, inicia sesión en ChatLab y selecciona el mismo chatbot de nuevo. El complemento enviará el idioma del catálogo y la moneda de la tienda en este momento.

Tu cuenta de ChatLab, el chatbot y sus conversaciones se mantienen intactos cuando te desconectas y te vuelves a conectar. En lugar de volver a conectar, también puedes configurar Shop Language y la moneda por tu cuenta en el cuadro de diálogo CS-Cart Integration en ChatLab.

Desactivar el widget, desconectar o desinstalar

  • Ocultar solo el widget - en Marketing > ChatLab AI Chatbot, desmarca Show the chat widget on the storefront y haz clic en Save. La tienda seguirá conectada.
  • Desconectar la tienda - en la misma página, haz clic en Disconnect (Desconectar) y confirma. El chatbot dejará de aparecer en tu escaparate, la conexión de la tienda se desactivará para el chatbot y la clave de API del usuario de solo lectura será revocada. Tu cuenta de ChatLab y los datos del chatbot seguirán disponibles en ChatLab.
  • Desinstalar el complemento - desinstala ChatLab en Add-ons > Downloaded add-ons. Esto también eliminará el usuario de API de solo lectura y su grupo de usuarios de tu tienda.
  • Desconectar en ChatLab - abre la pestaña Connect, haz clic en Modify en la casilla de CS-Cart y haz clic en Disconnect. Esto desactiva la búsqueda de productos y el estado de pedidos únicamente en el lado de ChatLab. Para eliminar también el widget de tu escaparate, desconecta en CS-Cart.

Alternativa: Conectar con una clave de API

Si no puedes o no deseas instalar el complemento, conecta la tienda tú mismo con una clave de API de CS-Cart siguiendo los pasos 1 a 3 a continuación. No crees una segunda conexión si el complemento ya ha conectado la tienda. Con este método, el widget de chat no se añade a tu escaparate automáticamente - añádelo tú mismo tal como se describe en Instalar el chatbot en tu tienda CS-Cart al final de este artículo.

Paso 1: Habilitar el acceso a la API en CS-Cart

  1. Inicia sesión en tu panel de administración de CS-Cart
  2. Ve a Customers > Administrators (Clientes > Administradores)

Navigate to Administrators in CS-Cart|width=40

  1. Haz clic en la cuenta de administrador que se utilizará para la conexión de la API
  2. Cambia a la pestaña API access (Acceso a la API)
  3. Marca "Yes, allow this user to use the API" ("Sí, permitir a este usuario usar la API")
  4. Haz clic en Save

API access tab showing the generated API key|width=40

  1. Copia la API key (clave de API) mostrada tras guardar - guárdala de forma segura
  2. Toma nota de la dirección de correo electrónico asociada a esta cuenta de administrador

Paso 2: Conectar CS-Cart en ChatLab

  1. Inicia sesión en ChatLab y selecciona tu chatbot
  2. Ve a la pestaña Connect y haz clic en Connect en la casilla de CS-Cart

Connect tab with the CS-Cart tile highlighted

  1. El cuadro de diálogo CS-Cart Integration sugerirá primero el complemento. Haz clic en Continue manual setup (Continuar con la configuración manual) para abrir el formulario de conexión
  2. Introduce tu API Key (del Paso 1)
  3. Introduce tu CS-Cart Account Email (el correo electrónico del administrador con acceso a la API)
  4. Introduce tu CS-Cart Shop URL (p. ej., https://tutienda.com)
  5. En Shop Language, haz clic en Load languages (Cargar idiomas) y elige el idioma de tu catálogo de productos. Esto es obligatorio si tu tienda tiene más de un idioma. Los nombres de productos, descripciones y categorías se leen desde tu tienda en este idioma, y cambiarlo más adelante vuelve a indexar todo el catálogo de productos

También puedes configurar las opciones de búsqueda:

  • Searchable fields (Campos de búsqueda) - activa o desactiva en qué campos de producto busca el chatbot (CS-Cart Product name, CS-Cart Short description, CS-Cart Full description, CS-Cart Keywords)
  • Number of search results (Número de resultados de búsqueda) - cuántos productos devolver por consulta (predeterminado: 5)

CS-Cart Integration form with credentials, shop language and search options, Connect button highlighted

  1. Haz clic en Connect

Tras una conexión correcta, verás un mensaje de confirmación con la opción de configurar acciones de IA. Cuando vuelvas a abrir el cuadro de diálogo más adelante con Modify, también mostrará Shop currency, la moneda leída desde tu tienda. Si falta o es incorrecta, haz clic en Set the currency manually (Establecer la moneda manualmente) e introduce el código de tres letras de la divisa, por ejemplo EUR.

Paso 3: Configurar las acciones de CS-Cart

Después de conectarte, habilita y personaliza las acciones individuales de IA. Ve a Settings > Actions (Ajustes > Acciones) y filtra por la plataforma CsCart.

CS-Cart actions in Settings showing product search and order details

Las acciones estándar incluyen:

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

La configuración de la conexión habilita las acciones estándar. Revisa su estado y desactiva cualquiera que no desees que usen los clientes. Abre una acción para editarla y luego usa Enable (Activar) o Update (Actualizar) en su diálogo. También puedes personalizar la etiqueta de la acción (el mensaje que se muestra a los usuarios mientras se ejecuta la acción) y las instrucciones que guían cómo la IA utiliza cada acción.

AI Search para CS-Cart: 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á activado y sustituye a la búsqueda en vivo en la tienda. La indexación comienza por sí sola cuando se conecta la tienda.

  • Comprobar 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). Shop > Products muestra el panel Product catalog y la ficha AI Search packs on this chatbot (Paquetes de AI Search en este chatbot).
  • Programar la reindexación - usa Schedule auto-retrain (Programar reentrenamiento automático) en Training > E-commerce catalog. La reindexación puede ejecutarse con tanta frecuencia como a diario y está disponible en todos los planes E-commerce y con todos los paquetes de productos. Train now (Entrenar ahora) o Retrain (Reentrenar) la ejecutan bajo demanda. Las actualizaciones son incrementales: los productos sin cambios se omiten y los productos eliminados se borran del índice.
  • Revisar la acción - en Settings > Actions, abre CsCart - AI product search. Sus opciones son Include product card (Incluir ficha de producto), Products in stock only (Solo productos en stock) y Number of products to return (Número de productos a devolver).
  • Mostrar fichas de producto - activa Enable Offer Cards (Activar Offer Cards) en Settings > Model & Advanced. Consulta Offer Cards.

Cuando el catálogo es mayor que 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.

Probar tu integración

Después de activar las acciones, abre Test & Deploy y prueba:

  • "Muéstrame guantes de entrenamiento" (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 de acceso)

Verifica que las respuestas coincidan con los datos de tu tienda CS-Cart.

Consejos para la configuración de la búsqueda

  • Habilita Product name (Nombre del producto) y Short description (Descripción corta) para obtener el mejor equilibrio entre velocidad y precisión
  • Añade Keywords (Palabras clave) si tus productos cuentan con metadatos enriquecidos de palabras clave
  • Activa Full description (Descripción completa) únicamente si los campos más breves no devuelven buenos resultados; puede ralentizar las búsquedas
  • Comienza con 5 resultados por consulta y ajústalo según el tamaño de tu catálogo

Instala el chatbot en tu tienda CS-Cart

Si te conectaste mediante el complemento, sáltate esta sección: el widget ya está en tu tienda. Si te conectaste con una clave API, añade tú mismo el widget de chat a tu tienda CS-Cart:

  1. En ChatLab, ve a la pestaña Test & Deploy (Probar y desplegar) de tu chatbot
  2. Despliega Online store platforms (Plataformas de tiendas online), haz clic en CS-Cart y abre la pestaña Manual Installation (Instalación manual)
  3. Haz clic en Copy to clipboard (Copiar al portapapeles) para copiar el fragmento de código
  4. En el panel de administración de CS-Cart, ve a Design > Layouts (Diseño > Diseños)
  5. Añade un HTML block (Bloque HTML) en el diseño predeterminado y pega el fragmento del widget en su pestaña Content (Contenido)
  6. Guarda los cambios del bloque y del diseño. Revisa las páginas con diseños independientes, como la del proceso de pago, y todos los idiomas de la tienda

Si usas un bloque HTML compatible con Smarty, envuelve el fragmento entre {literal} y {/literal}. Consulta las instrucciones de código personalizado de CS-Cart. Abre la tienda publicada y comprueba el widget tanto en ordenadores como en dispositivos móviles.

El código solo muestra el widget de chat. La búsqueda de productos y el estado de los pedidos provienen de la conexión con la tienda: el complemento o la conexión mediante clave API en la pestaña Connect (Conectar).

Artículos relacionados