Gatilho de metacampo do cliente
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo do cliente for alterado e obtenha o valor antigo e o novo.
Uma loja de moda permite que os clientes guardem o seu tamanho no metacampo Tamanho de roupa (custom.clothing_size). Quando um cliente o altera, a loja pretende dar seguimento a essa alteração, por exemplo, apresentando produtos no novo tamanho.
Esta página explica como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de um cliente for alterado, utilizando as Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza o Tamanho de roupa (custom.clothing_size).
O que precisa
- Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Clientes. Um metacampo sem definição não pode ser monitorizado.
- A autorização Acesso aos dados do cliente. Conceda-a na página Autorizações da aplicação; consulte Autorizações e acesso aos dados.
1. Acompanhar o metacampo
- Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
- Selecione o tipo de recurso Cliente.
- Assinale o metacampo, neste caso Tamanho do vestuário. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
- Clique em Adicionar gatilho.
Para acompanhar todos os metacampos deste tipo de recurso, incluindo aqueles que criar posteriormente, selecione Todos os metacampos em vez de assinalar apenas alguns e, em seguida, clique em Acompanhar todos os metacampos.

O novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo dos seus clientes existentes e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já chegue com o valor anterior correto.
Se o metacampo não constar da lista, clique em Atualizar metacampos na página «Gatilhos de metacampos»: a aplicação guarda a lista de definições durante uma hora.
2. O que o fluxo de trabalho recebe
Cada alteração aciona o gatilho Metacampo Update no Shopify Flow, com os seguintes 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. É executada em complemento à «Atualização do Metacampo» e inclui o cliente como uma referência nativa do Flow, pelo que as ações do cliente próprias da Shopify funcionam nela sem necessidade de uma etapa de pesquisa. Ambas partilham um único evento, pelo que a utilização das duas não conta duas vezes. Ative-o na página Gatilhos da aplicação 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 monitoriza, pelo que esta condição limita este fluxo de trabalho aos clientes. Caso monitorize vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.clothing_sizecomo segundo critério. - Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.

Comece pelo exemplo
- Descarregue o ficheiro
.flow, que se encontra em anexo na parte inferior desta página. - No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
- Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
- Ative o fluxo de trabalho.
Faça-o seu
- Assigne uma etiqueta ao cliente: selecione a ação Adicionar etiquetas ao cliente e insira
{{resourceId}}no campo «Cliente». - Utilize a Atualização do metacampo do cliente quando o fluxo de trabalho precisar de obter mais informações sobre o cliente, tais como o endereço de e-mail.
- Adicione uma condição ao
metafield.valuepara que reaja apenas a um tamanho.
Com que rapidez reage
O Shopify notifica a aplicação quando um cliente é guardado, pelo que o fluxo de trabalho geralmente começa em poucos segundos.
É bom saber
- Um cliente criado com o metacampo já preenchido, por exemplo, através de um formulário de registo, 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 quando forem atualizados os metacampos do cliente: um exemplo prático com um vídeo.
- Histórico de eventos e resolução de problemas: veja todos os eventos enviados pela aplicação, com o valor antigo e o novo.
