Acciones de Shopify
Conecta una tienda de Shopify para que tu agente pueda buscar en tu catálogo y consultar el estado de un pedido en el chat.
Conecta una tienda de Shopify a tu agente y podrá responder preguntas sobre productos a partir de tu catálogo en vivo y consultar el estado de un pedido durante una conversación. Esto es independiente de colocar el widget de chat en tu tienda; consulta la integración de Shopify para eso.
Conectar primero tu tienda
Ambas acciones necesitan una tienda conectada.
- Ve a la pestaña Acciones de tu agente
- Abre Integraciones y busca la tarjeta Shopify
- Ingresa el dominio de tu tienda con el formato
store-name.myshopify.com - Completa la pantalla de consentimiento de Shopify
La tarjeta muestra entonces el estado de la conexión y te permite Reconectar o Desconectar. Si la conexión necesita atención, aparece un aviso en color ámbar con una solicitud para reconectar.
La conexión es por agente. Cada agente conecta su propia tienda, así que un agente que deba responder por una tienda distinta obtiene su propia conexión en lugar de compartir una.
Qué acceso se solicita
En la pantalla de consentimiento, Agentkit solicita exactamente dos permisos de lectura:
| Permiso | Se usa para |
|---|---|
read_products | Buscar en tu catálogo |
read_orders | Consultar el estado de un pedido |
No se solicita ningún permiso de escritura. La conexión también usa el token offline predeterminado de Shopify —la solicitud omite deliberadamente la opción de autorización por usuario—, de modo que el agente sigue funcionando después de que la persona que conectó la tienda cierra sesión.
Estos son los permisos que solicita la implementación actual. Shopify decide por separado qué datos puede recibir una app: algunos campos de clientes y pedidos están protegidos, y que se conceda read_orders no garantiza por sí solo que se devuelva cada campo.
Las dos acciones
Cada acción se agrega y se configura por separado en Acciones.
Buscar productos
Permite que el agente busque en el catálogo de la tienda conectada cuando un visitante pregunta sobre productos, precios o disponibilidad. Puede acotar los resultados por consulta, un precio máximo opcional y un límite de resultados.
Los resultados incluyen únicamente productos activos publicados en tu tienda online. La disponibilidad se obtiene del inventario del producto en Shopify e incluye los productos que no hacen seguimiento del inventario.
La instrucción predeterminada de «cuándo usarla» es "Use when the user wants to find products, compare prices, or check whether an item is available." Edítala para que coincida con la forma en que tus visitantes preguntan.
Obtener el estado del pedido
Busca un pedido concreto. El visitante debe indicar tanto el número de pedido como el correo electrónico del checkout, y ambos deben corresponder al mismo pedido antes de que se devuelva algo.
Esa combinación es una medida de privacidad: un número de pedido por sí solo es fácil de adivinar o de ver por encima del hombro, así que nunca es suficiente. Si el pedido no existe o el correo electrónico no coincide con el pedido, el agente recibe la misma respuesta genérica «We could not find an order matching those details.» —no puede saber cuál de los dos datos era incorrecto, y el visitante tampoco.
Los pedidos más antiguos pueden generar la misma respuesta de «no encontrado» aunque el número y el correo electrónico sean correctos: Agentkit solicita el permiso estándar read_orders de Shopify, que cubre los pedidos recientes de la tienda (aproximadamente los últimos 60 días), no el historial completo de pedidos, que se aprueba por separado. Si las consultas de pedidos antiguos son importantes para tu tienda, prepárate para dirigir a los visitantes con pedidos antiguos a tu canal de soporte.
La instrucción predeterminada de «cuándo usarla» es "Use when the user asks for an order status or tracking details and can provide the order number and checkout email."
Dos condiciones para activar una acción
Ambas deben cumplirse antes de que una acción pueda activarse:
- Una tienda conectada - sin ella, el interruptor de activación muestra un aviso en línea que enlaza a Acciones → Integraciones
- Un plan de pago - el mismo requisito que API personalizada, Búsqueda web, Leer enlaces de documentos y las acciones de reserva
Aun así puedes crear, editar y guardar cualquiera de las dos acciones mientras está desactivada, sin que se cumpla ninguno de los dos requisitos. Los requisitos solo se aplican al activarla.
Solución de problemas
El OAuth se completó, pero las consultas de pedidos no devuelven nada. Revisa el formato del número de pedido que usa tu tienda y confirma que el correo con el que estás probando sea el correo electrónico del checkout de ese pedido. Luego verifica la habilitación de la app para datos protegidos de clientes y pedidos en la tienda —el acceso a esos datos debe ser necesario para la app y Shopify puede restringirlo. Solicitar permisos más amplios no cambia esto, y volver a conectar no garantiza la aprobación.
El agente responde con contenido de entrenamiento en lugar del catálogo. Afina la instrucción de «cuándo usarla» para que las preguntas sobre productos, precios y disponibilidad se dirijan claramente a la acción de búsqueda.
La tarjeta muestra una advertencia para reconectar. La autorización guardada ya no es utilizable. Haz clic en Reconectar y completa de nuevo la pantalla de consentimiento. Reconectar restablece la conexión, pero no las acciones: cuando la autorización guardada falla, ambas acciones de Shopify se desactivan automáticamente, y la pantalla de consentimiento no las vuelve a activar. Después de reconectar, vuelve a Acciones y vuelve a activar cada acción que quieras que esté activa.