Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida
Acione um fluxo do Shopify Flow uma vez quando uma tag é adicionada a pedido, cliente ou produto, e outro quando é removida, com addedTags e removedTags.
Iniciar um processo com uma tag é a função mais comum deste aplicativo. A equipe marca um pedido com a tag hold, um aplicativo de combate à fraude marca-o com a tag review, um aplicativo de assinaturas marca um cliente com a tag vip. O fluxo de trabalho deve ser acionado uma vez, quando essa tag aparecer, e, frequentemente, um segundo fluxo de trabalho deve ser acionado quando a tag for removida novamente.
Esta página mostra como configurar ambos e como os gatilhos de tag deste aplicativo 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
Os gatilhos atualizados do Shopify Flow que monitam tags |
Tags adicionadas e tags removidas neste aplicativo | |
|---|---|---|
| Inicia um fluxo de trabalho | a cada alteração na lista de tags, independentemente de qual tag tenha sido adicionada ou removida | “Tags adicionadas” quando pelo menos uma tag é adicionada; “Tags removidas” quando pelo menos uma é removida |
| O que o fluxo de trabalho obtém | a lista de tags após a alteração | addedTags, removedTags, previousTags, currentTags |
| "Minha tag acabou de ser adicionada?" | não é possível responder: a tag está na lista, desde agora ou desde o mês passado | O addedTags inclui isso |
| "A minha tag acabou de ser removida?" | não pode ser respondida: a tag não consta da lista, assim como em todos os registros que nunca a tiveram | removedTags inclui isso |
| Várias tags escritas de uma só vez | uma execução por gravação | um evento que os liste todos |
O que ocorreu em nosso teste
Um pedido em uma loja de desenvolvimento, em 20 de novembro de 2026. Um fluxo de trabalho na ação “Pedido” do Shopify Flow foi atualizado, e os gatilhos de tag desse aplicativo foram executados simultaneamente e registraram o que observaram. Para cada execução, verificamos então a condição que um fluxo de trabalho de tag utilizaria: no gatilho do Shopify Flow, a única condição possível, “as tags do pedido incluem exp-vip”, e na ação “Tags do pedido adicionadas”, “addedTags inclui exp-vip”.
| Etapa | Atualização do pedido da Shopify Flow | Etiquetas de pedido adicionadas |
|---|---|---|
Adicionada a tag exp-vip |
é executado, as tags o incluem: condição verdadeira | disparos com addedTags = exp-vip: condição verdadeira |
A tag exp-other foi adicionada posteriormente |
ao ser executado novamente, as tags ainda incluem exp-vip: true novamente |
é acionado com addedTags = exp-other: false |
A tag exp-other foi removida |
é executado novamente: verdadeiro novamente | não é acionado (já que “Tags de pedido removidas” é acionado) |
| Mais três tags foram adicionadas em um segundo | 3 execuções: verdadeiro mais três vezes | 1 evento com as três tags: false |
A tag exp-vip foi removida |
quando o código é executado, a tag não está mais presente: false, e nada indica que ela acabou de ser removida | A ação “Order Tags Removed” é acionada quando removedTags = exp-vip |
Uma tag, adicionada uma vez: o fluxo de trabalho no gatilho do Flow teria sido acionado seis vezes, enquanto o do gatilho “Tags de Pedido Adicionadas” teria sido acionado apenas uma vez. Se a ação for o envio de um e-mail ao cliente, a suspensão do Processamento ou uma chamada para outro sistema, essa diferença é o que realmente importa.
Criar: executar uma vez quando uma tag for adicionada
- No Shopify Flow, selecione Selecionar um gatilho, abra Workflow Trigger Extensions e escolha Tags de pedido adicionadas.
- Adicionar uma condição:
addedTagsincluihold. - Adicione sua ação, por exemplo, Suspender o pedido de processamento dentro de um ciclo Para cada sobre os pedidos de processamento do pedido.
- Ative o fluxo de trabalho. Ao ativá-lo, o gatilho também é ativado no aplicativo.
O fluxo de trabalho é executado quando a tag hold é adicionada. Ele não é executado quando outra tag é adicionada a um pedido que já possua a tag hold, quando uma tag é removida ou quando qualquer outra alteração é feita no pedido.

Crie: execute quando uma tag for removida
- As etiquetas de ordem de separação foram removidas como gatilho.
- Adicionar uma condição:
removedTagsincluihold. - Adicione a ação que desfaz o primeiro fluxo de trabalho, por exemplo, Liberar a retenção do pedido de atendimento, dentro de um ciclo Para cada sobre os pedidos de processamento da ordem.
- Ative o fluxo de trabalho.
Esse é um caso que um gatilho atualizado não consegue resolver por si só. Após a remoção de uma tag, o registro fica exatamente igual a um registro que nunca teve essa tag. Um fluxo de trabalho que analisa apenas a lista atual de tags não tem como distinguir os dois.
O mesmo se aplica a produtos, clientes e pedidos provisórios
| Registro | Adicionado | Removido |
|---|---|---|
| Pedido | Tags de pedido adicionadas | Etiquetas de pedidos removidas |
| Produto | Tags de produto adicionadas | Tags do produto removidas |
| Pedido provisório | Adicionadas tags de pedidos provisórios | Tags de pedidos provisórios removidas |
| Cliente | Tags de clientes adicionadas | Tags de 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, Como acionar os gatilhos de pedido provisório, passo a passo e Gatilhos de clientes, passo a passo apresentam um exemplo prático para cada um.
Para os clientes, o Flow também possui seus próprios gatilhos Tags do cliente adicionadas e Tags do cliente removidas, que listam as tags que foram adicionadas ou removidas. Para pedidos, produtos e pedidos provisórios, o Flow não possui tais gatilhos: nesses casos, os gatilhos de tag deste aplicativo são a forma de reagir a uma tag específica.
Caso utilize o gatilho atualizado do Shopify Flow para tags
As ações “Pedido atualizado”, “Cliente atualizado” e “Produto atualizado” do Shopify Flow também podem monitorar tags, e para um alerta simples (“avise-me quando as tags de um pedido forem alteradas”), isso é tudo o que você precisa. Para evitar que esse fluxo de trabalho seja executado repetidamente para uma mesma tag, o padrão usual é utilizar um marcador:
- Condição: as tags incluem
holde não incluemhold-done. - Faça o trabalho.
- Última etapa: adicione el tag
hold-done.
Isso funciona, mas há três pontos a serem considerados. Cada fluxo de trabalho precisa de sua própria tag marcadora, e as tags de seus registros ficam repletas delas. O fluxo de trabalho é reiniciado para sua própria tag marcadora e é interrompido na condição. E quando a tag hold é removida e adicionada novamente, nada acontece até que alguém remova a tag marcadora também. Não é possível agir com base em uma tag removida dessa forma.
Por que meu fluxo de trabalho é executado várias vezes para uma única tag?
Um fluxo de trabalho em um gatilho “Atualizado no Flow” com o campo “tags” é executado a cada alteração na lista de tags. Desde que sua tag esteja no registro, qualquer outra tag que seja adicionada ou removida fará com que a condição volte a ser verdadeira. Utilize o gatilho “Tags Adicionadas” deste aplicativo com uma condição baseada em addedTags ou o padrão de marcador descrito acima.
Posso iniciar um fluxo de trabalho apenas para uma tag específica?
Sim. Utilize o gatilho “Tags Adicionadas” para o tipo de registro e adicione a condição addedTags inclui sua tag. Para remoção, utilize o gatilho “Tags Removidas” com removedTags.
O Shopify Flow possui um gatilho para uma tag que foi adicionada ou removida?
Para clientes, sim: “Tags de cliente adicionadas” e “Tags de cliente removidas”. Para pedidos, produtos e pedidos provisórios, uma tag só pode ser monitorada por meio do campo “tags” de um gatilho de atualização, que exibe a lista após a alteração e não o que foi adicionado ou removido. “Tags de pedidos adicionadas”, “Tags de pedidos removidas”, “Tags de produtos adicionadas”, “Tags de produtos removidas” e os dois gatilhos de pedidos provisórios deste aplicativo nomeiam as tags.
Próximos passos
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - uma visão geral dos gatilhos atualizados do Shopify Flow e deste aplicativo.
- Valores antigos e novos: como um fluxo de trabalho pode aproveitá-los - o que mais um fluxo de trabalho pode fazer com o valor antes de uma alteração.
- Histórico de eventos e solução de problemas - visualize todos os eventos de tag e os dados que eles contêm.
