Gatilho de metacampo «Pedido»

Gatilho de metacampo «Pedido»

Copiar página

Inicie um fluxo do Shopify Flow quando um metacampo de pedido for alterado, como uma mensagem de presente, e obtenha o valor antigo e o novo.

Um cliente solicita ao suporte que adicione uma mensagem de presente após a realização do pedido. O suporte insere-a no metacampo do pedido Mensagem de presente (custom.gift_message), e a equipa de embalagem deve ver essa mensagem antes de o pedido sair.

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

O que precisa

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

1. Acompanhar o metacampo

  1. Abra a secção Gatilhos de Metacampos na aplicação e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Pedido.
  3. Assinale o metacampo Mensagem de presente. 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 apenas alguns e, em seguida, clique em Acompanhar todos os metacampos.

A caixa de diálogo «Adicionar Gatilho de Metacampo» com o tipo de recurso «Pedido» e o metacampo «Mensagem de presente», custom.gift_message, assinalado
Tipo de recurso: Pedido, 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 nas suas encomendas existentes e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já seja apresentada 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 ORDER
resourceId O ID do pedido, por exemplo, gid://shopify/Order/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.gift_message
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

A Atualização do Metacampo da Encomenda é um segundo gatilho para a mesma alteração. É acionado em complemento à «Atualização do Metacampo» e transporta a encomenda como uma referência nativa do Flow, pelo que as ações relativas às encomendas do próprio Shopify funcionam com ela sem necessidade de uma etapa de pesquisa. Ambos partilham um único evento, pelo que a utilização de ambos 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 ORDER. A atualização do metacampo é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho aos pedidos. Caso monitorize vários metacampos desse tipo, adicione metafieldKey é igual a custom.gift_message 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 relativa ao tipo de recurso ORDER 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

  • Assinalar o pedido: selecione a ação Adicionar tags ao pedido e insira {{resourceId}} no campo correspondente.
  • Adicione a condição «metafield.value não está vazio», para que uma mensagem eliminada não envie nada.
  • Utilize a atualização do metacampo Pedido quando o fluxo de trabalho tiver de ler os itens de linha ou a morada de entrega.

Com que rapidez reage

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

É bom saber

  • Por predefinição, a aplicação monitoriza os pedidos criados nos últimos 60 dias. Para os pedidos mais antigos, é necessário ter acesso completo ao histórico de pedidos na página «Permissões» e definir um intervalo mais alargado na configuração do histórico de pedidos da aplicação.

Mais