O gatilho «Atualização do cliente» do Flow e os gatilhos relacionados com o cliente desta aplicação
O que o gatilho Cliente atualizado do Shopify Flow monitoriza e os dez gatilhos de cliente desta aplicação que registam o valor anterior e o novo.
O gatilho Cliente atualizado do Flow inicia um fluxo de trabalho quando um dos até cinco campos do perfil de um cliente ou dos seus endereços é alterado. Segundo a página de ajuda da Shopify: «O gatilho “Cliente atualizado” fornece apenas os valores atuais do cliente e dos seus endereços.» e «Os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho.»
Esta aplicação dispõe de onze gatilhos de cliente. Dez deles são acionados por um determinado tipo de alteração e registam o valor anterior e o valor posterior. Os fluxos de trabalho relativos ao consentimento, ao e-mail e à morada, em particular, dependem do conhecimento do valor anterior.
O que o cliente que efetuou a atualização pode ver
Os campos da página de ajuda do Shopify, a partir de 20 de novembro de 2026:
| Grupo | Campos |
|---|---|
| Cliente | amountSpent, dataSaleOptOut, defaultAddress, firstName, image, lastName, lastOrder, locale, metafield.value, multipassIdentifier, note, numberOfOrders, productSubscriberStatus, state, tags, taxExempt, taxExemptions, verifiedEmail |
| Endereço de e-mail | defaultEmailAddress e, abaixo deste, marketingOptInLevel, marketingState, marketingUpdatedAt, openTrackingLevel, sourceLocation |
| Número de telefone | defaultPhoneNumber, defaultPhoneNumber.smsMarketingConsent e, abaixo destes, optInLevel, sourceLocation, state, updatedAt |
| Endereços | addressesV2 e, abaixo deste, address1, address2, city, company, countryCodeV2, firstName, lastName, latitude, longitude, phone, provinceCode, zip |
O que a página da Shopify acrescenta:
- Deve selecionar, no mínimo, um campo e, no máximo, cinco. Uma definição de metacampo ou um espaço de nomes completo conta como um dos cinco.
- «Na maioria dos casos, as alterações em campos que não selecionou não desencadeiam o fluxo de trabalho.»
- O Shopify pode registar uma alteração no endereço de e-mail predefinido ou no número de telefone predefinido como um todo. Um fluxo de trabalho que monitoriza um campo aninhado, como
defaultEmailAddress.marketingState, também é executado, mesmo que esse campo aninhado não tenha sofrido alterações. O Shopify recomenda uma condição que verifique o valor. - Adicionar ou eliminar um endereço conta como uma alteração nesse endereço e dá início a um fluxo de trabalho que monitoriza um campo do grupo «Endereços».
- A variável «Endereço postal» pode estar vazia quando o fluxo de trabalho é executado, por exemplo, quando um endereço foi removido.
Campo a campo
| O que mudou | Os clientes da Shopify Flow foram atualizados | Gatilho desta aplicação | O que o fluxo de trabalho ganha com isso |
|---|---|---|---|
| Consentimento para o marketing por e-mail | defaultEmailAddress.marketingState, marketingOptInLevel: valores atuais |
Alteração do consentimento do cliente para o marketing por e-mail | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| Consentimento para o marketing por SMS | defaultPhoneNumber.smsMarketingConsent.state, optInLevel: valores atuais |
Alteração do consentimento do cliente para o marketing por SMS | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| Endereço de e-mail | defaultEmailAddress: o novo endereço |
O endereço de e-mail do cliente foi alterado | email, oldEmail |
| Número de telefone | defaultPhoneNumber: o novo número |
Alteração do número de telefone do cliente | phone, oldPhone |
| Nome | firstName, lastName: o novo nome |
Alteração do nome do cliente | firstName, lastName, oldFirstName, oldLastName |
| Endereço predefinido | defaultAddress: o novo endereço |
Alteração da morada do cliente | address e oldAddress, e cada parte de ambos como um campo próprio |
| Tags | tags: a lista de tags após a alteração |
Tags de cliente adicionadas, tags de cliente removidas | addedTags, removedTags, previousTags, currentTags |
| Nota | note: a nova nota |
Nota do cliente alterada | oldNote, newNote |
| Estado da conta | state: o novo estado |
Alteração do estado do cliente | oldState, newState |
| Metacampo do cliente | metafield.value: o novo valor |
Atualização do metacampo do cliente | metafield.value, metafield.previousValue |
| Montante gasto, número de pedidos, último pedido, localização, isenções fiscais, outras moradas | na lista de Shopify Flow | A função «Atualização do Cliente» é acionada por estas atualizações. Nenhum gatilho desta aplicação mantém o seu valor anterior |
No que diz respeito às etiquetas, o Shopify Flow dispõe também dos seus próprios gatilhos «Etiquetas do cliente adicionadas» e «Etiquetas do cliente removidas», que apresentam a lista das etiquetas que foram adicionadas ou removidas.
Por que razão os fluxos de trabalho de consentimento necessitam de saber o estado prévio
Um fluxo de trabalho de consentimento tem de responder a uma pergunta: este cliente acabou de se subscrever ou acabou de cancelar a subscrição? O estado atual, por si só, não o indica. Um cliente que se encontra agora com o estado unsubscribed pode ter cancelado a subscrição há um segundo ou há um ano, e a própria página da Shopify refere que um fluxo de trabalho associado a um campo de e-mail ou de telefone aninhado pode ser executado, mesmo que esse campo não tenha sofrido alterações.
Uma condição como oldConsentState igual a subscribed e consentState igual a unsubscribed é verdadeira uma única vez, no momento da alteração. Pronto a utilizar: Assigne uma etiqueta aos clientes quando estes cancelarem a subscrição do e-mail de marketing e Marque os clientes quando estes cancelarem a subscrição do marketing por SMS.

Mais fluxos de trabalho que necessitam desse valor antes
Avisar o endereço antigo quando um endereço de e-mail for alterado. A notificação «E-mail do cliente alterado» contém oldEmail e email. Um aviso enviado para o endereço antigo constitui uma medida de segurança comum contra a apropriação indevida de contas e requer uma ação de e-mail que aceite uma variável como destinatário, por exemplo, o Workflow Transactional Email. Sem oldEmail, não há ninguém a quem avisar.
Verifique novamente as regras fiscais ou de envio quando um cliente mudar de morada. O campo «Alteração de morada do cliente» inclui o país e a província anteriores e posteriores, pelo que um fluxo de trabalho só pode ser acionado quando houver uma alteração do país.
Dê as boas-vindas a um cliente cuja conta foi ativada. O evento «Alteração do estado do cliente» inclui os parâmetros oldState e newState, pelo que o fluxo de trabalho reage à transição do estado «convidado» para «ativado» e não toma qualquer medida em relação a quaisquer outras alterações de estado.
Reaja a uma etapa de um estado personalizado. Um metacampo, como um nível de fidelidade, passa de prata para ouro: a «Atualização do Metacampo do Cliente» transmite os valores anterior e posterior, para que o fluxo de trabalho possa felicitar o cliente pela subida de nível e não emita qualquer mensagem em caso de descida de nível.
Quando a opção «Atualizar cliente» é a escolha certa
- Pode verificar o montante gasto, o número de pedidos, o último pedido, a localização ou as isenções fiscais.
- Pode monitorizar qualquer morada do cliente, não apenas a predefinida, ou o momento em que uma morada é adicionada ou removida.
- Basta um simples aviso com os valores atuais.
Ambos podem ser executados na mesma loja e não interferem entre si.
A atualização do cliente indica o endereço de e-mail anterior ou o estado anterior do consentimento?
Não. A página de ajuda da Shopify indica que o gatilho fornece apenas os valores atuais do cliente e das suas moradas. O gatilho «E-mail do cliente alterado» contém oldEmail e os dois gatilhos de consentimento contêm oldConsentState.
Por que razão o meu fluxo de trabalho num campo de marketing continua a ser executado, apesar de o consentimento não ter sofrido alterações?
Shopify
Como posso executar um fluxo de trabalho apenas quando um cliente cancelar a subscrição?
Utilize a alteração do consentimento de marketing por e-mail do cliente com a condição consentState igual a unsubscribed e adicione oldConsentState igual a subscribed, caso pretenda que a ação se aplique apenas à alteração.
Posso utilizar o gatilho «Adicionar etiquetas de cliente» do Flow em vez do desta aplicação?
Sim. Para os clientes, a Flow dispõe dos seus próprios gatilhos de etiquetas que indicam as etiquetas adicionadas ou removidas. Os gatilhos desta aplicação também incluem a lista de etiquetas antes e depois da alteração e funcionam da mesma forma para pedidos, produtos e pedidos provisórios, casos em que a Flow não dispõe de nenhum.
Os gatilhos de cliente armazenam dados pessoais?
Apenas as quatro que comparam dados pessoais (nome, e-mail, telefone, morada) e apenas quando as ativar. Consulte Autorizações e acesso aos dados.
Próximos passos
- Gatilhos de clientes, passo a passo - todos os gatilhos de cliente com um exemplo.
- Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles - todos os valores anteriores e posteriores, por gatilho.
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - a visão geral.
