Activador de metacampo de pedido

Activador de metacampo de pedido

Copiar página

Inicie un flujo de trabajo de Shopify Flow cuando cambie un metacampo de pedido, como un mensaje de regalo, y obtenga el valor anterior y el nuevo.

Un cliente solicita al soporte que añada una nota de regalo una vez realizado el pedido. El soporte la introduce en el metacampo del pedido Mensaje de regalo (custom.gift_message), y el equipo de embalaje debe revisarla antes de que salga el paquete.

En esta página se explica cómo iniciar un flujo de trabajo de Shopify Flow cada vez que se modifique un metacampo de un pedido, mediante Workflow Trigger Extensions. Los pasos son los mismos para todos los metacampos de este tipo de recurso; en el ejemplo se utiliza el Mensaje de regalo (custom.gift_message).

Lo que necesita

  • Una definición de metacampo. Créela en su panel de administración de Shopify, en Configuración > Metacampos y metaobjetos > Pedidos. No es posible realizar un seguimiento de un metacampo que no cuente con una definición.
  • El permiso Acceso a los datos de los pedidos. Concédalo en la página Permisos de la aplicación; consulte Permisos y acceso a los datos.

1. Realice un seguimiento del metacampo

  1. Abra Metacampos Activadores en la aplicación y haga clic en Añadir activador.
  2. Seleccione el tipo de recurso Pedido.
  3. Marque el metacampo Mensaje de regalo. Puede marcar varios a la vez o utilizar la opción Seleccionar todo.
  4. Haga clic en Añadir activador.

Para realizar un seguimiento de todos los metacampos de este tipo de recurso, incluidos los que cree posteriormente, seleccione Todos los metacampos en lugar de marcar uno por uno y, a continuación, haga clic en Realizar seguimiento de todos los metacampos.

El cuadro de diálogo «Añadir activador de metacampo» con el tipo de recurso «Pedido» y el metacampo «Mensaje de regalo» (custom.gift_message) marcado
Tipo de recurso: Pedido; el metacampo está marcado. La opción «Todos los metacampos» realiza un seguimiento de todos los metacampos de ese tipo.

El nuevo activador muestra Inicializando mientras la aplicación lee el valor actual del metacampo en sus pedidos existentes y, a continuación, Activo. Esa primera lectura es la razón por la que el primer cambio ya llega con el valor anterior correcto.

Si el metacampo no aparece en la lista, haga clic en Actualizar metacampos en la página «Activadores de metacampos»: la aplicación conserva la lista de definiciones durante una hora.

2. Lo que recibe el flujo de trabajo

Cada cambio activa el activador Metacampo Update en Shopify Flow con estos valores:

Variable Valor
resourceType ORDER
resourceId El ID del pedido, por ejemplo, gid://shopify/Order/1234567890
metafieldKey Espacio de nombres y clave: en este caso, custom.gift_message
metafield.value El nuevo valor
metafield.previousValue El valor anterior al cambio; vacío cuando se configuró el metacampo por primera vez
metafield.type El tipo del metacampo, por ejemplo, single_line_text_field

Actualización de metacampo de pedido es un segundo activador para el mismo cambio. Se inicia además de «Actualización de metacampo» e incorpora el pedido como una referencia nativa de Flow, por lo que las acciones propias de Shopify relacionadas con los pedidos funcionan en él sin necesidad de un paso de búsqueda. Ambos comparten un mismo evento, por lo que su uso conjunto no se contabiliza dos veces. Actívelo desde la página Activadores de la aplicación o active un flujo de trabajo que lo utilice.

3. Crear el flujo de trabajo

  1. En Shopify Flow, cree un flujo de trabajo y seleccione el activador Actualización de metacampos de Workflow Trigger Extensions.
  2. Añada una condición: resourceType es igual a ORDER. La actualización de metacampos se inicia para cada tipo de recurso que realice un seguimiento, por lo que esta condición limita este flujo de trabajo a los pedidos. Si realiza un seguimiento de varios metacampos de ese tipo, añada como segundo criterio que metafieldKey sea igual a custom.gift_message.
  3. Añada la acción que necesite. En el ejemplo se envía un correo electrónico interno con el valor anterior y el nuevo.
El flujo de trabajo de ejemplo en Shopify Flow: Actualización de metacampos, una condición sobre el tipo de recurso «Pedido» y envío de un correo electrónico interno
El flujo de trabajo de ejemplo: el activador, la condición relativa al tipo de recurso y una acción.

Empiece por el ejemplo

  1. Descargue el archivo .flow que se adjunta al final de esta página.
  2. En su panel de administración de Shopify, abra Shopify Flow, haga clic en Importar y seleccione el archivo.
  3. Abra el paso Enviar correo electrónico interno e introduzca el destinatario. El archivo no contiene ninguna dirección a propósito.
  4. Active el flujo de trabajo.

Hágalo suyo

  • Etiquetar el pedido: seleccione la acción Añadir etiquetas al pedido e introduzca {{resourceId}} en el campo correspondiente.
  • Añada la condición «metafield.value no está vacío», de modo que, cuando se elimine un mensaje, no se envíe nada.
  • Utilice la opción Actualización de metacampos del pedido cuando el flujo de trabajo deba leer los artículos o la dirección de envío.

Con qué rapidez reacciona

Shopify notifica a la aplicación cuando se guarda un pedido, por lo que el flujo de trabajo suele iniciarse en cuestión de segundos.

Es bueno saberlo

  • De forma predeterminada, la aplicación muestra los pedidos creados en los últimos 60 días. Para consultar pedidos más antiguos, es necesario disponer de acceso completo al historial de pedidos en la página «Permisos» y seleccionar un intervalo más amplio en la configuración del historial de pedidos de la aplicación.

Más