Os gatilhos atualizados do Flow e as Workflow Trigger Extensions

Os gatilhos atualizados do Flow e as Workflow Trigger Extensions

Copiar página

O que os gatilhos de atualização de pedidos, clientes e produtos do Shopify Flow enviam, o seu limite de cinco campos e como obter o valor antes e depois de

O Shopify Flow dispõe de nove gatilhos integrados que iniciam um fluxo de trabalho quando um registo é atualizado: Produto atualizado, Pedido atualizado, Cliente atualizado, Coleção atualizada, Local atualizado, Artigo do estoque atualizado, Pedido de processamento atualizado, Reembolso atualizado e Devolução atualizada. Pode selecionar até cinco campos, e o fluxo de trabalho é iniciado quando um deles sofre uma alteração.

Notificam um fluxo de trabalho de que um registo foi alterado. As Workflow Trigger Extensions indicam-lhe o que foi alterado: o valor anterior e o valor posterior, a etiqueta exata que foi adicionada ou removida, a diferença de preço e tantos campos quantos forem necessários.

Ambos os tipos de gatilho podem ser executados na mesma loja e funcionam bem em conjunto. Este guia compara-os lado a lado para que possa escolher o mais adequado para cada fluxo de trabalho. Tudo o que aqui se refere aos gatilhos Flow provém das próprias páginas de ajuda Shopify ou de testes realizados numa loja de desenvolvimento a 20 de novembro de 2026.

Em resumo

Os gatilhos atualizados do Shopify Flow Workflow Trigger Extensions
Inicia um fluxo de trabalho quando um dos 1 a 5 campos que selecionou é alterado sempre que ocorrer um tipo de alteração (é adicionada uma tag, a nota é alterada, o preço é alterado) ou sempre que houver uma atualização do registo
Valores no fluxo de trabalho o registo tal como se encontra no momento em que o fluxo de trabalho é executado o valor antes e depois, tal como se encontravam no momento da alteração
Qual foi o campo que sofreu alteração? não foi disponibilizada ao fluxo de trabalho como variável nos nossos testes um gatilho por tipo de alteração, ou um objeto changes que enumere os campos alterados com os seus valores antigos e novos
Tags a lista completa de tags após a alteração exatamente as tags que foram adicionadas ou removidas, além da lista antes e depois
Números (preço, custo, stock) o novo valor valor antigo, valor novo, diferença, percentagem e sentido
Campos que pode visualizar em um único fluxo de trabalho 5 sem limite
Registos produto, pedido, cliente, recolha, local, artigo em estoque, processamento de pedido, reembolso, devolução produto, variante, pedido, cliente, coleção e localização, bem como pedidos provisórios, descontos, empresas B2B, mercados, metaobjetos, blogs e páginas, stock por localização, canais de vendas, vitrine e comportamento no processo de Checkout
Sem edição não gatilhos baseados no tempo a partir de modelos: não faturado há N dias, não pago há N dias, uma data num metacampo e muito mais

As mesmas alterações em ambos: um teste

Criámos um pedido numa loja de desenvolvimento e alterámo-lo em momentos específicos. Um fluxo de trabalho no «Flow's Order» monitorizou as tags, a nota, o estado financeiro, o estado de processamento e os atributos personalizados, e registou as alterações detetadas. Paralelamente, foram executadas as tarefas Tags de pedido adicionadas, Tags de pedido removidas e Nota de pedido alterada a partir desta aplicação.

Alterar Pedido da Shopify Flow atualizado Esta aplicação
Foi adicionada a etiqueta exp-vip 1 execução. O fluxo de trabalho deteta as tags exp-vip Tags de pedido adicionadas: addedTags = exp-vip, previousTags vazio
Foi adicionada a etiqueta exp-other 1 execução. Deteta exp-other, exp-vip Tags de pedido adicionadas: addedTags = exp-other, previousTags = exp-vip
The exp-other tag was removed again. 1 execução. Deteta exp-vip Tags de pedido removidas: removedTags = exp-other
Nota alterada 1 execução. Visualiza a nova nota Nota do pedido alterada: oldNote = start, newNote = exp note 1
Foram adicionadas três tags no espaço de um segundo 3 execuções. Em duas delas aparecem as três novas tags, e numa delas aparecem duas 1 evento: addedTags = exp-a, exp-b, exp-c
A nota foi alterada duas vezes no espaço de um segundo 2 passagens. Ambas apresentam a nota final 1 evento: oldNote = exp note 1, newNote = exp note 3
The exp-vip tag was removed 1 execução. Identifica as tags que ainda restam Tags de pedido removidas: removedTags = exp-vip

Considere o fluxo de trabalho de etiquetas mais comum: «quando a etiqueta exp-vip for adicionada, execute uma ação». No gatilho do Shopify Flow, a condição só pode ser «as etiquetas incluem exp-vip». Ocorreram seis alterações na etiqueta enquanto esta se encontrava no pedido, e essa condição verificou-se nas seis execuções iniciadas, embora a etiqueta tenha sido adicionada apenas uma vez. Em «Etiquetas adicionadas aos pedidos», a condição é «addedTags inclui exp-vip», e esta condição verificou-se uma vez. Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida analisa este caso passo a passo.

Os gatilhos Flow numa página de pedidos: alteração do estado financeiro de «pendente» para «pago» e adição de uma nota
Eis como se apresenta uma alteração nesta aplicação, aqui na página de um pedido no painel de administração do Shopify: o estado financeiro antes e depois, e a nota que foi adicionada.

Os nove gatilhos atualizados do Flow e o guia para cada um deles

Gatilho Flow O que pode ver Os gatilhos mais próximos nesta aplicação Guia
Pedido atualizado tags, nota, e-mail, telefone, cancelamento, atributos personalizados, estado financeiro e de processamento da encomenda, totais, itens de linha, linhas de envio, metacampos Atualização do pedido, Adição de tags ao pedido, Remoção de tags do pedido, Alteração da nota do pedido, Alteração dos atributos do pedido, Alteração dos itens de linha do pedido, Alteração do estado financeiro do pedido, Alteração do processamento do pedido, Alteração do estado de visualização do pedido, Alteração da morada de envio do pedido, Atualização do metacampo do pedido O gatilho de atualização de pedidos do Shopify Flow e os gatilhos de pedidos desta aplicação
Cliente atualizado nome, nota, tags, estado, isenções fiscais, montante gasto, e-mail e marketing por e-mail, telefone e marketing por SMS, endereços, metacampos Atualização do cliente, Adição de tags ao cliente, Remoção de tags do cliente, Alteração da nota do cliente, Alteração do estado do cliente, Alteração do nome do cliente, Alteração do e-mail do cliente, Alteração do número de telefone do cliente, Alteração da morada do cliente, Alteração do consentimento do cliente para marketing por e-mail, Alteração do consentimento do cliente para marketing por SMS, Atualização do metacampo do cliente O gatilho «Atualização do cliente» do Flow e os gatilhos relacionados com o cliente desta aplicação
Produto atualizado título, nome de referência, descrição, estado, tags, fornecedor, tipo, categoria, multimédia, opções, preço da variante, preço de comparação e código de barras, pacotes, listagens combinadas, metacampos Atualização do produto, Adição de etiquetas ao produto, Remoção de etiquetas do produto, Alteração do estado do produto, Alteração do título do produto, Alteração do identificador do produto, Alteração da descrição do produto, Alteração do fornecedor do produto, Alteração do tipo de produto, Alteração do preço da variante do produto, Alteração do código de barras da variante do produto, Publicação do produto no canal, Retirada do produto do canal, Atualização do metacampo do produto, Atualização do metacampo da variante do produto O gatilho de atualização do produto do Shopify Flow e os gatilhos de produto desta aplicação
Artigo no estoque atualizado SKU, custo unitário, peso, com acompanhamento, requer envio, país de origem, código HS, ativo num local, variantes Alteração do SKU da variante do produto, alteração do custo da variante do produto, alteração do nível de estoque no local, esgotado no local, novamente disponível no local O gatilho de atualização do item de estoque do Flow e o SKU, o custo e o stock nesta aplicação
Coleção atualizada título, identificador, descrição, imagem, ordem de classificação, modelo, produtos, metacampos Atualização da coleção, Alteração do título da coleção, Alteração do identificador da coleção, Alteração da descrição da coleção, metacampos da coleção O gatilho atualizado da «Flow's Collection» e os gatilhos da coleção desta aplicação
Local atualizado ativo, desativado em, realiza o processamento de pedidos online, envia o estoque, morada, metacampos Local atualizado, Local ativado, Local desativado, Local criado, Local eliminado, metacampos de local O gatilho de atualização de localização do Flow e os gatilhos de localização desta aplicação
Pedido de processamento atualizado, Reembolso atualizado, Devolução atualizada estado, retenções, destino, método de entrega e acompanhamento; itens de linha e transações de reembolso; estado da devolução, artigos e taxas Alteração no processamento do pedido, alteração no estado de visualização do pedido, alteração no estado financeiro do pedido Atualização dos gatilhos relativos ao processamento de pedidos, reembolsos e devoluções, e o que esta aplicação acrescenta

Existem dois guias que abrangem todos eles: Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles e Acompanhe mais de cinco campos num único fluxo de trabalho. Os metacampos têm o seu próprio guia: Alterações nos metacampos no Shopify Flow: os gatilhos atualizados e os gatilhos dos metacampos.

Qual deve utilizar

Um gatilho «Flow updated» é adequado quando

  • O fluxo de trabalho apenas precisa de saber que um dos até cinco campos foi alterado, sendo que os valores atuais são suficientes;
  • se observar algo para o qual esta aplicação não dispõe de um gatilho: produtos adicionados ou removidos de uma coleção, um reembolso, uma devolução, a retenção de um pedido de processamento, o peso de um artigo do estoque ou dados aduaneiros;
  • O fluxo de trabalho tem de ser iniciado no prazo de um ou dois segundos após a alteração.

Um gatilho desta aplicação é acionado quando

  • O fluxo de trabalho compara o antes e o depois: um preço que baixou, um estado que passou de um valor para outro, um produto cujo nome foi alterado, uma morada que foi alterada;
  • reage à adição ou remoção de um tag específico;
  • deve ser executada uma vez por alteração e não novamente quando outro elemento do registo for alterado;
  • se monitorizar mais de cinco campos, ou cada atualização de um registo;
  • o registo é um pedido provisório, um desconto, uma empresa B2B, um mercado, um metaobjeto, uma publicação num blogue ou uma página;
  • O gatilho é o que os clientes fazem na loja virtual, ou um momento específico, em vez de uma alteração.

Três aspetos a ter em conta sobre o funcionamento dos gatilhos Flow

Estes resultados provêm dos nossos testes e explicam a maioria das surpresas que ocorrem quando um fluxo de trabalho passa de um tipo de gatilho para outro.

  1. O registo é lido quando o fluxo de trabalho é executado. Um fluxo de trabalho com um gatilho de atualização vê o registo tal como se encontra nesse momento. Quando várias alterações ocorrem em intervalos curtos, cada execução pode apresentar o mesmo estado final: três alterações numa coleção no espaço de dois segundos resultaram em três execuções que apresentaram todas o último título. Um evento desta aplicação mantém os valores da sua própria alteração.
  2. Um registo que já não existe não pode ser lido. Um cliente que foi alterado e, imediatamente a seguir, eliminado provocou uma execução cuja etapa de acionamento falhou, uma vez que o Shopify Flow já não conseguia carregar o cliente.
  3. Alguns campos são considerados alterados quando um registo é criado. Uma encomenda criada a partir de um pedido provisório foi atualizada duas vezes: uma vez relativamente ao estado financeiro e outra relativamente ao estado de processamento. A página de ajuda do Shopify relativa à atualização de produtos refere o mesmo sobre as variantes do produto: um fluxo de trabalho que monitoriza variants.price é executado quando um produto é adicionado. Os gatilhos de alteração desta aplicação registam um novo registo e são acionados a partir da sua primeira alteração efetiva.

Utilizar ambos numa única loja

Os dois tipos de gatilho não interferem um com o outro. Uma alteração que seja monitorizada tanto por um gatilho Flow como por um gatilho desta aplicação dá início a ambos os fluxos de trabalho; por isso, atribua cada tarefa a um deles. Uma divisão comum: os próprios gatilhos Flow para os alertas simples do tipo «algo mudou, verifique», e esta aplicação para tudo o que necessite do valor anterior, de uma tag específica, de um limiar ou de um registo para o qual o Flow não disponha de um gatilho de atualização.

Nada muda no que diz respeito aos fluxos de trabalho que já executa com base nos gatilhos desta aplicação. Estes continuam a funcionar como antes.

Shopify Flow
Os gatilhos de pedido desta aplicação no seletor de gatilhos do Shopify Flow. Estão localizados ao lado dos gatilhos próprios Shopify, e uma loja pode utilizar ambos.
O Shopify Flow dispõe de um gatilho de «Pedido atualizado»?

Sim. Desde novembro de 2026 que o Flow dispõe de gatilhos integrados e atualizados para pedidos, clientes, reembolsos, devoluções, pedidos de processamento, cobranças, locais e artigos do estoque, para além da atualização de produtos. Cada um deles monitoriza entre 1 a 5 campos que o utilizador seleciona e transmite ao fluxo de trabalho o registo tal como se encontra no momento em que o fluxo de trabalho é executado.

Um gatilho de atualização do Shopify Flow pode fornecer-me o valor anterior à alteração?

Não. As páginas de ajuda da Shopify indicam, relativamente a cada um destes gatilhos, que apenas fornecem os valores atuais e que os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho. Os gatilhos desta aplicação incluem ambos os valores. Consulte Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles.

Um fluxo de trabalho no Flow, ao ser acionado, consegue identificar qual o campo que sofreu alteração?

Não como variável, tanto quanto pudemos verificar. Sabe que foi um dos campos que selecionou. Se precisar de agir de forma diferente consoante o campo, crie um fluxo de trabalho por campo ou utilize os gatilhos desta aplicação: existe um para cada tipo de alteração, e os gatilhos genéricos de atualização de Produto, Pedido e Cliente podem listar os campos alterados com os seus valores antigos e novos.

Posso visualizar mais de cinco campos?

Não num único fluxo de trabalho com um gatilho de atualização do Flow. Nesta aplicação, os gatilhos de atualização genéricos são acionados em cada atualização, ou em qualquer número de campos que selecionar a partir de um registo real da sua loja. Consulte Acompanhe mais de cinco campos num único fluxo de trabalho.

Utilizo a funcionalidade «Tags de pedido adicionadas». A funcionalidade «Pedido atualizado com o campo de tags» é a mesma?

Não. A ação «Order updated» é executada sempre que se verifica uma alteração na lista de etiquetas e apresenta a lista após a alteração. Não indica a um fluxo de trabalho qual a etiqueta que foi adicionada ou removida. A ação «Order Tags Added» é acionada apenas quando são adicionadas etiquetas e indica os respetivos nomes. No nosso teste, uma etiqueta adicionada resultou em seis execuções com uma condição verdadeira no gatilho Flow e numa execução na ação «Order Tags Added». Consulte Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida.

Os meus fluxos de trabalho atuais continuam a funcionar?

Sim. Os novos gatilhos do Shopify constituem um acréscimo ao Flow. Os fluxos de trabalho baseados nos gatilhos desta aplicação não são afetados.

Próximos passos