> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/shopify.md).

# Shopify

{% hint style="warning" %}
⚠️ Importante: esta integración está en una **primera versión**, por eso requiere un setup extra en Shopify (crear una app + permisos).
{% endhint %}

✅ 1) ¿Qué podés hacer con Shopify conectado?

* 📦 Leer productos: **nombre, precio, stock, descripción**
* 🎯 Recomendar productos según lo que pregunte el cliente
* 🔗 Enviar **links directos** a productos para comprar
* 🧾 Consultar **estado de pedido** usando el **número de orden**

### 🔌 2) Conectar Shopify con Prometheo (paso a paso)

#### A) Configuración en Shopify (crear la app)

1. Entrá a tu Shopify.
2. Andá a **Apps y canales de venta**.
3. Click en **Desarrollar apps en Dev Dashboard**.

<figure><img src="/files/pq5EFye5qZx7fkTwHmMa" alt=""><figcaption></figcaption></figure>

4. Click en **Create app**.

<figure><img src="/files/h9DzoQ0skvf8zrOsBjer" alt=""><figcaption></figcaption></figure>

1. En **App name** poné: `Prometheo` (o el nombre que quieras).

[https://admin.shopify.com/store/NOMBRE-DE-LA-TIENDA/settings/apps/development](https://admin.shopify.com/store/agustest-2/settings/apps/development)

**Configuración de la app**\
6\) En URLs pegá:\
`https://app.prometheo.ai/dashboard`

7. Desactivá ✅/❌ la opción: **“Embed app in Shopify admin”** (dejala destildada).

**Permisos (Scopes)**\
8\) En Access / Scopes pegá tal cual (separados por coma):\
`read_checkouts,write_draft_orders,read_fulfillments,read_inventory,read_orders,read_products,read_customers`

<figure><img src="/files/iYjkveP1ybzxuJwc86dG" alt=""><figcaption></figcaption></figure>

**Redirect URL**\
9\) En Redirect URLs agregá:\
`https://prometheo-be.itesa.co/v1/auth/shopify/callback`

**Publicar la app**\
10\) Guardá y hacé click en **Release**.\
11\) Confirmá con una versión (ej: `1`) y un comentario breve (cualquier texto).

**Credenciales**\
12\) Entrá a **Settings** de la app y copiá:

* 🔑 **Client ID**
* 🔒 **Client Secret**\
  Guardalos: los vas a pegar en Prometheo.

<figure><img src="/files/7VngxDVIeCUv392bJAIV" alt=""><figcaption></figcaption></figure>

***

#### B) Conexión desde Prometheo

1. Entrá a Prometheo.
2. Ir a **Conexiones → Integraciones → Shopify**.
3. Pegá:

* Client ID
* Client Secret

4. Guardá.
5. Click en **Conectar tienda** (o similar).
6. Se abre Shopify → iniciá sesión y **aceptá permisos**.

✅ Listo: Prometheo empieza a leer tu catálogo.\
🔄 Si querés forzar actualización, volvés a **Conexiones → Shopify** y reconectás/actualizás (según te aparezca).

***

### 🧠 3) Cómo hacer que el asistente “use Shopify” (en el prompt)

Si no se lo indicás, puede responder más genérico. Sumá una regla clara en el prompt, por ejemplo:

> “Usá la integración con Shopify para consultar productos, precios, stock y descripciones. Recomendá 1 a 3 opciones y enviá siempre el link correcto. Si preguntan por un pedido, pedí el número de orden y consultá su estado.”

💡 Podés sumar reglas tuyas:

* qué decir si **no hay stock**
* cómo ofrecer **alternativas**
* cómo responder por **seguimiento de pedidos**

***

### 💬 4) Ejemplos típicos en el chat (lo que debería poder hacer)

* “Busco zapatillas negras talle 42” → muestra 2–3 opciones + links 🔗
* “¿Tenés stock del producto X?” → consulta stock real 📦
* “¿Cuánto sale el modelo Y?” → devuelve precio actual 💲
* “Estado de pedido #1234” → consulta por número de orden 🧾