Centro de ayuda
Integraciones del chatbot

Integración con Ecwid by Lightspeed

Última actualización:

Conecta tu tienda Ecwid by Lightspeed a tu chatbot de ChatLab. Una vez conectada, el chatbot busca tus productos, indexa todo el catálogo para AI Search y consulta el estado de los pedidos de los clientes directamente en la tienda Ecwid.

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 muestra 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 de e-commerce

Cuando termines la integración explicada abajo, lee la guía detallada 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 con IA - Los clientes describen lo que necesitan con sus propias palabras y el chatbot encuentra los productos correspondientes en tu catálogo. La respuesta incluye:

  • Nombre y descripción del producto
  • Precio actual en la moneda de tu tienda y, para productos en oferta, también el precio habitual y el descuento
  • Imagen del producto
  • Enlace directo a la página del producto en tu tienda
  • Disponibilidad, SKU, categorías y opciones del producto (tallas, colores) si las tiene

Búsqueda de productos por frase - Una búsqueda sencilla por palabras clave a través del motor de búsqueda de Ecwid. La búsqueda de productos con IA la sustituye automáticamente una vez indexado el catálogo.

Estado del pedido - El cliente indica el número de pedido y la dirección de correo electrónico utilizada al pagar, y el chatbot responde con el estado del pago, el estado del envío, el método de entrega, el número de seguimiento y los artículos pedidos. Los pedidos siempre se verifican contra el correo electrónico del cliente, por lo que un número de pedido adivinado nunca revelará el pedido de otra persona.

Categorías - El chatbot puede acotar la búsqueda a una categoría concreta utilizando el árbol de categorías de tu tienda.

Añadir al carrito - Las tarjetas de producto en el chat pueden mostrar un botón Add to cart (Añadir al carrito). Cuando el chatbot se ejecuta en tu Instant Site, o en un sitio web donde tu tienda Ecwid está integrada, el botón añade el producto directamente al carrito de Ecwid del cliente. Para productos con opciones como talla o color, el cliente elige primero la variante en el chat. En cualquier otro lugar, y para productos con opciones que el chat no puede rellenar (por ejemplo, un campo de texto para un grabado), el botón abre la página del producto.

Descubre la experiencia del carrito

Para ver un ejemplo del carrito e instrucciones sobre cómo probarlo en la tienda, consulta Añadir productos al carrito. La secuencia a continuación es ilustrativa; no ejecuta una operación real en el carrito de Ecwid.

Míralo en una conversación

Elige una variante antes de añadir al carrito

Secuencia ilustrativa: los botones de carrito y selectores de variantes reales dependen de la plataforma y la tienda. Esta reproducción no ejecuta operaciones en el carrito.

Ejemplo de ChatLabConversación ilustrativa

Vestido cruzado esmeralda, $79. Viscosa, corte midi.

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

Los resultados de búsqueda muestran una ficha de producto con botón de carrito en las tiendas compatibles.

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. Los resultados de búsqueda muestran una ficha de producto con botón de carrito en las tiendas compatibles.

    Vestido cruzado esmeralda, $79. Viscosa, corte midi.

  2. El cliente elige un producto y una talla mediante los controles de carrito compatibles.

    Visitante: Vestido cruzado verde esmeralda, talla 38.

  3. Confirma la acción solo después de que la tienda acepte la operación del carrito.

    Asistente: Resultado de ejemplo: la variante seleccionada se ha añadido al carrito de tu tienda.

  4. El pago y la finalización de compra se realizan en la tienda.

    Asistente: Revisa tu carrito en la tienda para confirmar la cantidad, el precio y el envío, y luego procede al pago.

Qué no ofrece la integración

  • Pago dentro del chat. El cliente completa la compra en tu tienda Ecwid.
  • Avisos de stock en tiempo real. Los precios y la disponibilidad se consultan en Ecwid cuando el chatbot responde, pero el chatbot no notifica a los clientes sobre cambios posteriores.

Requisitos

  • Una tienda Ecwid con el plan Venture, Business o Unlimited. Ecwid habilita el acceso a la API a partir del plan Venture; el plan Starter no se puede conectar.
  • La integración Ecwid incluida en tu plan de ChatLab.
  • Para la búsqueda de productos con IA: capacidad de AI Search asignada al chatbot suficiente para tus productos habilitados. Comprueba la capacidad disponible en Shop > Products (Tienda > Productos).
  • Ninguna otra integración de tienda conectada al mismo chatbot.

Paso 1: Obtén el Store ID y el token secreto en Ecwid

  1. Inicia sesión en tu panel de administración de Ecwid.
  2. En el menú de la izquierda, haz clic en Apps (Aplicaciones), luego en My Apps (Mis aplicaciones) y abre Develop apps (Desarrollar aplicaciones) (o ve directamente a https://my.ecwid.com/#develop-apps con la sesión iniciada).
  3. Si todavía no aparece ninguna aplicación personalizada, haz clic en Create app (Crear aplicación). Ecwid creará la aplicación con los permisos que necesita el chatbot: leer el perfil de la tienda, leer el catálogo y leer los pedidos. Si la pantalla muestra una lista de permisos, asegúrate de que estos tres estén marcados.
  4. Abre la página Details (Detalles) de la aplicación y haz clic en Show secret token (Mostrar token secreto). Copia el token. Empieza por secret_. No uses el token público, que empieza por public_.
  5. Anota tu Store ID (ID de la tienda). Es el número que aparece en el pie de página de cada página de tu panel de administración de Ecwid y en la barra de direcciones del navegador.

Mantén el token secreto en privado. Proporciona acceso de lectura a tu catálogo y pedidos. Puedes revocarlo en cualquier momento desinstalando la aplicación en Apps > My Apps; al volver a instalarla se generará un nuevo token.

Paso 2: Conecta la tienda en ChatLab

  1. Abre tu chatbot en ChatLab y ve a Shop (Tienda).
  2. Haz clic en la tarjeta Ecwid.
  3. Pega el Store ID y el Secret token (Token secreto).
  4. Haz clic en Check connection (Comprobar conexión). ChatLab consultará el perfil de la tienda y mostrará el nombre de la tienda, la dirección del escaparate y la moneda.
  5. Si tu tienda tiene más de un idioma, elige el Shop Language (Idioma de la tienda) que el chatbot debe utilizar para los nombres y las descripciones de los productos.
  6. Haz clic en Connect (Conectar).

ChatLab probará la conexión y activará las acciones de búsqueda de productos y estado de pedidos. Cuando el chatbot tiene asignada capacidad de AI Search, la indexación del catálogo comienza de inmediato y la ventana de confirmación te lo indicará. El token secreto se almacena encriptado y nunca se vuelve a mostrar; deja el campo del token vacío cuando solo quieras cambiar el idioma.

Paso 3: Configura las acciones

Ve a Settings > AI Actions (Ajustes > Acciones de IA). Hay tres acciones disponibles para Ecwid:

  • Ecwid - AI product search - búsqueda semántica sobre el catálogo indexado. En su configuración puedes incluir la ficha completa del producto en la respuesta, limitar los resultados a productos con stock disponible y habilitar el botón Add to cart.
  • Ecwid - product search - búsqueda por palabras clave a través del motor de búsqueda de Ecwid, utilizada cuando AI Search no está disponible para el chatbot. También se puede limitar a productos con stock y mostrar el botón Add to cart.
  • Ecwid - order details - consulta del estado del pedido. En los ajustes de la acción puedes configurar el límite de peticiones (rate limiting) y el enmascaramiento de datos personales.

Cada acción cuenta con un prompt editable y una etiqueta de acción que se muestra en el chat mientras el chatbot procesa la respuesta.

Paso 4: Revisa el catálogo

Abre Training > E-commerce catalog (Entrenamiento > Catálogo de e-commerce) para seguir el progreso de la indexación, explorar los productos indexados y volver a entrenar el catálogo tras realizar cambios importantes en la tienda. Solo se vuelven a indexar los productos que hayan cambiado desde la última sincronización. Los productos desactivados se eliminan del índice automáticamente.

Los productos sin descripción se indexan únicamente por nombre, categorías y atributos. Si tus productos no tienen descripciones en Ecwid, añadir aunque sea una breve mejorará notablemente los resultados de búsqueda.

Paso 5: Añade el chatbot a tu escaparate

La integración con Ecwid conecta el chatbot con los datos de tu tienda. Para mostrar el chatbot a tus clientes, añade el script de ChatLab al sitio web donde se aloja la tienda:

Instant Site (requiere el plan Venture, Business o Unlimited):

  1. En ChatLab, abre tu chatbot, ve a Test & Deploy (Probar e implementar), elige Ecwid y copia el código.
  2. En el panel de administración de Ecwid, ve a Website > Overview (Sitio web > Información general).
  3. Desplázate hacia abajo hasta Advanced website settings (Ajustes avanzados del sitio web) y haz clic en Add Code (Añadir código) dentro de Custom JavaScript code (Código JavaScript personalizado).
  4. Pega el código en el campo que se abre y haz clic en Save (Guardar).
  5. Actualiza tu Instant Site - el chatbot aparecerá en la esquina inferior de cada página.

Ecwid recomienda la sección del body (Custom JavaScript code) para los widgets de chat. No utilices Header meta tags and site verification (Etiquetas meta de cabecera y verificación del sitio) en la configuración de SEO - ese campo está destinado a las etiquetas de verificación.

Tienda incrustada en otro sitio web (WordPress, Wix, Squarespace y otros): añade el código a ese sitio web, exactamente como se describe en Añadir el chatbot a tu sitio web. El chatbot aparecerá en todas las páginas de ese sitio web, no solo en la página de la tienda.

Solución de problemas

  • "Ecwid rejected the secret token" - El token se ha copiado de forma incompleta, o bien la aplicación se ha desinstalado o reinstalado en Ecwid, lo que genera un token nuevo. Abre de nuevo la página Details de la aplicación y pega el token actual.
  • "The Ecwid store plan does not include API access" - La tienda tiene el plan Starter. Pasa al plan Venture o superior en Ecwid.
  • El chatbot no encuentra productos - Comprueba el estado de indexación en Training > E-commerce catalog y asegúrate de que los productos estén activados en Ecwid. Los productos desactivados nunca se devuelven en los resultados.
  • No se encuentra el pedido - El chatbot necesita la dirección de correo electrónico utilizada al realizar la compra junto con el número de pedido que figura en el correo de confirmación, incluyendo cualquier prefijo o sufijo que tu tienda añada a los números de pedido.