Gatilho do metacampo «Mercado»

Gatilho do metacampo «Mercado»

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de mercado for alterado e receba o valor antigo e o novo de cada alteração.

Uma loja vende em vários países e apresenta um texto relativo ao envio específico para cada mercado, a partir do metacampo Nota de envio (custom.shipping_note) do mercado em questão. Quando o texto de um mercado é alterado, o suporte ao cliente deve saber qual é a informação que está a ser transmitida aos clientes desse mercado.

Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de um mercado for alterado, utilizando a Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza a Nota de envio (custom.shipping_note).

O que precisa

  • Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Mercados. Um metacampo sem definição não pode ser monitorizado.
  • A autorização Acesso a dados de mercado. Conceda-a na página Autorizações da aplicação; consulte Autorizações e acesso aos dados.

1. Acompanhar o metacampo

  1. Abra a secção Gatilhos de Metacampo na aplicação e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Mercado.
  3. Assinale o metacampo, neste caso Nota de envio. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
  4. 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 cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

A caixa de diálogo «Adicionar gatilho de metacampo» com o tipo de recurso «Mercado» e o metacampo «Nota de envio», custom.shipping_note, assinalado
Tipo de recurso: Mercado, o metacampo marcado. A opção «Todos os metacampos» monitoriza, em vez disso, todos os metacampos desse tipo.

O novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo nos seus mercados existentes e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já seja recebida 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 MARKET
resourceId O ID do mercado, por exemplo, gid://shopify/Market/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.shipping_note
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

3. Criar o fluxo de trabalho

  1. No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
  2. Adicione uma condição: resourceType é igual a MARKET. A atualização do metacampo é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho aos mercados. Caso monitorize vários metacampos desse tipo, adicione metafieldKey é igual a custom.shipping_note como segundo critério.
  3. Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.
O fluxo de trabalho de exemplo no Shopify Flow: Atualização de metacampo, uma condição no tipo de recurso MARKET e Envio de e-mail interno
O fluxo de trabalho de exemplo: o gatilho, a condição relativa ao tipo de recurso e uma ação.

Comece pelo exemplo

  1. Descarregue o ficheiro .flow, que se encontra em anexo na parte inferior desta página.
  2. No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
  3. Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
  4. Ative o fluxo de trabalho.

Faça-o seu

  • Utilize metafield.previousValue e metafield.value no e-mail para apresentar o texto antigo e o novo.
  • Publique a alteração num chat da equipa através da opção Enviar pedido HTTP.
  • Adicione uma condição ao metafieldKey quando monitorizar vários metacampos de mercado.

Com que rapidez reage

O Shopify notifica a aplicação quando um mercado é guardado. No caso de uma alteração que afete apenas um metacampo, por vezes não é enviada qualquer notificação, pelo que a aplicação também verifica os seus mercados aproximadamente uma vez por minuto. O fluxo de trabalho deverá ocorrer em poucos segundos e, o mais tardar, após um ou dois minutos.

Mais