Shopify Flow y GraphQL Admin API

Flow usa Shopify GraphQL Admin API para crear automatizaciones e integraciones que amplían y mejoran el panel de control de Shopify. Flow usa la versión 2026-01 de la API para evaluar conditions y variables en los flujos de trabajo, y para ejecutar actions en la tienda Shopify. Como Flow accede a los datos de la tienda mediante la API, desde Flow tienes acceso a casi todos los campos disponibles en la API.

Como Shopify lanza nuevas versiones de la API cada 3 meses, quizá tengas que actualizar algunos flujos de trabajo cuando se modifiquen campos o se declaren obsoletos.

Usar GraphQL Admin API en flujos de trabajo

La mayoría de las acciones en Flow usan GraphQL Admin API para realizar cambios en la tienda Shopify. Por ejemplo, la acción Add order tags usa la mutación tagsAdd. La acción Send Admin API request puede usar la mayoría de las mutaciones, incluidas las que aún no están disponibles como acciones en Flow.

Cuando crees flujos de trabajo, a menudo verás nombres de campos y descripciones basados en la sintaxis de GraphQL Admin API. Por ejemplo, para determinar la cantidad total vendible de una variante en un flujo de trabajo, usarías la variable variants_item.inventoryQuantity. Otro ejemplo: para determinar el lugar donde un cliente se suscribió al boletín por correo electrónico, usarías la variable emailSubscriptionMethod.

No necesitas dominar la API para crear flujos de trabajo con la aplicación Flow, pero entender un poco los nombres de las variables y sus definiciones puede ayudarte a crear la lógica específica que buscas. Por ejemplo, conocer la diferencia entre el displayName de un cliente y su firstName puede ayudar a que el flujo de trabajo acceda a los datos correctos según lo que quieras hacer. Cada variable incluye su definición mientras creas el flujo de trabajo, y puedes hacer clic en para obtener más información sobre cualquier variable o definición.

Datos de la tienda y GraphQL Admin API

Los flujos de trabajo usan los datos de la tienda en las condiciones y las acciones. Flow accede a los datos de la tienda mediante GraphQL Admin API, lo que significa que tienes acceso a casi todos los campos de la API. Si una acción no tiene los datos necesarios que proporciona el activador o una Get data action, el flujo de trabajo no se ejecuta y se muestra un mensaje de error.

Por ejemplo, un flujo de trabajo comienza con el activador Cliente creado e importa los datos del cliente al flujo. Si después de ese activador agregas la acción Agregar etiquetas al pedido, que requiere datos del pedido y no del cliente, el flujo de trabajo generará un error por datos faltantes.

Quizá necesites preview data o revisar la API documentation para entender qué devuelve la API y qué utiliza Flow, y para asegurarte de que el flujo de trabajo genere los datos que esperas.

Argumentos de campo y GraphQL Admin API

Algunos campos de la GraphQL Admin API requieren argumentos, parámetros adicionales que limitan los datos que se devuelven. Por ejemplo, el campo product.inCollection necesita un argumento de id de colección para saber qué colección revisar. Sin este, el campo no puede arrojar un resultado.

En Flow, puedes crear variables a partir de estos campos proporcionando el valor del argumento requerido, que luego se puede usar en el flujo de trabajo. También puedes asignarle un nombre personalizado a la variable para que sea más fácil hacer referencia a ella en los siguientes pasos; por ejemplo, llamar a product.inCollection(id: "gid://shopify/Collection/123456") como product.inSummerBestsellers.

Más información sobre cómo crear variables a partir de campos con argumentos.

La creación de variables a partir de metacampos requiere información adicional en Flow porque tú defines el espacio de nombres y la clave de cada metacampo, por lo que los argumentos siempre son exclusivos de tu tienda. Más información sobre metacampos en Flow.

Versionado de la API

Shopify lanza nuevas API versions cada 3 meses y Flow adopta las nuevas versiones lo antes posible, aunque podría quedar por detrás de la más reciente. Cuando es posible, los cambios entre versiones se resuelven automáticamente, pero algunos cambios pueden no ser sencillos, incluidas las siguientes situaciones:

• Cuando se eliminan campos y no se proporciona un reemplazo, lo que puede afectar cómo se evalúan las condiciones o Liquid.
• Cuando los campos pasan a permitir valores nulos, lo que puede afectar cómo se evalúan las condiciones o Liquid.
• Cuando cambian los valores de un enum o se agregan nuevos tipos union o interface, lo que puede afectar a Liquid o al código.
• Cuando cambian los argumentos de una mutación, lo que puede afectar la configuración de las acciones Send Admin API request.

Es posible que tengas que actualizar algunos flujos de trabajo manualmente. En estos casos, los flujos de trabajo pueden mostrar un error Se requiere actualización o API no compatible y guiarte a la API documentation correspondiente para realizar los cambios necesarios en el editor de flujos de trabajo. Cuando completes y guardes estas actualizaciones, el flujo de trabajo se actualizará automáticamente para usar la versión de la API más reciente disponible en Flow.

Puedes optar por ignorar temporalmente los problemas para hacer cambios urgentes en un flujo de trabajo con errores de compatibilidad de versión de la API. Si no se abordan estos problemas, el flujo de trabajo podría dejar de ejecutarse o causar errores cuando Shopify ya no admita la versión anterior de la API.