Conecta tu tienda WooCommerce a Clione

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

Necesitas: una cuenta de administrador en tu WordPress, WooCommerce instalado y el sitio servido por https.

Una tienda WooCommerce se conecta con dos piezas: una clave de la REST API que creas en WooCommerce, con la que Clione lee tu catálogo y escribe sus señales, y el plugin de WordPress de Clione, que imprime esas señales en las páginas que envía tu servidor. Con la clave basta para sincronizar y enriquecer. Pero nada de lo que escribe Clione aparece en tu storefront hasta que instalas el plugin.

¿Conectas BigCommerce o Shopify? Consulta Conecta BigCommerce o Conecta Shopify.

---

Antes de empezar

• Hace falta https. WooCommerce solo acepta una clave de la REST API por https, y Clione rechaza un sitio servido por http a secas.
• Tu WordPress tiene que responder en la raíz de su dominio. El formulario acepta https://tienda.ejemplo.com, no https://ejemplo.com/tienda: una URL con ruta se rechaza.

Paso 1 — Crea una clave de la REST API en WooCommerce

En el admin de WordPress, ve a WooCommerce → Ajustes → Avanzado → REST API y pulsa Añadir clave.

• Descripción: la que quieras, por ejemplo "Clione".
• Usuario: una cuenta de administrador.
• Permisos: Lectura/Escritura.

Pulsa Generar clave API y copia la clave de cliente (empieza por ck_) y la clave secreta de cliente (empieza por cs_). WooCommerce solo te enseña la secreta una vez.

Por qué lectura/escritura. Clione escribe sus señales en tus productos, categorías de producto y páginas con esta clave, y registra los webhooks que mantienen los productos sincronizados. Con una clave de solo lectura puedes sincronizar, pero cada publicación falla.

Paso 2 — Añade la tienda en Clione

1. En el dashboard de Clione, pulsa + Añadir sitio web en el raíl de la izquierda. Se abre Añadir tienda.

2. Plataforma: elige WooCommerce.

3. Detalles: rellena estos campos y pulsa Siguiente.

   • Nombre de la tienda: el nombre con el que quieras reconocerla en el dashboard.
   • URL del sitio WordPress: la URL principal de tu sitio, por ejemplo https://tienda.ejemplo.com. Si no pones https://, Clione lo añade.
   • Moneda: la moneda por defecto para precios e informes. Clione lee además la moneda de la tienda desde el propio WooCommerce.

   

4. Conectar: pega la clave de cliente y la clave secreta de cliente del paso 1 y pulsa Crear y conectar.

   También puedes pulsar Crear tienda sin las claves y añadirlas después en Ajustes de la tienda → Credenciales.

   

Al guardar las claves, Clione registra webhooks de producto en tu WooCommerce: un producto que crees, edites o borres allí se sincroniza solo. Las categorías y las páginas se actualizan cuando lanzas una sincronización.

Paso 3 — Comprueba la conexión

Abre la tienda, ve a Ajustes de la tienda → Credenciales y pulsa Probar conexión. Clione hace una llamada autenticada a la REST API de tu sitio. Si funciona, ves "Conexión OK; WooCommerce confirmó" y el nombre de la tienda. Si no, ves el error que devolvió WooCommerce o tu hosting.

La tarjeta Asistentes de configuración del Resumen de la tienda no hace sus comprobaciones en WooCommerce. Los pasos que comprobaría aparecen como "Clione todavía no puede comprobar esto en WooCommerce, así que no cuenta como hecho". Aquí la comprobación que funciona es Probar conexión.

Después, lanza tu primera sincronización. Consulta Sincroniza tu catálogo.

Paso 4 — Instala el plugin de WordPress de Clione

El plugin, Clione Signals, es lo que pone el trabajo de Clione delante de los crawlers y de los asistentes de IA. En el HTML que envía tu servidor en la primera petición, imprime:

• un bloque JSON-LD por página con Organization, WebSite, BreadcrumbList, el propio producto, categoría o página, y FAQPage cuando tiene FAQs;
• el meta title y la meta description que escribió Clione, salvo que los gestione un plugin de SEO (más abajo);
• el acordeón de FAQs, renderizado por PHP, así que funciona sin JavaScript. Para temas y maquetadores que se saltan los hooks estándar de WordPress tienes el shortcode [clione_faq].

Cómo conseguir el plugin. Es un zip que subes en Plugins → Añadir nuevo → Subir plugin. No está en WordPress.org y el dashboard todavía no tiene botón de descarga: pídenoslo en help@clione.ai, junto con el endpoint de Clione que te pide el plugin.

Cómo conectarlo. En WordPress, abre Ajustes → Clione FAQ y rellena:

• API key: créala en Clione, en Ajustes de la tienda → Claves de API, con Tipo de clave en Servidor, el scope products:read y sin dominios permitidos. WordPress llama a Clione desde tu servidor, no desde un navegador. Si revocas la clave en Clione, el sitio queda desconectado sin tocar WordPress.
• Clione endpoint: el plugin no trae ninguna dirección propia. Usa la que te dimos.

Guarda. La página de ajustes te dice entonces si la clave se ha verificado.

Send WordPress changes to Clione viene desactivado. Si lo activas, editar una página, un producto o una categoría en WordPress deja el cambio pendiente de revisión en Clione, y no se aplica nada hasta que alguien de tu equipo lo aprueba. Necesita un permiso de clave que la pestaña Claves de API todavía no ofrece, así que pídenoslo si lo quieres.

Las páginas necesitan el plugin. WordPress solo acepta los campos de Clione en una página cuando el plugin los ha registrado. Hasta que lo instales, publicar una página desde Clione no le escribe nada. Los productos y las categorías de producto aceptan los campos sin el plugin, pero no se ve nada en el storefront hasta que el plugin los imprime.

Si usas Yoast, Rank Math, All in One SEO o SEOPress, el plugin les deja a ellos el título, la meta description y las etiquetas Open Graph, e imprime solo el JSON-LD, que ningún plugin de SEO genera con la forma de Clione. En el código fuente de la página verás un comentario que lo dice.

Caché. Cuando Clione escribe señales nuevas en una página, producto o categoría, el plugin purga esa página de WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed, Cache Enabler, WP Fastest Cache, SiteGround Optimizer y Nginx Helper. Nunca vacía todo el sitio. Una caché por delante de WordPress (la de tu hosting o un CDN) no se purga.

---

Qué sincroniza Clione

WooCommerce	En Clione	Qué se sincroniza
Productos	Productos	En cualquier estado, con sus variaciones
Categorías de producto	Categorías	Todas, también las vacías
Páginas de WordPress	Páginas	Solo las publicadas

Las entradas del blog y las etiquetas de producto no se sincronizan.

En Pro y Agency, Clione también lee una vez al día tus pedidos de los últimos 30 días para el informe de Atribución. WooCommerce envía el pedido entero, con los datos de contacto del comprador; Clione guarda solo el número, la fecha, el estado, la moneda, los importes y las líneas, y nunca guarda el nombre, el email, el teléfono ni la dirección de un cliente. En Starter y Growth no se lee ningún pedido, aunque tu clave de API lo permita. Los datos de pedidos se guardan 13 meses desde la fecha del pedido y después se borran automáticamente. Si pasas a un plan sin Atribución, Clione deja de leer pedidos, y los que ya guardaba se borran con ese mismo plazo.

---

Qué funciona en WooCommerce y qué no

Comparado con BigCommerce y Shopify, entidad por entidad. Para todas las plataformas y señales, consulta Capacidades por plataforma.

Señal	Productos	Categorías de producto	Páginas
JSON-LD, con FAQPage	✓ (plugin)	✓ (plugin)	✓ (plugin)
Meta description	✓ (plugin)	✓ (plugin)	✓ (plugin)
Meta title	✓ (plugin)	Opcional, desactivado por defecto	Opcional, desactivado por defecto
Acordeón de FAQs visible	✓ (plugin)	✓ (plugin)	✓ (plugin)

El meta title en categorías y páginas depende del mismo ajuste que en las otras plataformas: Publicar meta_title en categorías, colecciones y páginas, en Ajustes de la tienda → General.

Lo que WooCommerce no tiene hoy:

• Ni llms.txt ni documentos .md en tu dominio. BigCommerce los tiene en un subdominio que apuntas a Clione, y Shopify a través de la app de Clione. WooCommerce no tiene equivalente.
• Clione no escribe URL canónica, meta keywords ni etiquetas Open Graph. BigCommerce tiene las tres. (Sin plugin de SEO activo, el plugin de WordPress imprime una canónica en los archivos de categoría y etiqueta; es cosa del plugin, no una señal de Clione.)
• Sin señales por idioma para mercados. Solo las tiene Shopify.
• Sin JSON-LD multimoneda. Solo lo tiene Shopify. Los rangos de precio por variante (del más bajo al más alto) sí funcionan.
• Sin comprobaciones de los Asistentes de configuración, como cuenta el paso 3.
• Sin comprobación del widget de FAQs ni Inyector de Schema. El Inyector de Schema es el script de storefront de BigCommerce; en WooCommerce ese trabajo lo hace el plugin, y Clione no comprueba si está instalado.
• Nada en el storefront sin el plugin. En BigCommerce, Clione instala lo que sale en el storefront a través de la API de la plataforma. En WooCommerce el plugin lo instalas tú.

---

Solución de problemas

El formulario dice "Introduce la URL de tu sitio WordPress": el campo está vacío. "Introduce una URL válida que empiece por https:// o http://": lo que has escrito no es una dirección web. Usa la URL principal de tu sitio.

"Usa solo el dominio raíz del escaparate": tu URL lleva una ruta. Usa el dominio en el que responde WordPress, sin /tienda ni ruta de página.

Probar conexión falla con un error de autenticación: la clave de cliente y la secreta no casan, o la clave se revocó. Crea una clave nueva y vuelve a pegar las dos en Ajustes de la tienda → Credenciales. Si dejas un campo vacío, se conserva el valor guardado.

Probar conexión enseña una página de error en HTML: ha respondido un cortafuegos, un plugin de seguridad o una página de mantenimiento en lugar de WooCommerce. Permite las peticiones a /wp-json/ en tu sitio.

Publicar una página no cambia nada en el storefront: el plugin no está instalado o no está conectado. Consulta el paso 4.

El título o la descripción del storefront no son los de Clione: hay un plugin de SEO activo y el plugin de Clione se los deja a propósito.

¿Dudas? Escribe a help@clione.ai.