Saltar al contenido principal

Conecta tu tienda PrestaShop a Clione

Planes: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓

Necesitas: una cuenta de administrador en el back office de PrestaShop y tu tienda servida por https.

Una tienda PrestaShop se conecta con una sola cosa: una clave del Webservice que creas en tu back office. Clione la usa para leer tu catálogo —productos con sus combinaciones, categorías y páginas CMS, en todos los idiomas que tengas instalados.

Qué hace y qué no hace Clione hoy con una tienda PrestaShop​

Lee esto antes de conectar, porque PrestaShop todavía no está al mismo nivel que las otras plataformas:

Lee tu catálogo✅ Productos, combinaciones, categorías, páginas CMS, todos los idiomas
Enriquece con IA✅ El mismo proceso que en cualquier otra plataforma
Escribe las señales en tu tienda❌ Todavía no.

Nada de lo que genera Clione llega aún a tu escaparate. Escribir las señales en PrestaShop necesita un módulo de Clione para tu tienda, que está en construcción; hasta que exista, Clione lee tu catálogo y no escribe ni un campo. Puedes conectar, sincronizar y enriquecer ya, y ver lo que Clione produce: se queda en Clione hasta que salga el módulo.

Lo decimos claro en vez de dejar que lo descubras: si lo que necesitas hoy son las señales en la página, BigCommerce, Shopify y WooCommerce ya lo hacen. Mira Conectar BigCommerce, Conectar Shopify o Conectar WooCommerce.

Paso 1 — Crea una clave del Webservice​

  1. En el back office, ve a Parámetros avanzados → Webservice.
  2. Pon Activar el webservice de PrestaShop en Sí y guarda.
  3. Pulsa Añadir nueva clave de webservice.
  4. Deja la clave que genera PrestaShop y ponle una descripción que reconozcas luego, por ejemplo Clione.
  5. Pon el Estado en Activado.
  6. En la tabla de permisos, marca Ver (GET) en estos cinco recursos y en ninguno más:
    • products
    • combinations
    • categories
    • content_management_system
    • languages
  7. Guarda y copia la clave.

Con Ver es suficiente, y es todo lo que deberías dar. Con una clave de solo lectura Clione no puede añadir, cambiar ni borrar nada en tu tienda: ni por error, ni aunque alguien se quede con la clave.

Por qué combinations va aparte

En PrestaShop las variantes de un producto (combinations) son un recurso propio en vez de formar parte del producto, así que Clione necesita Ver en los dos o tus productos llegan sin tallas, sin colores y sin el precio de cada variante.

Por qué languages

Los IDs de idioma son de tu tienda: el ID 1 es el idioma que se instaló primero, que no tiene por qué ser el español. Clione lee la lista para saber cuál es tu idioma principal, en vez de suponerlo y leer una traducción secundaria como si fuera tu texto principal.

Paso 2 — Añade la tienda en Clione​

  1. En Clione ve a Añadir tienda y elige PrestaShop.
  2. Ponle un nombre y escribe la URL de la tienda: la página principal, por https (por ejemplo https://tienda.ejemplo.com).
  3. Pega la clave del Webservice.
  4. Guarda.

Clione comprueba la clave en ese momento leyendo tu lista de idiomas. Si falla, el error dice qué parte ha fallado y no un simple «no se pudo conectar».

Pulsa Sincronizar en la página de la tienda. Clione lee tus productos con sus combinaciones, tus categorías y tus páginas CMS.

Dos cosas que vas a notar, y las dos son a propósito:

  • Tus categorías «Raíz» e «Inicio» no aparecen. Toda instalación de PrestaShop las tiene por encima de tus categorías reales; ningún cliente llega a ellas, así que Clione las salta en vez de gastar un enriquecimiento en una página que nadie ve.
  • Una sincronización nunca llama a la IA. Sincronizar es gratis y solo lee tu tienda; enriquecer gasta créditos y solo ocurre cuando tú lo pides.

Paso 4 — Instala el módulo de Clione (para cuando las señales se publiquen)​

El módulo es lo que imprime los datos estructurados de Clione en tus páginas. Todavía no hace nada: por ahora Clione no escribe en escaparates de PrestaShop (mira la tabla de arriba). Instálalo ya si quieres tenerlo listo, o espera.

  1. Descarga clione-<versión>.zip desde tu panel de Clione.
  2. En el back office, ve a Módulos → Gestor de módulos → Subir un módulo y arrastra el zip.
  3. Abre su pantalla de Configurar y pega los cuatro valores que te muestra el panel de Clione: la URL de la API, la clave de la API, el ID de organización y el ID de tienda.
  4. Guarda.

Por qué cuatro valores y no uno: el módulo no lleva dentro ninguna URL ni ninguna clave. Es a propósito: un módulo con nuestro endpoint incrustado no se puede apuntar a un entorno de pruebas, y una clave dentro de un fichero que se distribuye es una clave en manos de cualquiera. Lo que pegas es lo tuyo.

Qué le hace el módulo a tu tienda: añade una tabla para las señales que le manda Clione, y la lee cuando se construye una página. No cambia tus productos, ni tus categorías, ni tus páginas, ni tu plantilla. Al desinstalarlo se borran su tabla y sus ajustes, y lo demás queda intacto.

Qué permisos necesita: ninguno más allá de la clave del Webservice del paso 1. Clione escribe las señales por el mismo Webservice, como un recurso propio del módulo, así que puedes revocarnos el acceso de escritura desde la misma pantalla sin tocar nada más.

Requisitos y límites​

  • https es obligatorio. La clave del Webservice viaja como el usuario de una cabecera de autenticación básica, así que por http cualquiera que esté en medio podría leerla. Clione rechaza una URL http:// antes que mandar tu clave en claro.
  • Tu tienda tiene que responder JSON. Clione le pide JSON al Webservice. Si tu versión de PrestaShop responde en XML, Clione te lo dice con ese nombre y no sincroniza nada, en vez de importarte un catálogo de productos sin nombre.
  • Clione lee despacio. Dos peticiones por segundo como máximo. Un catálogo completo tarda unos minutos en vez de unos segundos, a propósito: el Webservice carga toda tu tienda en cada petición, y una importación rápida es una importación que te ralentiza el checkout.
  • Las instalaciones multitienda todavía no están soportadas.

Si algo no funciona​

«No se pudo conectar» justo después de guardar la clave. Comprueba, en este orden: que el webservice está activado (paso 1.3), que el estado de la clave es Activado, que la clave tiene Ver en languages, y que la URL es la página principal por https sin ninguna ruta detrás.

Los productos llegan sin variantes. A la clave le falta Ver en combinations. Añádelo y vuelve a sincronizar.

Faltan las páginas CMS. A la clave le falta Ver en content_management_system.

Los productos llegan en otro idioma. Clione usa el primero de tus idiomas activos. Mira Internacional → Localización → Idiomas: el orden y la columna de activados deciden cuál toma Clione como idioma principal.

Un producto llega sin nombre. Es el síntoma de una tienda cuyo Webservice responde XML en vez de JSON. Normalmente Clione rechaza la sincronización por ese motivo; si lo ves, avisa a soporte e incluye tu versión de PrestaShop.