> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doko-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de Shopify

> Descubre las herramientas del Agente de Shopify que permiten a tu chatbot buscar productos, verificar inventario, rastrear pedidos y acceder a colecciones.

## Herramientas del Agente de Shopify

Estas herramientas funcionan internamente para proporcionar a tu chatbot capacidades completas de la tienda Shopify. Tus agentes pueden buscar productos, verificar inventario, rastrear pedidos y más.

> [!NOTE]
>
> Estas herramientas operan automáticamente en segundo plano. Los usuarios interactúan con tu chatbot de forma natural, y el agente selecciona y usa inteligentemente estas herramientas para proporcionar información precisa y actualizada sobre tu tienda.

> [card] [Productos](#productos)
>
> Busca y obtén información detallada de productos de tu tienda

> [card] [Producto](#getproduct)
>
> Obtén información detallada de un producto específico

> [card] [Colecciones](#colecciones)
>
> Accede a colecciones y organiza mejor tu catálogo

> [card] [Pedidos](#pedidos)
>
> Rastrea y consulta el estado de los pedidos

## Productos

### getProducts

Obtener una lista de productos de la tienda con filtrado opcional.

**Campos disponibles:**

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `productName` | string | Opcional | Filtrar productos por nombre |
| `variantName` | string | Opcional | Filtrar por nombre de variante (color, tamaño, etc.) |
| `productType` | string | Opcional | Filtrar por tipo/categoría de producto |
| `productTag` | string | Opcional | Filtrar por etiqueta de producto |
| `productVendor` | string | Opcional | Filtrar por proveedor de producto |
| `minPrice` | number | Opcional | Filtro de precio mínimo (por defecto 0 si no se proporciona) |
| `maxPrice` | number | Opcional | Filtro de precio máximo (por defecto 0 si no se proporciona) |
| `bringOnlyAvailable` | boolean | Opcional | Filtrar para mostrar solo productos en stock (por defecto falso) |

> [accordion] Ejemplos de uso
>
> * *Usuario:* "¿Qué camisetas tienen disponible?"
>   * *El agente usa:* `getProducts` con `productName: "camiseta"` y `bringOnlyAvailable: true`
> * *Usuario:* "Muéstrame productos de zapatos entre $50 y $100"
>   * *El agente usa:* `getProducts` con `productType: "zapatos"`, `minPrice: 50`, `maxPrice: 100`
> * *Usuario:* "¿Tienen camisas en color azul?"
>   * *El agente usa:* `getProducts` con `productName: "camisa"` y `variantName: "azul"`

### getProduct

Obtener información detallada sobre un producto específico.

**Campos disponibles:**

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `productId` | string | Requerido | ID de producto Shopify en formato "gid://shopify/Product/1234567890" |

> [accordion] Ejemplo de uso
>
> * *Usuario:* "Muéstrame los detalles del producto 1234567890"
>   * *El agente usa:* `getProduct` con `productId: "gid://shopify/Product/1234567890"`

***

## Colecciones

### getCollections

Obtener una lista de colecciones de la tienda.

**Campos disponibles:**

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `collectionName` | string | Opcional | Filtrar colecciones por nombre |

> [accordion] Ejemplos de uso
>
> * *Usuario:* "¿Qué colecciones tienen?"
>   * *El agente usa:* `getCollections` sin filtros para listar todas las colecciones
> * *Usuario:* "Muéstrame la colección de verano"
>   * *El agente usa:* `getCollections` con `collectionName: "verano"`

### getCollection

Obtener información detallada sobre una colección específica.

**Campos disponibles:**

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `collectionId` | string | Requerido | ID de colección Shopify en formato "gid://shopify/Collection/1234567890" |

> [accordion] Ejemplo de uso
>
> * *Usuario:* "Muéstrame los detalles de la colección 1234567890"
>   * *El agente usa:* `getCollection` con `collectionId: "gid://shopify/Collection/1234567890"`

***

## Pedidos

### getTrackingInfo

Obtener información de seguimiento/estado para un pedido específico.

**Campos disponibles:**

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `orderId` | string | Requerido | ID del pedido (ej., "#1001", "EN1001", o "1001-A") |
| `email` | string | Requerido | Correo electrónico del cliente para verificación del pedido |

> [accordion] Ejemplo de uso
>
> * *Usuario:* "¿Cuál es el estado de mi pedido #1001?"
>   * *El agente usa:* `getTrackingInfo` con `orderId: "#1001"` y `email: "cliente@ejemplo.com"`

> [!TIP]
>
> El agente puede manejar diferentes formatos de ID de pedido. Acepta números simples, códigos con prefijos como "#" o "EN", y formatos con sufijos como "1001-A".

## Siguientes Pasos

> [card] [Carritos Abandonados](https://docs.doko-ai.com/es/mensajes/conf-shopify.md)
>
> Aprende cómo configurar y gestionar los carritos abandonados en tu integración de Shopify.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.