Conecta tu proyecto de commercetools con Clione
Planes: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓
Necesitas: permiso para crear un API client en el Merchant Center de commercetools, y la clave del canal de distribución, de la store o del atributo de marca que identifica los productos de esta tienda.
commercetools se diferencia del resto en una cosa que lo cambia todo: no tiene escaparate. Shopify, BigCommerce y WooCommerce renderizan páginas, así que Clione publica directamente en ellas. En commercetools las páginas las renderiza tu propio front, y Clione escribe sus señales en los productos como atributos para que ese front los lea.
Así que conectar tiene dos lados. El tuyo es esta página. El de tus desarrolladores es el contrato de renderizado, y hasta que lo implementen, el trabajo de Clione no aparece en tu web.
Qué hace y qué no hace Clione hoy con un proyecto de commercetools
| Lee tu catálogo | ✅ Product projections publicadas y categorías, en todos los locales del proyecto |
| Enriquece con IA | ✅ El mismo pipeline que en cualquier otra plataforma |
| Escribe las señales en tu proyecto | ❌ Todavía no — en desarrollo |
| Tu front las renderiza | ❌ No hasta que tus desarrolladores añadan el contrato |
Nada de lo que genera Clione llega aún a tu web. Lo decimos claro en vez de dejar que lo descubras: conectar, sincronizar y enriquecer funcionan ya, y puedes ver todo lo que Clione produce, pero se queda en Clione hasta que estén las dos piezas.
Paso 1 — Crea un API client
En el Merchant Center: Settings → Developer settings → Create new API client.
Dale solo los dos scopes que Clione necesita:
view_products— leer tu catálogomanage_products— escribir después los atributos de Clione (dáselo ya y no repites este paso)
Copia la project key, el client ID y el client secret. El secret se muestra una sola vez.
Tu proyecto vive en una región, y un client de otra región no puede llegar a él. La URL del Merchant Center te lo dice: la región aparece en la API URL, en la misma pantalla que las credenciales. Elige la que coincida en Clione — no hay valor por defecto, porque cada región son los datos de otro continente.
Paso 2 — Qué productos son de esta tienda
Este es el paso que más importa, y no tiene un valor por defecto seguro.
Un proyecto de commercetools suele tener varias marcas. Clione trata cada marca como una tienda propia, así que hay que decirle qué productos son de la que estás añadiendo. Da uno de estos:
| Qué das | Cuándo |
|---|---|
| Clave del canal de distribución | Tus marcas se separan por canal |
| Clave de la store | Tu proyecto usa Stores de commercetools |
| Nombre y valor del atributo de marca | Tus productos llevan un atributo de marca, p. ej. brand = Champion |
Si das más de uno, Clione usa el primero en ese orden y te dice cuál ha usado.
El nombre del atributo por sí solo no selecciona nada: valdría cualquier producto que tenga ese campo, o sea el proyecto entero. Clione rechaza la pareja si falta el valor.
Clione no conecta sin uno. Leer el proyecto sin selector devuelve todas las marcas, y el resultado no sería un error: serían los productos de otra marca en el panel de esta tienda, enriquecidos con los créditos de esta tienda. Por eso se rechaza la conexión.
Paso 3 — Añade la tienda en Clione
+ Añadir web → commercetools, y rellena la project key, la región, el client ID y el secret, y el selector del paso 2. Clione lo comprueba todo con una sola llamada a la API, que es la única forma de distinguir una región mal puesta de un secret mal puesto.
commercetools está en su primera puesta en marcha, así que conectar se habilita por organización. Si el formulario responde "Connecting a commercetools project is limited", pide a soporte de Clione que lo habilite para la tuya.
Paso 4 — Sincroniza y pasa el contrato a tus desarrolladores
La sincronización lee tu catálogo; el enriquecimiento no escribe nada en tu proyecto. Cuando tus productos estén enriquecidos, manda a tus desarrolladores a el contrato de renderizado: nombra los cuatro atributos y trae una referencia en Next.js que pueden copiar.
Hasta que esa página esté implementada en tu lado, tus páginas no llevan ninguna señal de Clione, por mucho que enriquezcas.
Requisitos y límites
- Los scopes del API client tienen que incluir
view_products. - Clione lee solo productos publicados (
staged=false): un borrador que nadie ha publicado tampoco lo ve un buscador. - Hoy el catálogo se lee hasta 10.000 productos por pasada.
- Un selector por tienda, y varias tiendas de Clione pueden compartir proyecto.
Problemas típicos
"Connecting a commercetools project is limited" — es el permiso por organización de arriba. Pídelo a soporte.
La tienda conecta y el catálogo sale vacío. Casi siempre es el selector: es válido pero no encaja con nada. Clione registra cuántos productos leyó y cuántos se quedó, así que soporte puede decirte "0 de 12.480" en vez de adivinar. Revisa la clave de canal, la de store o el valor del atributo contra el proyecto.
Una región mal puesta parece un secret mal puesto. Las dos fallan igual en la API. Mira primero la región: es la más fácil de equivocar.