Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida

Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida

Copiar página

Execute um fluxo de trabalho do Shopify Flow uma vez quando uma tag é adicionada ou removida de um pedido, cliente ou produto, com addedTags e removedTags.

Iniciar um processo com uma tag é a tarefa mais comum desta aplicação. Os colaboradores atribuem a tag hold a um pedido, uma aplicação de deteção de fraudes atribui-lhe a tag review e uma aplicação de subscrições atribui a um cliente a tag vip. O fluxo de trabalho deve ser executado uma vez, quando essa tag aparece, e, frequentemente, um segundo fluxo de trabalho deve ser executado quando a tag for removida.

Esta página explica como configurar ambas as opções e de que forma os gatilhos de etiqueta desta aplicação diferem dos gatilhos Pedido atualizado, Cliente atualizado e Produto atualizado do próprio Shopify Flow, que utilizam o campo tags.

O que cada gatilho sabe sobre uma alteração de tag

O gatilho atualizado do Shopify Flow que monitoriza tags Tags adicionadas e tags removidas nesta aplicação
Inicia um fluxo de trabalho sempre que houver uma alteração na lista de tags, independentemente da tag que tenha sido adicionada ou removida «Tags adicionadas» quando for adicionada pelo menos uma tag; «Tags removidas» quando for removida pelo menos uma
O que o fluxo de trabalho obtém a lista de tags após a alteração addedTags, removedTags, previousTags, currentTags
«A minha tag acabou de ser adicionada?» não é possível responder: a tag consta da lista, desde agora ou desde o mês passado O addedTags inclui-o
«A minha tag acabou de ser removida?» não é possível responder: a tag não consta da lista, tal como acontece em todos os registos que nunca a tiveram removedTags inclui-o
Várias tags escritas de uma só vez uma execução por gravação um evento que os inclua a todos

O que aconteceu no nosso teste

Um pedido numa loja de desenvolvimento, a 20 de novembro de 2026. Um fluxo de trabalho na funcionalidade «Pedido» do Shopify Flow foi atualizado e os gatilhos de etiquetas desta aplicação foram executados em paralelo, registando o que observaram. Para cada execução, verificámos então a condição que um fluxo de trabalho de etiquetas utilizaria: no gatilho Flow, a única condição possível, «as etiquetas do pedido incluem exp-vip», e no gatilho «Etiquetas adicionadas ao pedido», «addedTags inclui exp-vip».

Passo Pedido da Shopify Flow atualizado Foram adicionadas etiquetas de pedido
Foi adicionada a etiqueta exp-vip é executado, as tags incluem-no: condição verdadeira aciona com addedTags = exp-vip: condição verdadeira
The exp-other tag was added later quando é executado novamente, as etiquetas continuam a incluir exp-vip: true novamente é disparado com addedTags = exp-other: false
The exp-other tag was removed é executado novamente: verdadeiro novamente não é executado (ao contrário de «Order Tags Removed»)
Foram adicionadas mais três tags num segundo 3 execuções: true mais três vezes 1 evento com as três tags: false
The exp-vip tag was removed quando o código é executado, a tag já não existe: false, e nada indica que tenha sido removida O evento «Order Tags Removed» é disparado quando removedTags = exp-vip

Uma etiqueta, adicionada uma vez: o fluxo de trabalho associado ao gatilho do Flow teria sido executado seis vezes, enquanto o associado ao gatilho «Etiquetas de Pedido Adicionadas» teria sido executado apenas uma vez. Se a ação consistir num e-mail para o cliente, numa suspensão do processamento da encomenda ou numa chamada para outro sistema, essa diferença é precisamente o que importa.

Implementar: executar uma vez quando for adicionada uma tag

  1. No Shopify Flow, selecione Selecionar um gatilho, abra Workflow Trigger Extensions e escolha Order Tags Added.
  2. Adicionar uma condição: addedTags inclui hold.
  3. Adicione a sua ação, por exemplo, Suspender o pedido de processamento dentro de um Para cada relativo aos pedidos de processamento da encomenda.
  4. Ative o fluxo de trabalho. Ao ativá-lo, o gatilho na aplicação também é ativado.

O fluxo de trabalho é executado quando é adicionada a etiqueta hold. Não é executado quando é adicionada outra etiqueta a um pedido que já tenha a etiqueta hold, quando uma etiqueta é removida ou quando se verifica qualquer outra alteração no pedido.

Os gatilhos Flow numa página de cliente: foi adicionada uma nota e foi adicionada a etiqueta «VIP»
O bloco de eventos na página de um cliente no painel de administração do Shopify indica o nome da tag que foi adicionada.

Implementação: executar quando uma tag for removida

  1. Como as etiquetas de pedido foram removidas como gatilho.
  2. Adicionar uma condição: removedTags inclui hold.
  3. Adicione a ação que anula o primeiro fluxo de trabalho, por exemplo, Liberar a retenção do pedido de processamento, no interior de um Para cada relativo aos pedidos de processamento da encomenda.
  4. Ative o fluxo de trabalho.

Este é o caso que um gatilho atualizado não consegue abranger por si só. Depois de uma tag ter sido removida, o registo parece-se exatamente com um registo que nunca teve essa tag. Um fluxo de trabalho que apenas tem acesso à lista atual de tags não tem como distinguir os dois.

O mesmo se aplica aos produtos, aos clientes e aos pedidos provisórios

Registo Adicionado Removido
Pedido Foram adicionadas etiquetas de pedido Tags de pedido removidas
Produto Tags de produto adicionadas Tags do produto removidas
Pedido provisório Foram adicionadas etiquetas de pedidos provisórios Tags de pedidos provisórios removidas
Cliente Foram adicionadas tags de cliente Tags do cliente removidas

Todos os oito enviam os mesmos quatro valores: addedTags, removedTags, previousTags e currentTags. Gatilhos de pedidos, passo a passo, Gatilhos de produto, passo a passo, Condições de ativação de pedidos provisórios, passo a passo e Gatilhos de clientes, passo a passo apresentam, cada um, um exemplo prático.

No que diz respeito aos clientes, o Flow dispõe também dos seus próprios gatilhos Etiquetas de cliente adicionadas e Etiquetas de cliente removidas, que apresentam a lista das etiquetas que foram adicionadas ou removidas. No que diz respeito a pedidos, produtos e pedidos provisórios, o Flow não dispõe desses gatilhos: nesses casos, os gatilhos de etiquetas desta aplicação são a forma de reagir a uma etiqueta.

Se utilizar o gatilho atualizado do Flow para tags

As ações «Pedido atualizado», «Cliente atualizado» e «Produto atualizado» também podem monitorizar tags, e para um alerta simples («avise-me quando as tags de um pedido forem alteradas») é tudo o que precisa. Para evitar que esse fluxo de trabalho seja executado repetidamente para uma mesma tag, o padrão habitual é utilizar um marcador:

  1. Condição: as etiquetas incluem hold e não incluem hold-done.
  2. Faça o trabalho.
  3. Último passo: adicione o tag hold-done.

Funciona, mas há três aspetos a ter em conta. Cada fluxo de trabalho necessita da sua própria etiqueta marcadora, e as tags dos seus registos ficam repletas delas. O fluxo de trabalho reinicia-se para a sua própria etiqueta marcadora e pára na condição. E quando a etiqueta hold é removida e adicionada novamente, nada acontece até que alguém remova também a etiqueta marcadora. Não é possível agir sobre uma etiqueta removida desta forma.

Por que razão o meu fluxo de trabalho é executado várias vezes para uma única tag?

Um fluxo de trabalho num gatilho «Atualizado no Flow» com o campo «Etiquetas» é executado sempre que se verifica uma alteração na lista de etiquetas. Desde que a sua etiqueta conste do registo, qualquer outra etiqueta que seja adicionada ou removida faz com que a condição volte a ser verdadeira. Utilize o gatilho «Etiquetas Adicionadas» desta aplicação com uma condição baseada em addedTags ou o padrão de marcador descrito acima.

Posso iniciar um fluxo de trabalho apenas para uma etiqueta específica?

Sim. Utilize o gatilho «Tags Adicionadas» para o tipo de registo e adicione a condição addedTags inclui a sua tag. Para a remoção, utilize o gatilho «Tags Removidas» com removedTags.

O que acontece quando uma aplicação adiciona várias tags de uma só vez?

O gatilho é acionado uma vez e addedTags lista todas elas. No nosso teste, três tags introduzidas no espaço de um segundo foram registadas como um único evento com as três tags.

O Shopify Flow dispõe de um gatilho para um tag que tenha sido adicionado ou removido?

No que diz respeito aos clientes, sim: «Etiquetas de cliente adicionadas» e «Etiquetas de cliente removidas». No que diz respeito a encomendas, produtos e pedidos provisórios, uma etiqueta só pode ser monitorizada através do campo «etiquetas» de um gatilho de atualização, que apresenta a lista após a alteração e não o que foi adicionado ou removido. «Etiquetas de pedido adicionadas», «Etiquetas de pedido removidas», «Etiquetas de produto adicionadas», «Etiquetas de produto removidas» e os dois gatilhos de pedidos provisórios desta aplicação indicam as etiquetas.

Posso ver quais eram as tags que constavam no registo anteriormente?

Sim. previousTags contém a lista anterior à alteração e currentTags a lista posterior à mesma, em todos os oito gatilhos de tags.

Próximos passos