Gatilho de metacampo do cliente
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo do cliente mudar, como o tamanho da roupa, e receba o valor antigo e o novo.
Uma loja de moda permite que os clientes salvem seu tamanho no metacampo “Tamanho da roupa” (custom.clothing_size). Quando um cliente altera esse valor, a loja deseja entrar em contato com ele, por exemplo, para sugerir produtos no novo tamanho.
Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de um cliente for alterado, utilizando as Workflow Trigger Extensions. As etapas são as mesmas para todos os metacampos desse tipo de recurso; o exemplo utiliza o tamanho da roupa (custom.clothing_size).
O que o senhor precisa
- Uma definição de metacampo. Crie-a no painel de administração do Shopify, em Configurações > Metacampos e metaobjetos > Clientes. Um metacampo sem definição não pode ser rastreado.
- A permissão Acesso aos dados do cliente. Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.
1. Acompanhar o metacampo
- Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
- Escolha o tipo de recurso Cliente.
- Marque o metacampo, neste caso Tamanho da roupa. É possível marcar vários de uma vez ou usar a opção Selecionar tudo.
- Clique em Adicionar gatilho.
Para acompanhar todos os metacampos desse tipo de recurso, incluindo aqueles que você criar posteriormente, selecione Todos os metacampos em vez de marcar cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

O novo gatilho exibe Inicializando enquanto o aplicativo lê o valor atual do metacampo dos seus clientes existentes e, em seguida, Ativo. Essa primeira leitura é o motivo pelo qual a primeira alteração já chega com o valor anterior correto.
Caso o metacampo não conste na lista, clique em Atualizar metacampos na página “Gatilhos de metacampos”: o aplicativo mantém a lista de definições por uma hora.
2. O que o fluxo de trabalho recebe
Cada alteração aciona o gatilho Metacampo Update no Shopify Flow com estes valores:
| Variável | Valor |
|---|---|
resourceType |
CUSTOMER |
resourceId |
O ID do cliente, por exemplo, gid://shopify/Customer/1234567890 |
metafieldKey |
Espaço de nomes e chave, neste caso custom.clothing_size |
metafield.value |
O novo valor |
metafield.previousValue |
O valor antes da alteração; vazio quando o metacampo foi definido pela primeira vez |
metafield.type |
O tipo do metacampo, por exemplo, single_line_text_field |
A Atualização do metacampo do cliente é um segundo gatilho para a mesma alteração. Ela é acionada além da “Atualização do metacampo” e inclui o cliente como uma referência nativa do Flow, de modo que as ações do cliente do próprio Shopify funcionam nela sem a necessidade de uma etapa de pesquisa. Ambas compartilham um único evento; portanto, o uso das duas não é contabilizado duas vezes. Ative-o na página Gatilhos do aplicativo ou ative um fluxo de trabalho que o utilize.
3. Criar o fluxo de trabalho
- No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
- Adicione uma condição:
resourceTypeé igual aCUSTOMER. A atualização do metacampo é iniciada para cada tipo de recurso que você rastreia; portanto, essa condição restringe este fluxo de trabalho aos clientes. Ao rastrear vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.clothing_sizecomo um segundo critério. - Adicione a ação necessária. No exemplo, é enviado um e-mail interno com o valor antigo e o novo.

Comece pelo exemplo
- Faça o download do arquivo
.flow, anexado na parte inferior desta página. - No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
- Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
- Ative o fluxo de trabalho.
Faça disso algo seu
- Marque o cliente: selecione a ação Adicionar tags ao cliente e insira
{{resourceId}}no campo “Cliente”. - Utilize a atualização do metacampo do cliente quando o fluxo de trabalho precisar obter mais informações sobre o cliente, como o endereço de e-mail.
- Adicione uma condição no
metafield.valuepara que a ação seja acionada apenas para um tamanho específico.
Com que rapidez ele reage
O Shopify notifica o aplicativo quando um cliente é cadastrado; portanto, o fluxo de trabalho geralmente é iniciado em poucos segundos.
É bom saber
- Um cliente criado com o metacampo já preenchido, por exemplo, por meio de um formulário de cadastro, inicia o fluxo de trabalho uma única vez, com um valor anterior vazio.
Mais
- Gatilhos de metacampo: como funcionam os gatilhos de metacampo, para cada tipo de recurso.
- Acionar o Shopify Flow ao atualizar os metacampos do cliente: um exemplo prático com um vídeo.
- Histórico de eventos e solução de problemas: visualize todos os eventos enviados pelo aplicativo, com os valores antigo e novo.
