Gatilho de metacampo de publicação de blogue
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de uma publicação de blogue mudar e obtenha o valor antigo e o novo.
As publicações são submetidas a uma verificação editorial antes de serem publicadas. O estado é registado no metacampo Estado de revisão (custom.review_status) da publicação do blogue e, quando passar para approved, a pessoa responsável pela publicação deve ser notificada.
Esta página explica como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma publicação de blogue for alterado, utilizando a Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza o Estado da revisão (custom.review_status).
O que precisa
- Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Publicações do blogue. 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
- Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
- Escolha o tipo de recurso Publicação no blogue.
- Assinale o metacampo Estado da revisão. 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 cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

O gatilho fica ativo de imediato. Na primeira vez que a aplicação lê uma publicação no blogue, 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 |
ARTICLE |
resourceId |
O ID da publicação do blogue, 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
- 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 aARTICLE. A atualização do metacampo é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho às publicações do blogue. Caso monitorize vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.review_statuscomo 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
.flowem anexo no final 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
- Adicione uma condição no
metafield.valuepara reagir apenas aoapproved. - Publique a alteração num chat da equipa através da opção Enviar pedido HTTP.
- Adicione uma condição ao
metafieldKeyquando monitorizar vários metacampos de publicações do blogue.
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
- Nos eventos, o tipo de recurso de uma publicação de blogue é
ARTICLE, o nome que a Shopify lhe atribui. - Para alterações ao próprio artigo (título, conteúdo, tags), utilize o gatilho Atualização do artigo do blogue.
Mais
- Gatilhos de metacampo: como funcionam os gatilhos de metacampo, para cada tipo de recurso.
- Histórico de eventos e resolução de problemas: veja todos os eventos enviados pela aplicação, com o valor antigo e o novo.
