Gatilho de metaobjeto, passo a passo
Tutorial passo a passo do Shopify Flow sobre o gatilho de atualização de entradas de Metaobjeto: monitorize uma definição e reaja às entradas alteradas.
Um dos gatilhos para entradas de metaobjetos: guias de tamanhos, localizadores de lojas, listas de ingredientes, membros da equipa, tudo o que tiver modelado. Pode escolher quais as definições a monitorizar na página «Gatilhos de Metaobjetos» da aplicação. Consulte Gatilhos de metaobjetos.

Entrada do metaobjeto atualizada
É acionado quando uma entrada de uma definição de metaobjeto monitorizada é atualizada. É enviada a entrada na íntegra: type, handle, displayName e todos os campos com a respetiva chave e valor.
| Incêndios provocados por | Shopify webhook |
| Autorização | Acesso aos dados de metaobjetos |
| Ligado | Por definição do metaobjeto, na página «Metaobject Triggers» da aplicação |
Utilize-o para
- Informe a equipa de conteúdos sempre que houver alterações num guia de tamanhos ou nas instruções de manutenção.
- Envie as entradas alteradas do localizador de lojas para um fornecedor de mapas.
- Recriar, na loja virtual, algo que seja gerado a partir de metaobjetos.
O que a entrada «Metaobjeto» atualizada envia para o seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
metaobjectHandle |
Texto | O identificador do metaobjeto que foi atualizado (para efeitos de filtragem no Shopify Flow) |
metaobject |
Objeto | A entrada do metaobjeto que foi atualizada |
metaobject.definition |
Objeto | A MetaobjectDefinition que modela este tipo de objeto |
metaobject.displayName |
Texto | Nome de exibição do metaobjeto |
metaobject.fields |
Lista de objetos | Todos os campos do metaobjeto, com as respetivas 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 ficheiro 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 cadeia de caracteres |
metaobject.handle |
Texto | Identificador/slug da instância do metaobjeto |
metaobject.id |
ID | Identificador 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 da aplicação para ver exatamente o que foi enviado. |
Exemplo: Notificar a equipa de conteúdos sobre uma alteração no guia de tamanhos
- Na aplicação, abra «Metaobject Triggers», clique em «Adicionar gatilho», selecione a definição e guarde.
- No Shopify Flow, a entrada do metaobjeto foi atualizada.
- Adicione uma condição:
metaobject.typeé igual asize_guide. - Adicione a função «Enviar e-mail interno» com
{{metaobject.displayName}}e um ciclo Liquidforsobremetaobject.fieldsque exibakeyevaluede cada campo. - Ative o fluxo de trabalho.

Próximos passos
- Referência completa sobre os gatilhos - todos os gatilhos numa única página.
- Escolher o gatilho certo - qual deles se adequa ao seu caso.
- Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
- Histórico de eventos e resolução de problemas - ver o que foi disparado e o que transportava.
