> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goeva.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Conecta tu tienda Shopify
> Conecta Shopify a Eva para que tu agente venda con tus productos, precios e inventario reales y consulte pedidos dentro de la conversación.
Cuando tu tienda de Shopify está conectada, tu agente deja de adivinar: busca en tus productos reales, dice el precio que está publicado, revisa el inventario y contesta por dónde va un pedido. La conexión se hace desde el agente, en la pestaña **Herramientas**.
## Lo que vas a lograr
Un cliente va a preguntar «¿tienen esta chamarra en negro?» y tu agente va a responder con el producto de tu tienda, su precio, su disponibilidad y un enlace para pagarlo.
## Antes de empezar
* Un agente creado en Eva.
* Acceso a tu tienda como dueño, o como miembro con permiso para instalar y desarrollar apps.
* El dominio `.myshopify.com` de tu tienda. Si usas un dominio propio, ese dominio sigue existiendo en Shopify, en Ajustes → Dominios.
* Shopify habilitado en tu cuenta de Eva. Si no lo está, el conector dice «Shopify no está disponible en tu cuenta todavía. Escríbenos para activarlo».
## Dos formas de conectar
La ventana de conexión tiene dos pestañas. Elige una sola; las dos terminan en la misma conexión.
| | **OAuth (recomendado)** | **Usar token de Custom App** |
| ---------------------------- | ------------------------------------------------------- | --------------------------------------------------- |
| Cómo autorizas | Shopify te muestra los permisos y aceptas | Creas una app en tu tienda y pegas su token en Eva |
| Qué necesitas antes | El enlace de instalación que Eva prepara para tu tienda | Permisos de dueño para desarrollar apps |
| Datos personales del cliente | Incluidos con los permisos que autorizas | Solo en los planes Grow, Advanced o Plus de Shopify |
| Cambios de tu tienda | Llegan a Eva en minutos | Llegan una vez por noche |
**OAuth (recomendado)** es el camino normal. Empieza por escribirnos: preparamos el enlace de instalación de tu tienda y te lo mandamos. Ese enlace siempre va primero: si empiezas desde **Conectar Shopify** antes de haberlo abierto en Shopify, Shopify responde que el enlace de instalación no es válido y la conexión no llega a Eva.
## Pasos
En el menú lateral, entra a **Agentes IA**, abre tu agente y ve a **Herramientas**.
En la tarjeta de **Shopify**, selecciona **Conectar Shopify**. Se abre **Conectar tu tienda Shopify** con las dos pestañas.
Selecciona **OAuth (recomendado)** o **Usar token de Custom App**. La ventana cambia según lo que elijas.
Instala primero en Shopify el enlace que te mandamos. Después vuelve a esta ventana, escribe el **Dominio Shopify** de tu tienda y selecciona **Continuar a Shopify**. Shopify te muestra los permisos y tú los aceptas.
Selecciona **Ver instrucciones de configuración** y sigue los siete pasos dentro de tu Shopify Admin: creas la app, marcas los permisos, la instalas y revelas el token de la Admin API. Shopify enseña ese token una sola vez. Pega el **Dominio Shopify** y el token, y selecciona **Conectar tienda**.
**Importar tus clientes de Shopify con su ciudad y consentimiento** viene encendido. Se agregan a Contactos sin escribirles, y puedes apagarlo antes de conectar.
La importación necesita el permiso de clientes. Si no autorizaste `read_customers`, no se importa a nadie y la tarjeta de Shopify lo dice: «Clientes de Shopify: falta el permiso de clientes en Shopify (read\_customers)».
## Lo que Shopify te va a pedir
Shopify pide permisos, uno por cada cosa que quieres que el agente haga. Los dos primeros son obligatorios: sin ellos Eva no puede leer tu catálogo.
| Lo que habilitas en Eva | Permiso que autorizas |
| ---------------------------------------------------------------- | ---------------------------------- |
| Búsqueda de productos y envío de enlaces de compra (obligatorio) | `read_products` y `read_inventory` |
| Consulta de stock por tienda o ubicación | `read_locations` |
| Estado de pedidos y tracking | `read_orders` |
| Perfil del cliente, e importar tus clientes a Contactos | `read_customers` |
| Crear pedidos borrador y enviar la factura por correo | `write_draft_orders` |
En la pestaña **Usar token de Custom App**, el correo, el teléfono, el nombre y la dirección del cliente solo llegan si tu tienda está en el plan Grow, Advanced o Plus de Shopify. En Basic o Starter esos campos llegan vacíos y las respuestas sobre pedidos no funcionan. La ventana lo repite en **Antes de empezar, confirma**, junto a **Plan Shopify**.
Un permiso que no autorizaste no rompe la conexión: la acción que lo necesita sigue encendida y responde que le falta ese permiso. Para agregarlo, vuelve a los permisos de la app en Shopify y márcalo; el token no cambia.
## Después de conectar
Las seis acciones de Shopify se encienden solas, y las ves bajo **¿Qué puede hacer el agente?** en **Herramientas** → **Shopify**:
* **Enviar link de pago**
* **Consultar pedidos del cliente**
* **Consultar inventario por ubicación**
* **Buscar información del cliente**
* **Crear orden borrador**
* **Rastrear pedidos**
Puedes apagar la que no quieras. Esa decisión se respeta: si después desconectas y vuelves a conectar, lo que apagaste a mano sigue apagado.
Al mismo tiempo empieza la importación de tus productos. Ábrela en la pestaña **Catálogo** del agente: mientras trabaja, la tarjeta dice **Sincronizando catálogo**. En una tienda con pocos productos son minutos; en un catálogo grande la primera importación puede acercarse a una hora.
Eva importa solo los productos activos y publicados de tu tienda. Los borradores, los archivados y los que no están publicados no entran, ni cuando los edites después.
Ya importado, el catálogo se mantiene solo. Conectado por OAuth, la tarjeta dice **Se actualiza automáticamente en minutos cuando cambia tu tienda**. Conectado con token, dice **Se actualiza una vez por noche; usa Sincronizar ahora para lo urgente**.
Los productos que vienen de Shopify son de solo lectura en Eva. Se editan en Shopify y llegan en la siguiente sincronización.
## Cómo saber que funcionó
La tarjeta de Shopify en **Herramientas** dice **Conectado** y muestra **Tienda:** con tu dominio. En **Catálogo**, la fuente aparece como **Shopify · Tienda conectada** con el conteo de productos.
La prueba de verdad es preguntarle. Abre **Probar** y pídele a tu agente un producto que sepas que existe, con todo y precio.
## Si algo sale mal
Ese mensaje aparece cuando la instalación empezó desde Eva en vez de empezar desde el enlace que preparamos para tu tienda. Abre primero ese enlace. Si ya lo abriste y sigue fallando, cierra las pestañas de Shopify, entra como dueño de la tienda en una ventana de incógnito y vuelve a abrir el enlace.
Falta el permiso que esa acción necesita. Vuelve a los permisos de la Admin API en tu app de Shopify, marca el que falta y guarda. El token que ya pegaste sigue sirviendo: el agente toma el permiso nuevo en su siguiente consulta a Shopify.
Revisa la fecha de la última sincronización en la pestaña **Catálogo**. Con una conexión por token los cambios llegan una vez por noche, así que para algo urgente usa **Sincronizar ahora**.
Eva avisa cuando Shopify dejó de aceptar su acceso o cuando pide autorizar de nuevo. En los dos casos tus productos y tu inventario dejan de actualizarse hasta que vuelvas a autorizar desde la tarjeta de Shopify. Los mensajes que ya llegaron se siguen viendo en la Bandeja.
## Desconectar y volver a conectar
En la tarjeta de Shopify, selecciona **Desconectar**. El estado pasa a **Desconectado** y las seis acciones se apagan: tu agente deja de consultar la tienda.
Tus productos no se borran. Se quedan guardados justo para que una reconexión no tenga que importar todo otra vez desde cero.
Para volver, selecciona **Reconectar** y repite el camino que ya usabas. Las acciones vuelven a encenderse, salvo las que tú habías apagado a mano.
## Siguientes pasos