Disparadores de metacampo, passo a passo

Os metacampos são onde uma loja armazena o que o Shopify não tem um campo específico para guardar, e o Shopify Flow não consegue reagir às suas alterações. Estes cinco gatilhos conseguem fazê-lo - e transportam o previousValue, pelo que um fluxo de trabalho consegue distinguir um aumento de uma diminuição.

Todos funcionam por definição: basta escolher quais os metacampos que pretende monitorizar na página «Metafield Triggers» da aplicação. Não é acionado nada para um metacampo que não tenha adicionado nessa página. Consulte Disparadores de metacampo para saber como configurar.

Nesta página: Atualização de metacampos, Atualização de metacampos de produto, Atualização de metacampos de variantes de produto, Atualização de metacampos de encomendas, Atualização de metacampos de clientes

Onde os encontrar: em Shopify Flow, selecione «Select a trigger», abra Workflow Trigger Extensions e procure por «Metafield».

Atualização do Metafield

É disparado quando um metafield monitorizado sofre uma alteração, independentemente do tipo de proprietário: produto, variante, coleção, cliente, encomenda, rascunho de encomenda, empresa, localização da empresa, blogue, publicação no blogue ou página.


Incêndios provocados por	Shopify Webhook e deteção de alterações. Os metacampos de variantes, blogues, publicações de blogue e páginas são verificados periodicamente
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	De acordo com a definição do metacampo, na página «Gatilhos de metacampo» da aplicação

Utilize-o para

Tipos de proprietário que não têm um disparador definido: coleções, empresas, páginas, publicações de blogue.
Um fluxo de trabalho que monitoriza vários metacampos e se ramifica com base no parâmetro metafieldKey.

O que o Metafield Update envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`metafieldKey`	Texto	O namespace.key do metacampo que foi atualizado (para filtragem no Flow)
`resourceType`	Texto	O tipo de recurso (PRODUTO, VARIANTE DE PRODUTO, COLEÇÃO, CLIENTE, ENCOMENDA, EMPRESA, LOCALIZAÇÃO DA EMPRESA, ARTIGO, BLOG, PÁGINA)
`resourceId`	Texto	O GID do recurso que foi atualizado
`metafield`	Objeto	O metacampo que foi atualizado
`metafield.id`	ID	ID global do metacampo
`metafield.namespace`	Texto	O espaço de nomes do metacampo
`metafield.key`	Texto	A chave do metacampo
`metafield.value`	Texto	O valor do metacampo
`metafield.previousValue`	Texto	O valor antes desta alteração. Nulo quando o metacampo acabou de ser criado
`metafield.type`	Texto	O tipo do metacampo
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Reagir a uma alteração num metacampo de uma coleção

Na aplicação, abra «Metafield Triggers», clique em «Adicionar gatilho», selecione o tipo de proprietário «Coleção» e a definição, e guarde.
No Flow, selecione «Atualização do metafield» como gatilho.
Adicionar uma condição: metafieldKey é igual a custom.banner_text e resourceType é igual a COLLECTION.
Adicionar a opção «Enviar e-mail interno» com {{metafield.previousValue}} -> {{metafield.value}} e {{resourceId}}.
Ative o fluxo de trabalho.

Atualização do metacampo do produto

É acionado quando um metacampo de um produto monitorizado sofre uma alteração, tendo o produto como referência nativa do Flow.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Aja diretamente no produto: marque-o, publique-o, atualize outro metacampo.
Limites em metacampos numéricos: uma classificação, uma previsão de stock, um prazo de entrega de um fornecedor.

O que a atualização do metafield do produto envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`product`	Produto (Shopify)	O produto cujo metacampo foi alterado. Trata-se de um produto Shopify completo, pelo que todos os seus campos e as ações próprias do Flow relativas ao produto estão disponíveis.
`metafieldKey`	Texto	O namespace.key do metacampo que sofreu alterações (para filtragem no Flow)
`metafield`	Objeto	O metacampo que foi atualizado
`metafield.id`	ID	ID global do metacampo
`metafield.namespace`	Texto	O espaço de nomes do metacampo
`metafield.key`	Texto	A chave do metacampo
`metafield.value`	Texto	O valor do metacampo
`metafield.previousValue`	Texto	O valor antes desta alteração. Nulo quando o metacampo acabou de ser criado
`metafield.type`	Texto	O tipo do metacampo
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Marcar os produtos cuja classificação seja inferior a 3

Adicione o metacampo do produto na página «Metafield Triggers» da aplicação.
Selecionar «Atualização do metafield do produto» no fluxo.
Adicionar uma condição: metafieldKey é igual a reviews.rating.
Adicione o código «Run» para comparar números, uma vez que os valores dos metacampos são apresentados como texto: return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
Adicione uma condição à saída dropped do código e, em seguida, adicione as etiquetas do produto low-rating.
Ative o fluxo de trabalho.

A caixa de diálogo «Adicionar gatilho de metafield» com o tipo de recurso «Produto» e o metafield «Classificação», «custom.rating», selecionado — Primeiro, observe o metafield na aplicação: Gatilhos do Metafield, Adicionar Gatilho, Produto, Classificação.

Um evento no Histórico de Eventos: Atualização do metafield para um produto, valor 2,5 e valor anterior 4,5 — O evento ao qual este exemplo reage: a classificação passou de 4,5 para 2,5, pelo que ultrapassou o valor 3.

Atualização do metafield da variante do produto

É disparado quando um metafield de variante monitorizado sofre uma alteração. O produto principal é passado como referência e a variante como umresourceIde.


Incêndios provocados por	Verificado periodicamente, porque o Shopify não envia nenhum webhook para esse efeito
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Agrupe os dados das variantes ao nível do produto; por exemplo, o prazo de entrega mais curto de todas as variantes.
Sincronizar atributos ao nível da variante com um feed.

O que a atualização do metafield «Variante do produto» envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`product`	Produto (Shopify)	O produto pai da variante cujo metacampo foi alterado (utilize isto para escrever metacampos de produto). Trata-se de um produto Shopify completo, pelo que todos os seus campos e as ações de produto próprias do Flow estão disponíveis.
`resourceId`	Texto	O GID da variante do produto cujo metacampo foi alterado
`metafieldKey`	Texto	O namespace.key do metacampo que sofreu alterações (para filtragem no Flow)
`metafield`	Objeto	O metacampo que foi atualizado
`metafield.id`	ID	ID global do metacampo
`metafield.namespace`	Texto	O espaço de nomes do metacampo
`metafield.key`	Texto	A chave do metafield
`metafield.value`	Texto	O valor do metacampo
`metafield.previousValue`	Texto	O valor antes desta alteração. Nulo quando o metacampo acabou de ser criado
`metafield.type`	Texto	O tipo do metacampo
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Copiar um metacampo de variante para o respetivo produto

Adicione o metacampo «variant» na página «Metafield Triggers».
Selecionar a atualização do metafield da variante do produto no fluxo.
Adicione o metacampo «Update product» em product com o valor {{metafield.value}}.
Ative o fluxo de trabalho.

Atualização do metafield da encomenda

É disparada quando um metacampo de uma encomenda monitorizada sofre uma alteração, tendo a encomenda como referência nativa.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados da encomenda
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Reagir aos dados que as aplicações introduzem nos pedidos: uma data de entrega, uma pontuação de risco, um número de ERP.
Iniciar as etapas de processamento quando um metafield de aprovação mudar de estado.

Que ordem a atualização do metafield envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`order`	Encomenda (Shopify)	A encomenda cujo metafield foi alterado. Trata-se de uma encomenda Shopify completa, pelo que todos os seus campos e as ações de encomenda próprias do Flow estão disponíveis.
`metafieldKey`	Texto	O namespace.key do metacampo que sofreu alterações (para filtragem no Flow)
`metafield`	Objeto	O metacampo que foi atualizado
`metafield.id`	ID	ID global do metacampo
`metafield.namespace`	Texto	O espaço de nomes do metacampo
`metafield.key`	Texto	A chave do metacampo
`metafield.value`	Texto	O valor do metacampo
`metafield.previousValue`	Texto	O valor antes desta alteração. Nulo quando o metacampo acabou de ser criado
`metafield.type`	Texto	O tipo do metacampo
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Liberar uma encomenda quando o seu metacampo de aprovação assumir o valor «true»

Adicione o metacampo «order» na página «Metafield Triggers».
Atualização do metafield «Ordem de recolha» no fluxo.
Adicionar uma condição: metafieldKey é igual a custom.approved e metafield.value é igual a true.
Adicione um «Para cada» sobre order.fulfillmentOrders com «Liberar a retenção da ordem de cumprimento».
Ative o fluxo de trabalho.

Atualização do metacampo do cliente

É acionado quando um metafield do cliente monitorizado sofre uma alteração, tendo o cliente como referência nativa.


Incêndios causados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados dos clientes
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Níveis de fidelidade, limites de crédito ou datas de aniversário armazenados em metafields.
Sincronizar os atributos dos clientes introduzidos através de formulários ou aplicações com um CRM.

O que a atualização do metafield do cliente envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo metacampo foi alterado. Trata-se de um cliente do Shopify completo, pelo que todos os seus campos e as ações do cliente próprias do Flow estão disponíveis.
`metafieldKey`	Texto	O namespace.key do metacampo que sofreu alterações (para filtragem no Flow)
`metafield`	Objeto	O metacampo que foi atualizado
`metafield.id`	ID	ID global do metacampo
`metafield.namespace`	Texto	O espaço de nomes do metacampo
`metafield.key`	Texto	A chave do metacampo
`metafield.value`	Texto	O valor do metacampo
`metafield.previousValue`	Texto	O valor antes desta alteração. Nulo quando o metacampo acabou de ser criado
`metafield.type`	Texto	O tipo do metacampo
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Marcar os clientes que atingirem o nível «ouro»

Adicione o metafield «Cliente» na página «Gatilhos de metafields».
Selecione «Atualização do metafield do cliente» no fluxo.
Adicionar uma condição: metafieldKey é igual a loyalty.tier e metafield.value é igual a gold.
Adicionar as etiquetas de cliente gold e enviar um e-mail interno à equipa VIP.
Ative o fluxo de trabalho.

Próximos passos

Os gatilhos específicos são acionados para além do gatilho genérico e partilham o mesmo evento; por isso, ativar ambos não conta duas vezes no seu plano.

Referência completa sobre gatilhos - todos os gatilhos numa única página.
Escolher o gatilho certo - qual é a opção mais adequada ao seu caso.
Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
Histórico de eventos e resolução de problemas - ver o que disparou e o que transportava.