O gatilho «Atualização do cliente» do Flow e os gatilhos relacionados com o cliente desta aplicação

O gatilho «Atualização do cliente» do Flow e os gatilhos relacionados com o cliente desta aplicação

Copiar página

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.

O fluxo de trabalho no Shopify Flow: atribuir tags aos clientes quando estes cancelam a subscrição do marketing por e-mail
O modelo que atribui uma tag aos clientes quando estes cancelam a subscrição e que remove essa tag quando voltam a subscrever.

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