Shopify
Conecta tu tienda de Shopify una vez y tus agentes responderán con tu catálogo, tus pedidos y tu inventario. La configuración lleva unos cinco minutos, se hace entera dentro de Cuneiform Chat y no requiere tocar la plantilla ni instalar ningún plugin.
Shopify funciona en todos los planes, incluida la prueba gratuita. Conectar una tienda no cuesta nada extra.
Qué obtienes
Una vez conectada tu tienda, tu agente de tienda puede:
- Responder preguntas del catálogo con tus productos, variantes, opciones y precios reales
- Leer stock y precio de tu catálogo sincronizado, al día gracias a los webhooks, para que no ofrezca lo que acabas de agotar
- Recomendar productos disponibles en lugar de lo que recuerde
- Consultar pedidos para los compradores que puedan demostrar que el pedido es suyo
- Enviar actualizaciones del estado del pedido a los compradores que se suscriban, en el mismo chat
- Llevar al comprador decidido a tu checkout de Shopify con todo su carrito intacto
Requisitos previos
- Una tienda de Shopify que administres
- Un workspace de Cuneiform Chat y una cuenta Owner o Admin en él: conectar una tienda es una acción de administración
- Al menos un agent, o margen en tu plan para crear uno (ver Tu agente de tienda)
Las cuentas de colaborador no pueden completar la configuración. Parte del proceso ocurre en el Dev Dashboard de tu panel de Shopify, que Shopify no ofrece a las cuentas de colaborador. Si una agencia gestiona tu tienda, esa parte la tiene que hacer el propietario de la tienda o una cuenta de staff con permisos sobre apps.
Cómo funciona la conexión
Creas una pequeña app dentro de tu propio panel de Shopify, la instalas en tu tienda y pegas sus credenciales en Cuneiform Chat. Los datos de tu tienda no salen de tu cuenta de Shopify por ninguna otra vía, y la app te pertenece a ti, no a nosotros.
El paso a paso vive en el producto, donde puede mostrarte los valores exactos que hay que introducir para tu tienda: esos valores dependen de tu workspace y de la versión de la API que estemos ejecutando, así que una copia aquí quedaría desactualizada sin avisarte.
Para empezar: abre Commerce → Shopify en Cuneiform Chat y sigue los pasos de la pantalla de conexión. Te guía para crear la app, pedir los permisos de abajo, instalarla y pegar las credenciales.
Instalar la app es un paso aparte. En el Dev Dashboard de Shopify, publicar una versión de tu app no es lo mismo que instalarla en tu tienda. Si te quedas en la publicación, las credenciales se rechazan al pegarlas; la pantalla de conexión te lo dice explícitamente cuando pasa.
Permisos que pedimos
Tu app pide cinco permisos de solo lectura. No hay ningún permiso de escritura en el conjunto: no puede cambiar nada en tu tienda.
| Permiso | Para qué lo necesitamos |
|---|---|
read_products | Leer tu catálogo: productos, variantes, opciones, precios, imágenes |
read_inventory | Leer el stock para que el agent solo recomiende lo disponible |
read_orders | Consultar el pedido de un comprador y enviarle actualizaciones |
read_fulfillments | Informar del progreso del envío de esos pedidos |
read_customers | Cotejar el teléfono del comprador con el pedido por el que pregunta |
Solo lectura significa solo lectura. La app no puede crear, editar ni eliminar productos; no puede ajustar el inventario; no puede crear, editar ni cancelar pedidos; y no puede cobrar. Cada compra se completa en tu propio checkout de Shopify.
Si algún permiso no se concede
Shopify restringe el acceso a clientes y pedidos en sus planes más económicos, así que una tienda en Basic o Starter puede no llegar a conceder read_orders ni read_customers. Cuando ocurre, la conexión se completa igualmente y Cuneiform Chat te dice qué permisos faltan: en la pantalla de conexión y de nuevo en Commerce → Shopify → Connection mientras la carencia siga siendo real.
Todo lo que dependa de un permiso ausente queda desactivado en lugar de fallar en silencio; las víctimas habituales son la consulta de pedidos y las actualizaciones de estado. Cuando el plan de tu tienda los cubra, desconecta y vuelve a conectar la tienda para que se recojan los nuevos permisos.
Abrir Cuneiform Chat dentro de tu panel de Shopify
Opcionalmente, tu app puede marcarse como embedded, lo que hace que tu panel de Cuneiform Chat se abra dentro de admin.shopify.com, junto al resto de la administración de tu tienda: configuración inicial, estado de la conexión, ajustes y un dashboard. La pantalla de conexión te da los dos valores que pide Shopify. Saltarte esto no cambia nada del funcionamiento de la integración; solo cambia desde dónde la abres.
Una tienda por workspace
Un workspace conecta una tienda de Shopify. También puede tener conectada una tienda de WooCommerce al mismo tiempo: ver Commerce.
Si intentas conectar una tienda que ya está conectada a otro workspace, el intento se rechaza en lugar de apropiársela en silencio.
Cambiar permisos o credenciales más adelante
No hay un botón de «Reconnect» aparte. Los permisos y las credenciales de tu app se registran al conectar y no se reescriben después, así que cualquier cambio que hagas en Shopify —añadir un scope, rotar el client secret— llega a Cuneiform Chat desconectando y volviendo a conectar la tienda.
Volver a conectar repite el desmontaje que se describe en Desconectar, así que léelo antes si tienes Storefronts asociadas a la tienda.
Después de conectar
- Tu catálogo empieza a sincronizarse de inmediato. Ver Catálogo y conocimiento para saber qué cubre la sincronización y cómo se mantiene al día.
- Un agent se convierte en tu agente de tienda, elegido por ti automáticamente al conectar. Ver Tu agente de tienda.
- Las actualizaciones de estado del pedido están activas por defecto, y la única barrera es del comprador: se suscribe después de verificar su pedido. Ver Pedidos.
Los precios y la moneda de tu tienda
Los precios se sincronizan con los importes que guarda tu tienda, en la moneda de tu propia tienda — la que nombran los ajustes de tu tienda de Shopify. La leemos de la tienda, nunca del comprador, y los compradores la ven como el código de tres letras junto al importe: USD 19,99, EUR 19,99, BDT 1900.
Que sea un código y no un símbolo es deliberado. $ por sí solo es el dólar de cuatro países distintos, y un símbolo equivocado con aplomo sobre un precio es peor que un código inconfundible.
La moneda se vuelve a leer en la reconciliación nocturna del catálogo, así que si la cambias en Shopify el código citado te sigue en un día. Hasta esa primera pasada nocturna, una tienda conectada antes de que empezáramos a leerla cita importes sin código — el precio sigue siendo correcto, solo que aún no está etiquetado.
Los precios de Shopify Markets no se reflejan. Si vendes en varios mercados con sus propias monedas, Shopify le muestra a cada comprador un precio local en tu tienda. Nosotros guardamos una moneda por tienda — la de tu tienda — así que el agent cita esa misma a todos los compradores, estén donde estén.
Los importes siguen siendo correctos en la moneda con la que están etiquetados; simplemente no son las cifras convertidas por mercado que ese mismo comprador vería en tu web. El pago no se ve afectado: el comprador termina en tu checkout de Shopify, que aplica tus reglas de mercado como siempre.
Solución de problemas
Las credenciales fueron rechazadas
La causa más habitual es que la app se publicó pero nunca se instaló en la tienda: son dos acciones distintas en el Dev Dashboard de Shopify. La pantalla de conexión distingue ese caso de un desajuste real de credenciales, así que lee el mensaje que te da en lugar de dar por hecho que el Client ID y el Secret están mal.
La consulta de pedidos y las actualizaciones de envío no están disponibles
Revisa Commerce → Shopify → Connection por si hay un aviso de permiso ausente. En los planes más económicos de Shopify puede que read_orders y read_customers no se puedan conceder en absoluto: ver Si algún permiso no se concede.
El catálogo está vacío justo después de conectar
La primera importación trae el catálogo entero y tarda unos minutos en una tienda grande. Si después sigue pareciendo vacío, ejecuta Re-sync now desde Commerce → Shopify → Catalog & Data. Mientras el catálogo siga vacío, la lista de comprobación de la pestaña Overview también ofrece un Sync now de un clic.
El agent no responde preguntas de producto
Comprueba que estás hablando con el agente de tienda, el que quedó asociado a la tienda al conectar. Su página de agent muestra un panel de solo lectura que indica que lo gestiona tu tienda. Los demás agents no llevan las herramientas de commerce.
Un Member no puede conectar la tienda
Conectar una tienda requiere el permiso Integration connect, que tienen Owners y Admins y no tienen los Members.
Desconectar
Desconecta desde Commerce → Shopify → Disconnect. Al desconectar:
- Se elimina la conexión guardada y el catálogo sincronizado
- Se borra el conocimiento de producto construido a partir de ese catálogo, así que los agents dejan de responder con él
- Se restablece la concesión de commerce del agente de tienda, se revierte su persona de commerce si nunca la editaste y se archiva el propio agent: volver a conectar la misma tienda lo recupera con su ajuste fino y su historial de versiones intactos
- Se eliminan permanentemente las Storefronts asociadas a esa tienda, junto con su histórico de analítica. Las Storefronts que hiciste a mano no se tocan
- Se archivan los Agent Forms de commerce que vinieron con la tienda
- Se borran las sugerencias de quiz generadas por IA, para que una futura reconexión empiece de cero
Si todavía tienes una tienda de WooCommerce conectada, solo se saltan los pasos que afectan a todo el workspace: archivar los Agent Forms de commerce y borrar las sugerencias de quiz. El catálogo, el conocimiento de producto, las Storefronts, la analítica y el agente de tienda propios de la tienda de Shopify se desmontan siempre.
Tu app sigue instalada en tu panel de Shopify. Desconectar aquí elimina nuestra parte de la relación, no la app que creaste: es de tu tienda. Bórrala desde tu panel de Shopify si quieres que desaparezca.
Relacionado
- Visión general de Commerce — qué te da conectar una tienda
- WooCommerce — la otra plataforma compatible
- Catálogo y conocimiento — cómo se sincroniza el catálogo y se mantiene al día
- Pedidos — consulta de pedidos y actualizaciones de estado
- Checkout — llevar al comprador hasta la compra