Shopify
Conecte una tienda de Shopify con una aplicación del Dev Dashboard o un token de administración antiguo para que un agente pueda consultar pedidos, clientes y productos.
Qué conseguirá
Su tienda mostrará Connected en Phynxa.
Descripción general y casos de uso
La conexión puede buscar pedidos, clientes y productos y crear un cliente mediante la API GraphQL de administración de Shopify (versión 2026-10): los componentes para responder a llamadas del tipo «¿dónde está mi pedido?».
Requisitos previos
- Una tienda de Shopify de su propiedad y permiso para crear una aplicación para ella.
Configuración de la cuenta externa (en Shopify)
Shopify controla estas pantallas. La guía de Shopify: Client credentials grant.
Aplicaciones nuevas (desde el 1 de enero de 2026)
- En el Shopify Dev Dashboard, cree una aplicación que pertenezca a la misma organización que su tienda.
- Dele los ámbitos (scopes) de abajo e instálela en la tienda.
- Copie el Client ID y el Client secret.
Las aplicaciones personalizadas antiguas creadas en la administración de la tienda antes de 2026 siguen teniendo un token permanente que empieza por shpat_. Puede usarlo en su lugar.
Conéctelo en Phynxa
- Integrations, Connect en Shopify.
- Escriba el Shop (por ejemplo
acme.myshopify.com). - Escriba el Client ID y el Client secret, o solo el Admin API token (older apps) y deje vacíos los campos de cliente.
- Elija Check and connect.
Permisos y ajustes
Ámbitos: read_orders, read_customers, write_customers, read_products. Los pedidos de más de 60 días requieren además read_all_orders. Con un client secret, Phynxa obtiene un token que dura 24 horas y lo renueva automáticamente.
Úselo en una llamada
En la pestaña Tools de un agente, Add tool, Integration, Shopify:
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Find order | Consulta un pedido: estado, pago, envío y seguimiento. Necesita el order_number y el email del pedido, y no muestra nada si no coinciden ambos, así que conocer solo el número no revela nada. | Espera |
| Find customer | Encuentra a un cliente por email, phone o name: nombre, correo, teléfono y número de pedidos. Las notas internas, las etiquetas y el gasto no se comparten con el agente. | Espera |
| Create customer | Añade un cliente a partir de first_name, last_name, email y phone; hace falta un correo, un teléfono o un apellido. | En segundo plano |
| Find product | Encuentra productos por nombre: precio, existencias y variantes. Necesita query. | Espera |
Pruébelo
Test connection debe responder «Shopify is responding.»
Resultado esperado
La tarjeta muestra Connected.
Solución de problemas
- La comprobación falla. Revise la dirección de la tienda, el client ID y el secreto, y que la aplicación esté instalada en esta tienda.
- Faltan pedidos antiguos. Añada
read_all_orders. - Errores que parecen un éxito. El GraphQL de Shopify responde 200 incluso en los fallos; Phynxa los interpreta como fallos y muestra el mensaje.
Seguridad y credenciales
Los secretos se almacenan cifrados. Desinstale la aplicación en Shopify para revocar el acceso; Remove elimina aquí las credenciales.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.