Saltar al contenido principal

Conecta tu tienda BigCommerce a Clione

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

Tiempo: ~5 minutos para conectar, ~10 con el Schema Injector.

Necesitas: entrar en el admin de BigCommerce como store owner, o con un usuario que tenga el permiso Manage API Accounts. Si no te aparece Settings → API Accounts en el menú lateral, es que no lo tienes: pídele al owner que te lo dé en Settings → Users → [tu nombre] → Permissions.

Una tienda BigCommerce se conecta con dos piezas: un API Access Token que creas dentro de tu propia tienda, con el que Clione lee tu catálogo y escribe sus señales, y el Schema Injector, un script de storefront que Clione instala por ti. Con el token basta para sincronizar, enriquecer y publicar. El Schema Injector es lo que pinta el acordeón de FAQs visible y los enlaces de descubrimiento para los agentes de IA.

¿Conectas otra plataforma? Mira Conecta Shopify, Conecta WooCommerce, Conecta PrestaShop o Conecta commercetools.

Antes de empezar​

  • Una Store API Account, no una app pública. Clione se conecta con un token que creas tú en tu tienda. Sin cola de revisión y sin esperar aprobación: concedes exactamente los scopes de la tabla de abajo y, si borras la API Account en BigCommerce, Clione pierde el acceso en el mismo momento.
  • Te hace falta el store hash. Es el trozo alfanumérico de la URL de tu admin, store-<hash>.mybigcommerce.com. BigCommerce también lo enseña en Settings → API → Store API URL, como api.bigcommerce.com/stores/<hash>. Clione te pide el hash suelto, sin el prefijo store-.
  • Dos tiendas, dos tokens. Si llevas varias tiendas BigCommerce, cada una necesita su propia API Account. Un token de otra tienda falla con 404 Not Found, no con un error de autenticación: ahí está la parte confusa.

Paso 1 — Crea el API Access Token​

Este paso ocurre entero en el admin de BigCommerce y tiene su propia página, para que las dos no se desincronicen: Crea una API account de BigCommerce. Ahí está el recorrido por Settings → API Accounts → Create API Account, el nivel exacto de cada scope y la descarga del .txt que BigCommerce te enseña una sola vez.

Esa página es la que manda sobre los scopes. La tabla siguiente es solo para que sepas qué vas a conceder antes de entrar en el admin:

ScopeNivelPara qué
ProductsModifyLeer productos, categorías, marcas y variantes; escribir de vuelta el meta title, la meta description y las meta keywords.
ContentModifyLeer y actualizar páginas de contenido; escribir los widgets de datos estructurados; instalar y quitar el Schema Injector.
Information & SettingsRead-onlyLeer el nombre de tu tienda y su dominio. Clione no escribe nada aquí.
OrdersRead-only, opcionalSolo en Pro y Agency, para Atribución. Si lo dejas en None, Clione no lee ningún pedido en ningún plan.

Todo lo demás se queda en None. Con Products o Content en Read-only no es suficiente: la sincronización funciona y todas las publicaciones fallan con 403 Forbidden.

Guarda el .txt que te ofrece BigCommerce. Solo lo enseña una vez, y la línea Access Token es el valor que Clione necesita.

Paso 2 — Añade la tienda en Clione​

  1. En el dashboard de Clione, pulsa + Add website en el panel izquierdo. El asistente abre en Platform.

  2. Platform: elige BigCommerce.

  3. Details: rellena esto y pulsa Next.

    • Store Name — lo que te sirva para reconocer la tienda en el dashboard.
    • Store Hash — el hash suelto: abc123def, no store-abc123def ni la URL entera. El formulario acepta lo que escribas, así que el prefijo store- no te lo va a rechazar: simplemente apunta a una tienda que no existe.
    • Storefront URL — la dirección pública que visitan tus clientes: tu dominio propio si lo tienes, y si no, la de mybigcommerce.com. Solo el dominio raíz: una ruta a una página o a un fichero se rechaza, y la dirección api.bigcommerce.com también. Es donde Clione comprueba después que tus señales están de verdad en producción. Si lo dejas vacío, Clione usa https://store-<tu hash>.mybigcommerce.com, que es lo correcto para una tienda en el dominio de BigCommerce y lo incorrecto para una con dominio propio.
    • Currency — la moneda principal de la tienda, con la que Clione calcula precios e informes. Pon la misma que tienes en BigCommerce.

  4. Connect: pega el Access Token en API Access Token y pulsa Create & Connect.

    También puedes pulsar Create Store sin el token y añadirlo luego en Store Settings → Credentials.

El formulario para añadir una tienda

Si ya has gastado el límite de tiendas de tu plan, el asistente te lo dice y te ofrece Upgrade plan o el add-on que suma una tienda más.

Paso 3 — Comprueba la conexión​

Abre la tienda, ve a Store Settings → Credentials y pulsa Test connection. Clione lee la ficha de tu propia tienda en BigCommerce con el token: si va bien, verás «Connection OK; BigCommerce confirmed <el nombre de tu tienda>», y lo importante es precisamente ese nombre — demuestra que el token y el hash son de la tienda que querías. Si va mal, verás la respuesta de BigCommerce tal cual: 401 si el token se copió con algún carácter de más, 404 si el hash no es de ese token.

Tres cosas que conviene saber de esta comprobación:

  • Comprueba el token guardado, no lo que hay en el campo. Pega, Save Changes y entonces prueba. Dejar el campo del token vacío mantiene el que ya había, así que un campo en blanco no es un token en blanco.
  • No demuestra que los scopes de escritura estén bien. La llamada que hace no necesita más que un token válido: un token con Products en Read-only pasa esta prueba y luego falla todas las publicaciones con 403. La prueba honesta de los permisos de escritura es publicar una entidad.
  • Guardar el token no publica nada. Nada llega a tu storefront hasta que publicas una entidad e instalas el Schema Injector.

Al guardar el token, Clione registra además los webhooks de producto en tu tienda, para que un producto que edites en BigCommerce se sincronice solo en vez de esperar a la sincronización diaria. Si tu API account no puede crearlos, el registro falla y te lo dice; la tienda sigue funcionando con la sincronización programada.

A partir de ahí, el Overview de la tienda ejecuta las comprobaciones de Setup assistants, que te dicen qué falta todavía: la primera sincronización, el Schema Injector, las FAQs.

Lo siguiente es sincronizar: Sincroniza tu catálogo.

Paso 4 — Instala el Schema Injector​

A un storefront de BigCommerce llegan dos cosas distintas, y merece la pena no mezclarlas:

  • El JSON-LD. Cuando publicas una entidad, Clione instala un widget de BigCommerce para ella, y Stencil lo renderiza en el HTML que tu servidor envía en la primera petición. Los crawlers que no ejecutan JavaScript lo ven. Para esto no instalas nada: lo hace el publicar.
  • El Schema Injector. Un script, que aparece como Clione FAQ Renderer en el Script Manager de BigCommerce, que pinta el acordeón de FAQs visible, aplica tu CSS de FAQs y añade las dos etiquetas <link> de descubrimiento que buscan los agentes de IA. No emite JSON-LD.

Se instala en Store Settings → Schema Injector → Install. Clione registra el script por la Scripts API de BigCommerce con load_method: async, así que nunca bloquea el renderizado de tu página, y se crea su propia clave de solo lectura restringida a tu hostname — tú no pegas nada. La pestaña pasa a decir Installed con el id del script, y Refresh status vuelve a leerlo de BigCommerce.

Si tu storefront es headless — Catalyst, Next.js o cualquier frontend propio — la Scripts API no llega hasta ahí. Usa el SDK @clione/seo: Clione lo detecta y te lo dice en vez de instalar algo que no haría nada.

Todo el detalle, incluido cómo desinstalarlo sin dejar restos: Schema Injector.

Qué sincroniza Clione​

BigCommerceEn ClioneQué entra
ProductsProductosCon sus variantes, opciones y custom fields
CategoriesCategoríasTodas, incluido el árbol de categorías
Content pagesPáginasLas páginas que BigCommerce expone en Storefront → Web Pages

Las marcas se leen, pero como parte del producto y no como entidad propia, así que no hay una lista de marcas en Clione. Los clientes no se leen nunca.

En Pro y Agency, y solo si concediste el scope opcional Orders — Read-only, Clione lee una vez al día tus pedidos de los últimos 30 días para el informe de Atribución. BigCommerce manda el pedido entero; Clione se queda con los campos de cabecera y las líneas, y nunca guarda el nombre, el email, el teléfono, la dirección, la cuenta de cliente ni los datos de pago del comprador. Los datos de pedido se borran 13 meses después de la fecha del pedido. En Starter y Growth no se lee ningún pedido, aunque el scope esté concedido.

Lo que tiene BigCommerce y otras plataformas no​

BigCommerce es la plataforma más completa en Clione. Comparada con las demás:

  • La canonical URL, las meta keywords y las etiquetas Open Graph las escribe Clione. WooCommerce y PrestaShop no tienen ninguna de las tres.
  • llms.txt y los documentos .md por entidad en tu propio dominio, a través de un subdominio que apuntas a Clione con un CNAME. Añade el hostname en Store Settings → Integrations, apunta el CNAME donde te diga esa tarjeta y pulsa Verify: Clione comprueba el DNS por su cuenta y no sirve nada en un dominio que no haya verificado. Shopify tiene los mismos documentos a través de la app de Clione; WooCommerce y PrestaShop no tienen equivalente.
  • Las comprobaciones de Setup assistants y la del widget de FAQs funcionan aquí.

Y las dos cosas que no tiene, para que no las busques:

  • No hay señales por idioma para markets. Eso solo lo tiene Shopify: en BigCommerce varios idiomas son un canal por idioma, y Clione se niega a enseñar una lista de markets sobre la que no podría actuar.
  • No hay JSON-LD multidivisa. Eso solo lo tiene Shopify. Los rangos de precio por variante, del más bajo al más alto, sí funcionan aquí.

La matriz completa, señal por señal y entidad por entidad: Capacidades por plataforma.

Problemas frecuentes​

401 Unauthorized — El Access Token se copió con un espacio de más, o la API Account se borró en BigCommerce. Copia otra vez la línea Access Token, exacta, y pégala en Store Settings → Credentials.

404 Not Found — El store hash no es de ese token. Compara la línea API Path del .txt con la URL de tu admin.

403 Forbidden cuando Clione lee — Products está en None. 403 solo cuando Clione escribe — Products o Content está en Read-only. Súbelo de nivel en BigCommerce y guarda; el token que ya tienes sigue valiendo, así que no hay que volver a pegar nada.

429 Too Many Requests una y otra vez — BigCommerce limita por token y Clione reduce el ritmo solo. Si lo ves a menudo, es que otra integración comparte la misma API Account. Dale a Clione la suya.

La instalación del Schema Injector se para con «Manual Clione embed detected» — alguien metió un snippet de Clione a mano en el theme. Quítalo, o elige Install anyway (force) si sabes que ese snippet está obsoleto.

No hay JSON-LD en el código de una página de producto — esa entidad todavía no se ha publicado. Abre su pestaña Publish. Mira Publicar.

La verificación no llega a una tienda sandbox o protegida con contraseña — pon tu BigCommerce Preview Code en la pestaña Publish de la entidad (admin de BigCommerce → Storefront → My Themes → Advanced → Preview Code). Mira Verifica las señales.

La sincronización termina pero faltan productos — lo más probable es que estén ocultos, o en un canal que no cubre la tienda de este token. Compara con el mismo filtro en el listado de productos de BigCommerce.

Revocar el acceso​

  1. Desinstala primero el Schema Injector, en Store Settings → Schema Injector. Una vez borrada la API Account, Clione ya no puede quitar el script por ti y tendrías que borrar Clione FAQ Renderer a mano en el Script Manager.
  2. En BigCommerce, Settings → API Accounts: busca la cuenta de Clione y bórrala.

A partir de ese momento se rechaza cualquier petición de Clione a tu tienda. Si además quieres borrar la tienda y sus datos enriquecidos de Clione, usa Remove Store en la pestaña Danger Zone de Store Settings — mira Ajustes de la tienda.

Qué viene después​

  1. Sincronizar. Clione trae productos, categorías y páginas — Sincroniza tu catálogo.
  2. Enriquecer. El enriquecimiento siempre pregunta antes de gastar créditos; una sincronización no enriquece nunca por su cuenta — Enriquece tu catálogo.
  3. Publicar. El enriquecimiento no escribe nada en tu storefront. Publicar sí — Publicar.
  4. Verificar. En Growth y planes superiores, Verification en el menú de la tienda confirma que el storefront en vivo coincide con Clione — Verifica las señales.

¿Dudas? Escríbenos a help@clione.ai.