O gatilho “Atualização do cliente” do Flow e os gatilhos de cliente deste aplicativo

O gatilho “Atualização do cliente” do Flow e os gatilhos de cliente deste aplicativo

Copiar página

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.

O fluxo de trabalho no Shopify Flow: marque os clientes quando eles cancelarem a assinatura do e-mail de marketing
O modelo que marca os clientes quando eles cancelam a assinatura e remove a tag quando eles se inscrevem novamente.

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.

Posso utilizar o gatilho “Adicionado” das tags de cliente do Flow em vez do gatilho deste aplicativo?

Sim. Para os clientes, o Flow possui seus próprios gatilhos de tags que indicam as tags adicionadas ou removidas. Os gatilhos desse aplicativo também incluem a lista de tags antes e depois da alteração e funcionam da mesma forma para pedidos, produtos e pedidos provisórios, casos em que o Flow não possui gatilhos próprios.

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