Saltar al contenido principal

​
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.
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.

Productos

Busca y obtén información detallada de productos de tu tienda

Producto

Obtén información detallada de un producto específico

Colecciones

Accede a colecciones y organiza mejor tu catálogo

Pedidos

Rastrea y consulta el estado de los pedidos

​
Productos

​
getProducts

Obtener una lista de productos de la tienda con filtrado opcional. Campos disponibles:
CampoTipoRequeridoDescripción
productNamestringOpcionalFiltrar productos por nombre
variantNamestringOpcionalFiltrar por nombre de variante (color, tamaño, etc.)
productTypestringOpcionalFiltrar por tipo/categoría de producto
productTagstringOpcionalFiltrar por etiqueta de producto
productVendorstringOpcionalFiltrar por proveedor de producto
minPricenumberOpcionalFiltro de precio mínimo (por defecto 0 si no se proporciona)
maxPricenumberOpcionalFiltro de precio máximo (por defecto 0 si no se proporciona)
bringOnlyAvailablebooleanOpcionalFiltrar para mostrar solo productos en stock (por defecto falso)

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 50y50 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:
CampoTipoRequeridoDescripción
productIdstringRequeridoID de producto Shopify en formato “gid://shopify/Product/1234567890”

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:
CampoTipoRequeridoDescripción
collectionNamestringOpcionalFiltrar colecciones por nombre

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:
CampoTipoRequeridoDescripción
collectionIdstringRequeridoID de colección Shopify en formato “gid://shopify/Collection/1234567890”

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:
CampoTipoRequeridoDescripción
orderIdstringRequeridoID del pedido (ej., “#1001”, “EN1001”, o “1001-A”)
emailstringRequeridoCorreo electrónico del cliente para verificación del pedido

Ejemplo de uso

  • Usuario: “¿Cuál es el estado de mi pedido #1001?”
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

Carritos Abandonados

Aprende cómo configurar y gestionar los carritos abandonados en tu integración de Shopify.