Gatilho de metacampo do produto

Gatilho de metacampo do produto

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de produto for alterado e receba o valor antigo e o novo. Requer uma definição de metacampo.

Um fabricante regista a fase de produção no metacampo do produto Estado da produção (custom.production_status). Sempre que a fase se alterar, por exemplo, de in_production para quality_check, a equipa responsável pela fase seguinte deve ser informada dessa alteração.

Esta página explica como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de um produto for alterado, utilizando as Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza o estado de produção (custom.production_status).

O que precisa

  • Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Produtos. Um metacampo sem definição não pode ser monitorizado.
  • A permissão Acesso a dados de produtos, variantes e coleções. Conceda-a na página Permissões da aplicação; consulte Autorizações e acesso aos dados.

1. Acompanhar o metacampo

  1. Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Produto.
  3. Assinale o metacampo, neste caso Estado de produção. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
  4. Clique em Adicionar gatilho.

Para acompanhar todos os metacampos deste tipo de recurso, incluindo aqueles que criar posteriormente, selecione Todos os metacampos em vez de assinalar cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

A caixa de diálogo «Adicionar Gatilho de Metacampo» com o tipo de recurso «Produto» e o metacampo «Estado de produção», custom.production_status, assinalado
Tipo de recurso: Produto, com o metacampo assinalado. A opção «Todos os metacampos» monitoriza, em vez disso, todos os metacampos desse tipo.

O novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo nos seus produtos existentes e, em seguida, Ativo. É graças a essa primeira leitura que a primeira alteração já surge com o valor anterior correto.

Se o metacampo não constar da lista, clique em Atualizar metacampos na página «Gatilhos de metacampos»: a aplicação guarda a lista de definições durante uma hora.

2. O que o fluxo de trabalho recebe

Cada alteração aciona o gatilho Metacampo Update no Shopify Flow, com os seguintes valores:

Variável Valor
resourceType PRODUCT
resourceId O ID do produto, por exemplo, gid://shopify/Product/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.production_status
metafield.value O novo valor
metafield.previousValue O valor antes da alteração; vazio quando o metacampo foi definido pela primeira vez
metafield.type O tipo do metacampo, por exemplo, single_line_text_field

Atualização do Metacampo do Produto é um segundo gatilho para a mesma alteração. É executada em complemento à «Atualização do Metacampo» e inclui o produto como uma referência nativa do Shopify Flow, pelo que as ações de produto próprias da Shopify funcionam nela sem necessidade de uma etapa de pesquisa. Ambas partilham um único evento, pelo que a utilização de ambas não conta duas vezes. Ative-o na página Gatilhos da aplicação ou ative um fluxo de trabalho que o utilize.

3. Criar o fluxo de trabalho

  1. No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
  2. Adicione uma condição: resourceType é igual a PRODUCT. A atualização do metacampo é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho aos produtos. Caso monitorize vários metacampos desse tipo, adicione metafieldKey é igual a custom.production_status como segundo critério.
  3. Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.
O fluxo de trabalho de exemplo no Shopify Flow: Atualização de metacampo, uma condição no tipo de recurso PRODUTO e Envio de e-mail interno
O fluxo de trabalho de exemplo: o gatilho, a condição relativa ao tipo de recurso e uma ação.

Comece pelo exemplo

  1. Descarregue o ficheiro .flow, que se encontra em anexo na parte inferior desta página.
  2. No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
  3. Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
  4. Ative o fluxo de trabalho.

Faça-o seu

  • Adicione uma segunda condição ao metafield.value, de modo a encaminhar cada fase para uma equipa diferente.
  • Em vez disso, identifique o produto: selecione a ação Adicionar tags ao produto e insira {{resourceId}} no campo «produto».
  • Compare metafield.previousValue com metafield.value para reagir apenas quando um valor aumentar ou diminuir.

Com que rapidez reage

O Shopify notifica a aplicação quando um produto é guardado, pelo que o fluxo de trabalho geralmente começa em poucos segundos.

Mais