Gatilhos de metacampo, passo a passo

Os metacampos são onde uma loja armazena os dados para os quais o Shopify não possui um campo específico, e o Shopify Flow não consegue reagir às alterações neles. Esses cinco gatilhos são capazes de fazê-lo - e eles carregam o previousValue, de modo que um fluxo de trabalho pode distinguir um aumento de uma queda.

Todos eles funcionam por definição: o senhor escolhe quais metacampos deseja monitorar na página “Metacampos Gatilhos” do aplicativo. Nenhum gatilho ocorre para um metacampo que o senhor não tenha adicionado nessa página. Consulte Gatilhos de metacampo para obter instruções sobre a configuração.

Nesta página: Atualização de metacampos, Atualização de metacampos de produtos, Atualização de metacampos de variantes do produto, Atualização de metacampos de pedidos, Atualização de metacampos de clientes

Atualização do Metacampo

É acionado quando um metacampo monitorado sofre alteração, independentemente do tipo de proprietário: produto, variante, coleção, cliente, pedido, pedido provisório, empresa, localização da empresa, blog, postagem de blog ou página.

Incêndios causados por	Shopify Webhook e detecção de alterações. Os metacampos de variantes, blogs, postagens de blog e páginas são verificados periodicamente
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Conforme a definição do metacampo, na página “Gatilhos de metacampo” do aplicativo

Utilize-o para

• Tipos de proprietário que não possuem um gatilho tipado: coleções, empresas, páginas, postagens de blog.
• Um fluxo de trabalho que monitora vários metacampos e se ramifica em metafieldKey.

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

Variável em Shopify Flow	Tipo	O que contém
metafieldKey	Texto	O namespace.key do metacampo que foi atualizado (para fins de filtragem no Shopify Flow)
resourceType	Texto	O tipo de recurso (PRODUTO, VARIANTE DE PRODUTO, COLEÇÃO, CLIENTE, PEDIDO, EMPRESA, UNIDADE 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 namespace do metacampo
metafield.key	Texto	A chave do metacampo
metafield.value	Texto	O valor do metacampo
metafield.previousValue	Texto	O valor anterior a essa alteração. Nulo quando o metacampo acabou de ser criado
metafield.type	Texto	O tipo do metacampo
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

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

1. Na aplicação, abra “Metacampos de gatilhos”, clique em “Adicionar gatilho”, selecione o tipo de proprietário “Coleção” e a definição, e salve.
2. No Shopify Flow, selecione “Atualização de metacampo” como gatilho.
3. Adicione uma condição: metafieldKey seja igual a custom.banner_text e resourceType seja igual a COLLECTION.
4. Adicione a opção “Enviar e-mail interno” com {{metafield.previousValue}} -> {{metafield.value}} e {{resourceId}}.
5. Ative o fluxo de trabalho.

Atualização do metacampo do produto

É acionado quando um metacampo de um produto monitorado é alterado, tendo o produto como referência nativa do Shopify Flow.

Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

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

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

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

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

1. Adicione o metacampo do produto na página “Gatilhos de metacampo” do aplicativo.
2. Selecione “Atualização do metacampo do produto” no Shopify Flow.
3. Adicione uma condição: metafieldKey seja igual a reviews.rating.
4. Adicione o código de execução para comparar números, pois os valores dos metacampos são fornecidos como texto: return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
5. Adicione uma condição na saída dropped do código e, em seguida, adicione tags de produto low-rating.
6. Ative o fluxo de trabalho.

Atualização do metacampo de variantes do produto

É acionado quando um metacampo de variante monitorado é alterado. O produto pai é fornecido como referência, e a variante como resourceId.

Incêndios causados por	Verificado periodicamente, pois o Shopify não envia nenhum webhook para isso
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que a atualização do metacampo “Variante do produto” envia ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O produto pai da variante cujo metacampo foi alterado (utilize isso para criar metacampos de produto). Trata-se de um produto Shopify completo, de modo que todos os seus campos e as ações de produto próprias do Shopify 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ção (para fins de filtragem no Shopify Flow)
metafield	Objeto	O metacampo que foi atualizado
metafield.id	ID	ID global do metacampo
metafield.namespace	Texto	O namespace do metacampo
metafield.key	Texto	A chave do metacampo
metafield.value	Texto	O valor do metacampo
metafield.previousValue	Texto	O valor antes dessa alteração. Nulo quando o metacampo acabou de ser criado
metafield.type	Texto	O tipo do metacampo
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Copiar um metacampo de variante para o produto correspondente

1. Adicione o metacampo “variante” na página “Gatilhos de metacampos”.
2. Selecione a atualização do metacampo “Variante do produto” no Shopify Flow.
3. Adicione o metacampo “Update product” em product com o valor {{metafield.value}}.
4. Ative o fluxo de trabalho.

Atualização de metacampo de pedido

É acionado quando um metacampo de um pedido monitorado é alterado, tendo o pedido como referência nativa.

Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Reaja aos dados que os aplicativos inserem nos pedidos: uma data de entrega, uma pontuação de risco, um número do ERP.
• Inicie as etapas de processamento quando um metacampo de aprovação for alterado.

O que a atualização do metacampo “Pedido” envia ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
order	Pedido (Shopify)	O pedido cujo metacampo foi alterado. Trata-se de um pedido completo do Shopify, pelo que todos os seus campos e as ações de pedido próprias do Shopify Flow estão disponíveis.
metafieldKey	Texto	O namespace.key do metacampo que sofreu alteração (para fins de filtragem no Shopify Flow)
metafield	Objeto	O metacampo que foi atualizado
metafield.id	ID	ID global do metacampo
metafield.namespace	Texto	O namespace do metacampo
metafield.key	Texto	A chave do metacampo
metafield.value	Texto	O valor do metacampo
metafield.previousValue	Texto	O valor antes dessa alteração. Nulo quando o metacampo acabou de ser criado
metafield.type	Texto	O tipo do metacampo
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Liberar um pedido quando o metacampo de aprovação passar a ser verdadeiro

1. Adicione o metacampo “order” na página “Metacampos de Gatilhos”.
2. Atualização do metacampo “Ordem de Seleção” no Shopify Flow.
3. Adicione uma condição: metafieldKey seja igual a custom.approved e metafield.value seja igual a true.
4. Adicione um ciclo “Para cada” sobre order.fulfillmentOrders com a opção “Liberar retenção do pedido de processamento”.
5. Ative o fluxo de trabalho.

Atualização do metacampo do cliente

É acionado quando um metacampo do cliente monitorado sofre alteração, tendo o cliente como referência nativa.

Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados do cliente
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação encontra-se na página “Gatilhos” do aplicativo

Utilize-o para

• Níveis de fidelidade, limites de crédito ou datas de aniversário armazenados em metacampos.
• Sincronize os atributos dos clientes inseridos por meio de formulários ou aplicativos com um CRM.

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

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

Exemplo: Marque os clientes que atingirem o nível ouro

1. Adicione o metacampo “Cliente” na página “Gatilhos de metacampo”.
2. Selecione “Atualização do metacampo do cliente” no Shopify Flow.
3. Adicione uma condição: metafieldKey seja igual a loyalty.tier e metafield.value seja igual a gold.
4. Adicione as tags de cliente gold e envie um e-mail interno para a equipe VIP.
5. Ative o fluxo de trabalho.

Próximos passos

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

• Referência completa sobre gatilhos - todos os gatilhos em uma única página.
• Escolhendo o gatilho certo - qual delas se aplica ao seu caso.
• Gatilhos personalizados - quando nenhum gatilho embutido for adequado, crie o seu próprio.
• Histórico de eventos e solução de problemas - verificar o que foi disparado e o que estava carregado.