Gatilho de metaobjeto, passo a passo

Um gatilho para entradas de metaobjetos: guias de tamanhos, localizadores de lojas, listas de ingredientes, membros da equipe, qualquer coisa que você mesmo tenha modelado. Você escolhe quais definições monitorar na página “Gatilhos de Metaobjetos” do aplicativo. Consulte Gatilhos de metaobjetos.

Shopify Flow
Onde encontrá-los: em Shopify Flow, selecione “Select a trigger”, acesse Workflow Trigger Extensions e pesquise por “Metaobject”.

Entrada do metaobjeto atualizada

É disparado quando uma entrada de uma definição de metaobjeto monitorada é atualizada. A entrada é enviada na íntegra: type, handle, displayName e todos os campos com suas chaves e valores.

Incêndios causados por Shopify webhook
Permissão Acesso aos dados de metaobjetos
Ligado Por definição do metaobjeto, na página “Gatilhos de metaobjetos” do aplicativo

Use-o para

  • Informe a equipe de conteúdo sempre que houver alterações no guia de tamanhos ou nas instruções de cuidados.
  • Enviar as entradas alteradas do localizador de lojas para um provedor de mapas.
  • Recriar algo na interface do usuário que seja gerado a partir de metaobjetos.

O que a entrada “Metaobjeto atualizado” envia para o seu fluxo de trabalho

Variável no fluxo Tipo O que contém
metaobjectHandle Texto O identificador do metaobjeto que foi atualizado (para filtragem no Flow)
metaobject Objeto A entrada do metaobjeto que foi atualizada
metaobject.definition Objeto A MetaobjectDefinition que modela esse tipo de objeto
metaobject.displayName Texto Nome de exibição do metaobjeto
metaobject.fields Lista de objetos Todos os campos do metaobjeto, com suas chaves e valores
metaobject.fields (each).definition Objeto A definição do campo para esta chave de objeto
metaobject.fields (each).jsonValue Texto O valor atribuído ao campo no formato JSON
metaobject.fields (each).key Texto A chave do objeto deste campo
metaobject.fields (each).thumbnail Objeto Atributos visuais para campos de arquivo ou de cor
metaobject.fields (each).type Texto O tipo do campo
metaobject.fields (each).value Texto O valor atribuído ao campo, sempre armazenado como uma string
metaobject.handle Texto Identificador/slug da instância do metaobjeto
metaobject.id ID ID global do metaobjeto
metaobject.type Texto Tipo/identificador da definição do metaobjeto
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Notificar a equipe de conteúdo sobre uma alteração no guia de tamanhos

  1. No aplicativo, abra “Metaobject Triggers”, clique em “Adicionar gatilho”, escolha a definição e salve.
  2. No Flow, a entrada do metaobjeto foi atualizada.
  3. Adicionar uma condição: metaobject.type é igual a size_guide.
  4. Adicione o envio de um e-mail interno com {{metaobject.displayName}} e um loop Liquid for sobre metaobject.fields que exiba o key e o value de cada campo.
  5. Ative o fluxo de trabalho.
A caixa de diálogo “Selecionar tipo de metaobjeto” com o guia de tipo “Tamanho” selecionado
Primeiro, observe o tipo no aplicativo: Gatilhos de metaobjetos, Adicionar gatilho, Guia de tamanhos.

Próximos passos