Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida
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
- No Shopify Flow, selecione Selecionar um gatilho, abra Workflow Trigger Extensions e escolha Order Tags Added.
- Adicionar uma condição:
addedTagsincluihold. - Adicione a sua ação, por exemplo, Suspender o pedido de processamento dentro de um Para cada relativo aos pedidos de processamento da encomenda.
- 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.

Implementação: executar quando uma tag for removida
- Como as etiquetas de pedido foram removidas como gatilho.
- Adicionar uma condição:
removedTagsincluihold. - 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.
- 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:
- Condição: as etiquetas incluem
holde não incluemhold-done. - Faça o trabalho.
- Ú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 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.
Próximos passos
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - uma visão geral dos gatilhos atualizados do Shopify Flow e desta aplicação.
- Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles - o que mais um fluxo de trabalho pode fazer com o valor antes de uma alteração.
- Histórico de eventos e resolução de problemas - veja todos os eventos de tags e o que cada um deles continha.
