Gatilho de metacampo de postagem de blog

Gatilho de metacampo de postagem de blog

Copiar página

Inicie um fluxo do Shopify Flow quando um metacampo de postagem de blog mudar, com o valor antigo e o novo, usando as Workflow Trigger Extensions.

As postagens passam por uma revisão editorial antes de serem publicadas. O status dessa etapa é registrado no metacampo Status da revisão (custom.review_status) da postagem do blog e, quando ele passar para approved, a pessoa responsável pela publicação deve ser notificada.

Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma postagem de blog 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 Status da revisão (custom.review_status).

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 > Postagens do blog. Um metacampo sem definição não pode ser rastreado.
  • A permissão Acesso a dados de blogs, postagens de blog e páginas. Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.

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 Postagem de blog.
  3. Marque o metacampo Status da revisão. É possível marcar vários de uma só 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 “Postagem de blog” e o metacampo “Status da revisão”, custom.review_status, marcado
Tipo de recurso: Postagem de blog; o metacampo foi 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ê uma postagem do blog, ele armazena o valor atual sem iniciar um fluxo de trabalho; a partir daí, cada alteração inicia um.

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 ARTICLE
resourceId O ID da postagem do blog, por exemplo, gid://shopify/Article/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.review_status
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 ARTICLE. A atualização do metacampo é iniciada para cada tipo de recurso que o senhor acompanha; portanto, essa condição limita este fluxo de trabalho às postagens do blog. Caso o senhor acompanhe vários metacampos desse tipo, adicione metafieldKey é igual a custom.review_status 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 ARTIGO 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

  • Adicione uma condição no metafield.value para que a ação ocorra apenas quando o valor for approved.
  • 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 de postagens de blog.

Com que rapidez ele reage

O Shopify não envia notificações para blogs, postagens de blog e páginas; por isso, o aplicativo verifica esses conteúdos em intervalos programados. O fluxo de trabalho deve ser executado em poucos minutos. Não é necessário ativar nenhum outro gatilho para isso.

É bom saber

  • Nos eventos, o tipo de recurso de uma postagem de blog é ARTICLE, o nome que a Shopify utiliza para ela.
  • Para alterações na própria postagem (título, conteúdo, tags), utilize o gatilho Atualização da postagem do blog.

Mais