Gatilho de metacampo de pedido

Gatilho de metacampo de pedido

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de pedido for alterado e receba o valor antigo e o novo. Configure o gatilho no app.

Um cliente solicita ao suporte que adicione uma mensagem de presente após a realização do pedido. O suporte insere a mensagem no metacampo Mensagem de presente (custom.gift_message) do pedido, e a equipe de embalagem deve verificá-la antes que a encomenda seja despachada.

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

O que o senhor precisa

  • Uma definição de metacampo. Crie-a no painel de administração do Shopify, em Configurações > Metacampos e metaobjetos > Pedidos. Um metacampo sem definição não pode ser rastreado.
  • A permissão Acesso aos dados do pedido. Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.

1. Acompanhar o metacampo

  1. Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Pedido.
  3. Marque o metacampo Mensagem de presente. É possível marcar vários de uma só vez ou usar a opção Selecionar tudo.
  4. Clique em Adicionar gatilho.

Para acompanhar todos os metacampos desse tipo de recurso, incluindo aqueles que você criar posteriormente, selecione Todos os metacampos em vez de marcar 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 “Pedido” e o metacampo “Mensagem do presente”, custom.gift_message, marcado
Tipo de recurso: Pedido, com o metacampo marcado. A opção “Todos os metacampos” rastreia, em vez disso, todos os metacampos desse tipo.

O novo gatilho exibe Inicializando enquanto o aplicativo lê o valor atual do metacampo em seus pedidos existentes e, em seguida, Ativo. Essa primeira leitura é o motivo pelo qual a primeira alteração já chega com o valor anterior correto.

Caso o metacampo não conste na lista, clique em Atualizar metacampos na página “Gatilhos de metacampos”: o aplicativo mantém a lista de definições por uma hora.

2. O que o fluxo de trabalho recebe

Cada alteração aciona o gatilho Metacampo Update no Shopify Flow com estes 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

Atualização do Metacampo de Pedido é um segundo gatilho para a mesma alteração. Ela é acionada além da “Atualização do Metacampo” e transporta o pedido como uma referência nativa do Flow, de modo que as ações de pedido do próprio Shopify funcionam nela sem a necessidade de uma etapa de consulta. Ambas compartilham um único evento; portanto, o uso das duas não é contabilizado duas vezes. Ative-o na página Gatilhos do aplicativo 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 você rastreia; portanto, essa condição restringe este fluxo de trabalho aos pedidos. Caso você rastreie vários metacampos desse tipo, adicione metafieldKey é igual a custom.gift_message como um segundo critério.
  3. Adicione a ação necessária. No exemplo, é enviado 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 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. Faça o download do arquivo .flow, anexado na parte inferior desta página.
  2. No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
  3. Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
  4. Ative o fluxo de trabalho.

Faça disso algo seu

  • Marque o pedido: selecione a ação Adicionar tags ao pedido e insira {{resourceId}} no campo “pedido”.
  • Adicione a condição “metafield.value não está vazio” para que uma mensagem removida não envie nada.
  • Utilize a atualização do metacampo Ordem quando o fluxo de trabalho precisar ler os itens de linha do pedido ou o endereço de entrega.

Com que rapidez ele reage

O Shopify notifica o aplicativo quando um pedido é salvo; portanto, o fluxo de trabalho geralmente é iniciado em poucos segundos.

É bom saber

  • Por padrão, o aplicativo monitora os pedidos criados nos últimos 60 dias. Para pedidos mais antigos, é necessário ter acesso completo ao histórico de pedidos na página “Permissões” e definir um intervalo mais longo na configuração de histórico de pedidos do aplicativo.

Mais