O gatilho “Atualização do cliente” do Flow e os gatilhos de cliente deste aplicativo
Quais campos o gatilho Cliente atualizado do Shopify Flow monitora e quais gatilhos de cliente do app registram o valor anterior e o posterior.
O gatilho Cliente atualizado do Shopify Flow inicia um fluxo de trabalho quando ocorre uma alteração em um dos até cinco campos do perfil de um cliente ou de seus endereços. Conforme indicado na página de ajuda do Shopify: “O gatilho ‘Cliente atualizado’ fornece apenas os valores atuais do cliente e de seus endereços.” e “Os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho.”
Este aplicativo possui onze gatilhos de cliente. Dez deles são acionados por um tipo específico de alteração e registram o valor anterior e o valor posterior. Os fluxos de trabalho relacionados a consentimento, e-mail e endereço, em particular, dependem do conhecimento do valor anterior.
O que o cliente que atualizou pode assistir
Os campos da página de ajuda do Shopify, em 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 dele, marketingOptInLevel, marketingState, marketingUpdatedAt, openTrackingLevel, sourceLocation |
| Número de telefone | defaultPhoneNumber, defaultPhoneNumber.smsMarketingConsent e, abaixo deles, optInLevel, sourceLocation, state, updatedAt |
| Endereços | addressesV2 e, abaixo dele, address1, address2, city, company, countryCodeV2, firstName, lastName, latitude, longitude, phone, provinceCode, zip |
O que a página da Shopify acrescenta:
- O senhor deve selecionar no mínimo um campo e no máximo cinco. Uma definição de metacampo ou um namespace inteiro conta como um dos cinco.
- "Na maioria dos casos, as alterações em campos que o senhor não selecionou não acionam o fluxo de trabalho."
- O Shopify pode registrar uma alteração no endereço de e-mail padrão ou no número de telefone padrão como um todo. Um fluxo de trabalho que monitora um campo aninhado, como
defaultEmailAddress.marketingState, também será executado, mesmo que esse campo aninhado não tenha sofrido alterações. O Shopify recomenda uma condição que verifique o valor. - Adicionar ou remover um endereço é considerado uma alteração nesse endereço e dá início a um fluxo de trabalho que monitora um campo do grupo “Endereços”.
- A variável “Endereço para correspondência” pode estar vazia quando o fluxo de trabalho for executado, por exemplo, quando um endereço tiver sido removido.
Campo por campo
| O que mudou | Atualização do cliente da Shopify Flow | Gatilho da funcionalidade principal deste aplicativo | O que o fluxo de trabalho oferece a mais |
|---|---|---|---|
| Consentimento para o marketing por e-mail | defaultEmailAddress.marketingState, marketingOptInLevel: valores atuais |
Alteração no consentimento para o marketing por e-mail dos clientes | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| Consentimento para marketing por SMS | defaultPhoneNumber.smsMarketingConsent.state, optInLevel: valores atuais |
Alteração no consentimento do cliente para marketing por SMS | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| Endereço de e-mail | defaultEmailAddress: o novo endereço |
E-mail do cliente 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 |
Nome do cliente alterado | firstName, lastName, oldFirstName, oldLastName |
| Endereço padrão | defaultAddress: o novo endereço |
Alteração do endereço 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 clientes adicionadas, tags de clientes removidas | addedTags, removedTags, previousTags, currentTags |
| Nota | note: a nova nota |
Nota do cliente alterada | oldNote, newNote |
| Status da conta | state: o novo estado |
Alteração no status do cliente | oldState, newState |
| Metacampo do cliente | metafield.value: o novo valor |
Atualização do metacampo do cliente | metafield.value, metafield.previousValue |
| Valor gasto, número de pedidos, último pedido, localização, isenções fiscais, outros endereços | na lista de Shopify Flow | A função “Atualização do Cliente” é acionada nessas atualizações. Nenhum gatilho desta aplicação mantém seu valor anterior |
No que diz respeito às tags, 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.
Por que os fluxos de trabalho de consentimento precisam do estado antes
Um fluxo de trabalho de consentimento precisa responder a uma pergunta: esse cliente acabou de se inscrever ou de cancelar a inscrição? O estado atual, por si só, não fornece essa informação. Um cliente que está unsubscribed neste momento pode ter cancelado a inscrição há um segundo ou há um ano, e a própria página do Shopify observa que um fluxo de trabalho em um campo aninhado de e-mail ou telefone pode ser executado mesmo que esse campo não tenha sofrido alterações.
As variáveis “Consentimento de marketing por e-mail do cliente alterado” e “Consentimento de marketing por SMS do cliente alterado” apresentam oldConsentState ao lado de consentState. Uma condição como oldConsentState igual a subscribed e consentState igual a unsubscribed é verdadeira uma única vez, no momento da alteração. Pronto para uso: Marque os clientes quando eles cancelarem a assinatura do e-mail de marketing e Marque os clientes quando eles cancelarem a assinatura do marketing por SMS.

Mais fluxos de trabalho que precisam desse valor antes
Notifique o endereço antigo quando houver uma alteração no e-mail. A notificação “E-mail do cliente alterado” contém oldEmail e email. Uma notificação enviada ao endereço antigo é uma medida de segurança comum contra a invasão 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á mais ninguém a quem notificar.
Verifique novamente as regras tributárias ou de remessa quando um cliente se mudar. O campo “Mudança de endereço do cliente” contém o país e a província anteriores e posteriores, de modo que um fluxo de trabalho só possa ser acionado quando houver mudança de país.
Dê as boas-vindas a um cliente cuja conta foi ativada. O evento “Alteração do estado do cliente” contém os parâmetros oldState e newState; assim, o fluxo de trabalho reage à transição do estado “convidado” para “ativado” e não aciona nenhuma ação em qualquer outra alteração de estado.
Reaja a uma etapa de um status personalizado. Um metacampo, como um nível de fidelidade, passa de prata para ouro: a atualização do metacampo do cliente contém os valores anterior e posterior, de modo que o fluxo de trabalho possa parabenizar pelo upgrade e não emitir nenhuma notificação em caso de downgrade.
Quando “Atualização do cliente” é a escolha certa
- O senhor acompanha o valor gasto, o número de pedidos, o último pedido, a região ou as isenções fiscais.
- O senhor monitora qualquer endereço do cliente, não apenas o padrão, ou o momento em que um endereço é adicionado ou removido.
- Basta um simples alerta com os valores atuais.
Ambos podem ser executados na mesma loja, e não interferem entre si.
A atualização do cliente fornece o endereço de e-mail anterior ou o status anterior do consentimento?
Não. A página de ajuda do Shopify informa que o gatilho fornece apenas os valores atuais do cliente e de seus endereços. O gatilho “E-mail do cliente alterado” contém oldEmail, e os dois gatilhos de consentimento contêm oldConsentState.
Por que meu fluxo de trabalho em um campo de marketing é executado, embora o consentimento não tenha sido alterado?
Shopify
Como faço para executar um fluxo de trabalho apenas quando um cliente cancela a assinatura?
Utilize a ação “Consentimento de marketing por e-mail do cliente alterado” com a condição consentState igual a unsubscribed e adicione oldConsentState igual a subscribed, caso deseje que a ação seja acionada apenas em caso de alteração.
Os gatilhos de cliente armazenam dados pessoais?
Apenas as quatro que comparam dados pessoais (nome, e-mail, telefone, endereço) e somente quando você as ativar. Consulte Permissõ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: como um fluxo de trabalho pode aproveitá-los - todos os valores anteriores e posteriores, por gatilho.
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - visão geral.
