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

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

  1. No Shopify Flow, selecione Selecionar um gatilho, abra Workflow Trigger Extensions e escolha Tags de pedido adicionadas.
  2. Adicionar uma condição: addedTags inclui hold.
  3. Adicione sua ação, por exemplo, Suspender o pedido de processamento dentro de um ciclo Para cada sobre os pedidos de processamento do pedido.
  4. 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.

Os gatilhos Flow em uma página de cliente: uma nota adicionada e a tag “VIP” adicionada
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.

Crie: execute quando uma tag for removida

  1. As etiquetas de ordem de separação foram removidas como gatilho.
  2. Adicionar uma condição: removedTags inclui hold.
  3. 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.
  4. 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:

  1. Condição: as tags incluem hold e não incluem hold-done.
  2. Faça o trabalho.
  3. Ú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 que ocorre quando um aplicativo adiciona várias tags de uma só vez?

O gatilho é acionado uma vez e addedTags lista todas elas. Em nosso teste, três tags inseridas em um segundo foram recebidas como um único evento contendo as três tags.

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.

Posso verificar quais tags estavam associadas ao registro anteriormente?

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

Próximos passos