Gatilho do metacampo da página

Gatilho do metacampo da página

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de uma página for alterado e obtenha o valor antigo e o novo.

As páginas jurídicas e de políticas têm de ser verificadas regularmente. A data da próxima verificação é registada no metacampo da página Data de revisão (custom.review_date), e quem quer que a altere deve deixar um registo para a equipa de conteúdos.

Esta página explica como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma página 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 Data de revisão (custom.review_date).

O que precisa

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

1. Acompanhar o metacampo

  1. Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Página.
  3. Assinale o metacampo Data de revisão. 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 «Página» e o metacampo «Data de revisão» (custom.review_date) assinalado
Tipo de recurso: Página, com o metacampo assinalado. A opção «Todos os metacampos» monitoriza, em vez disso, todos os metacampos desse tipo.

O gatilho fica ativo de imediato. Na primeira vez que a aplicação lê uma página, armazena o valor atual sem iniciar um fluxo de trabalho; qualquer alteração posterior dá início a um.

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 PAGE
resourceId O ID da página, por exemplo, gid://shopify/Page/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.review_date
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 PAGE. A atualização do metacampo é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho às páginas. Caso monitorize vários metacampos desse tipo, adicione metafieldKey é igual a custom.review_date 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 do metacampo, uma condição no tipo de recurso PÁGINA 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

  • Registe a alteração numa folha de cálculo ou numa ferramenta de gestão de tarefas utilizando a função Enviar pedido HTTP.
  • Adicione uma condição relativa a metafieldKey quando monitorizar vários metacampos da página.
  • Mantenha a data anterior no e-mail com metafield.previousValue.

Com que rapidez reage

O Shopify não envia notificações relativas a blogs, publicações de blog e páginas, pelo que a aplicação verifica esses conteúdos de forma programada. O fluxo de trabalho deverá ser executado no espaço de alguns minutos. Não é necessário ativar qualquer outro gatilho para este efeito.

É bom saber

  • Isto diz respeito aos metacampos de uma página. Para alterações à própria página (título, conteúdo, visibilidade), utilize o gatilho Atualização da página.

Mais