Gatilho de metacampo da loja

Gatilho de metacampo da loja

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo da loja for alterado e receba o valor antigo e o novo no gatilho.

Uma loja mantém um aviso para toda a loja, como os dias de fechamento, no metacampo Aviso de feriado (custom.holiday_notice) da loja, e o tema o exibe. Quando alguém altera o aviso, a equipe deve ver o novo texto imediatamente.

Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo da loja for alterado, utilizando a Workflow Trigger Extensions. As etapas são as mesmas para todos os metacampos desse tipo de recurso; o exemplo utiliza o Aviso de feriado (custom.holiday_notice).

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 > Loja. Um metacampo sem definição não pode ser rastreado.
  • Não é necessária nenhuma permissão adicional. Os metacampos da loja podem ser rastreados assim que o aplicativo for instalado.

1. Acompanhar o metacampo

  1. Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Loja.
  3. Marque o metacampo “Aviso de feriado”. É possível marcar vários de uma vez ou usar a opção Selecionar tudo.
  4. 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.

A caixa de diálogo “Adicionar gatilho de metacampo” com o tipo de recurso “Loja” e o metacampo “Aviso de feriado”, custom.holiday_notice, marcado
Tipo de recurso: Loja, com o metacampo marcado. A opção “Todos os metacampos” rastreia, em vez disso, todos os metacampos desse tipo.

O gatilho fica ativo imediatamente. Na primeira vez em que o aplicativo lê a loja, ele armazena o valor atual sem iniciar um fluxo de trabalho; a partir daí, toda alteração inicia um fluxo de trabalho.

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 SHOP
resourceId O ID da loja, por exemplo, gid://shopify/Shop/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.holiday_notice
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 SHOP. A atualização do metacampo é iniciada para cada tipo de recurso que você rastreia; portanto, essa condição limita este fluxo de trabalho à loja. Caso você rastreie vários metacampos desse tipo, adicione metafieldKey é igual a custom.holiday_notice como um segundo critério.
  3. Adicione a ação necessária. No exemplo, é enviado 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 SHOP 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. Faça o download do arquivo .flow, anexado na parte inferior desta página.
  2. No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
  3. Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
  4. Ative o fluxo de trabalho.

Faça disso algo seu

  • Utilize metafield.previousValue e metafield.value no e-mail para exibir o aviso antigo e o novo.
  • Publique a alteração em um chat da equipe usando a opção Enviar solicitação HTTP.
  • Adicione uma condição no metafieldKey ao rastrear vários metacampos da loja.

Com que rapidez ele reage

O Shopify não envia nenhuma notificação a respeito, portanto, o aplicativo lê os metacampos rastreados aproximadamente uma vez por minuto. O fluxo de trabalho deve ocorrer dentro de um ou dois minutos.

É bom saber

  • Existe um registro de loja por loja; portanto, o resourceId é sempre o mesmo.

Mais