Gatilho de metacampo “Pedido provisório”
Inicie um fluxo do Shopify Flow quando um metacampo de pedido provisório mudar, como o status da cotação, e receba o valor antigo e o novo.
Uma equipe de vendas utiliza as cotações como pedidos provisórios e mantém o estágio no metacampo Status da cotação (custom.quote_status) do pedido provisório. Quando uma cotação passa para o status approved, a pessoa responsável pelo envio da fatura deve ser notificada.
Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de um pedido provisório 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 cotação (custom.quote_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 > Pedidos provisórios. Um metacampo sem definição não pode ser rastreado.
- A permissão Acesso aos dados do pedido provisório. Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.
1. Acompanhar o metacampo
- Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
- Escolha o tipo de recurso Pedido provisório.
- Marque o metacampo Status da cotação. É possível marcar vários de uma só vez ou usar a opção Selecionar tudo.
- 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.

O novo gatilho exibe Inicializando enquanto o aplicativo lê o valor atual do metacampo em seus pedidos provisórios existentes e, em seguida, Ativo. Essa primeira leitura é o motivo pelo qual a primeira alteração já chega com o valor anterior correto.
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 |
DRAFTORDER |
resourceId |
O ID do pedido provisório, por exemplo, gid://shopify/DraftOrder/1234567890 |
metafieldKey |
Espaço de nomes e chave, neste caso custom.quote_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 aDRAFTORDER. A atualização do metacampo é iniciada para cada tipo de recurso que o senhor acompanha; portanto, essa condição limita este fluxo de trabalho aos pedidos provisórios. Caso o senhor acompanhe vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.quote_statuscomo um segundo critério. - Adicione a ação necessária. No exemplo, é enviado um e-mail interno com o valor antigo e o novo.

Comece pelo exemplo
- Faça o download do arquivo
.flow, anexado na parte inferior desta página. - No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
- Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
- Ative o fluxo de trabalho.
Faça disso algo seu
- Adicione uma condição no
metafield.valuepara que a ação ocorra apenas quando o valor forapproved. - Marque o rascunho: adicione as tags de pedido provisório e insira
{{resourceId}}no campo de pedido provisório. - Envie a alteração para o seu CRM por meio da opção Enviar solicitação HTTP.
Com que rapidez ele reage
O Shopify notifica o aplicativo quando um pedido provisório é salvo; portanto, o fluxo de trabalho geralmente é iniciado em poucos segundos.
Mais
- Gatilhos de metacampo: como funcionam os gatilhos de metacampos, para cada tipo de recurso.
- Histórico de eventos e solução de problemas: visualize todos os eventos enviados pelo aplicativo, com os valores antigo e novo.
