Vista previa de los datos de la API utilizados en Shopify Flow

Cuando crees un flujo de trabajo, es posible que a menudo desees usar los datos de la tienda en condiciones y acciones. Shopify Flow accede a los datos de la tienda mediante una llamada a la API del panel de control de GraphQL, lo que significa que tienes acceso a casi todos los campos de la API.

A medida que crees un flujo de trabajo, a menudo te encontrarás con nombres y descripciones de campo basados en la API, pero es posible que necesites saber los datos que esta genera. Por ejemplo, es posible que desees conocer el nombre de la aplicación para un pedido que se creó a partir de un pedido preliminar. Además, es posible que desees asegurarte de que el flujo de trabajo genere los datos que esperas o en la forma que pretendes.

Para revisar los datos, tienes varias opciones en Shopify Flow.

Buscar un campo en el panel de control de Shopify

En la mayoría de los casos, los datos están disponibles en el panel de control de Shopify.

Usar el campo en un flujo de trabajo en vivo

Puedes crear un flujo de trabajo con acciones que te ayuden a revisar los datos en vez de las acciones que planeas usar en la versión final. Por ejemplo, supongamos que deseas crear un flujo de trabajo que cancele un pedido. En lugar de usar la acción Cancelar pedido y cancelar potencialmente el pedido incorrecto, puedes comenzar con la acción Enviar correo electrónico interno o la acción Enviar mensaje de Slack si usas esta aplicación.

Pasos:

1. Selecciona un activador que se pueda ejecutar manualmente.
2. Agrega una acción al flujo de trabajo y conéctala al activador, por ejemplo, Enviar correo electrónico interno.
3. Agrega las variables que deseas inspeccionar a la sección Mensaje de la acción Enviar correo electrónico interno.
4. Haz clic en Activar flujo de trabajo.
5. Activa el flujo de trabajo. Para ello, ejecútalo manualmente o haz que el activador se dispare. Por ejemplo, si estás usando el activador Pedido creado, crea un pedido de prueba.
6. Después de que se ejecute el flujo de trabajo, verifica las variables en tu correo electrónico.

Consultar la página JSON de recursos

La mayoría de las páginas de recursos en el panel de control de Shopify, como Pedido, Producto o Cliente, te permiten ver los datos que las sirven. Estos datos no presentan la nomenclatura y el formato exactamente de la misma manera que lo hace Shopify Flow, pero los valores coinciden con los de la API del panel de control de GraphQL. Para revisar los datos, agrega .json a la URL.

Por ejemplo, navega hasta la página Pedidos del panel de control de Shopify y haz clic en un pedido. En la barra de direcciones del navegador, cambia la dirección de la página de:

https://<your_domain>.myshopify.com/admin/orders/3804849891234

A lo siguiente:

https://<your_domain>.myshopify.com/admin/orders/3804849891234.json

Nota

El formato .json sigue la API REST. El uso de mayúsculas o minúsculas de los nombres de variable en la API REST utiliza guiones bajos, como line_items. GraphQL y Shopify Flow usan camelCasing, como lineItems. Además, a veces los nombres de campo difieren, como properties en lugar de customAttributes. Verifica la información que encuentres con este método.

Usar GraphiQL o una herramienta API externa

Puedes consultar directamente la API con una herramienta API externa, como Postman, o con la herramienta gratuita de Shopify, GraphiQL. Esta opción ofrece los resultados más precisos, pero es necesario tener ciertos conocimientos en la creación de las consultas de GraphQL.

Para GraphiQL, Shopify ofrece tanto un explorador de GraphiQL basado en la web con datos genéricos como la aplicación GraphiQL. Con GraphiQL, puedes crear una consulta de GraphQL que coincida exactamente con los nombres de campo que ves en Shopify Flow. Los valores también coinciden exactamente con los de la tienda si usas la aplicación.

Al usar esta herramienta, puedes determinar exactamente los datos que utiliza Shopify Flow con los datos reales de la tienda. Por ejemplo, creas la siguiente consulta:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

En los siguientes resultados, la variable order / app / name muestra el nombre de la aplicación para el pedido. En este caso, el pedido se creó desde la aplicación de pedidos preliminares, por lo que el valor es Draft Orders. La información del canal solo está disponible para la aplicación Point of Sale.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }