Gatilho de metacampo «Pedido provisório»
Inicie um fluxo do Shopify Flow quando um metacampo de um pedido provisório mudar e receba o valor antigo e o novo, por exemplo o estado de um orçamento.
Uma equipa de vendas trabalha com orçamentos como pedidos provisórios e mantém o estado no metacampo Estado do orçamento (custom.quote_status) do pedido provisório. Quando um orçamento passa para o estado approved, a pessoa responsável pela emissão da fatura deve ser informada.
Esta página explica 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. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza o Estado da cotação (custom.quote_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 > Pedidos provisórios. Um metacampo sem definição não pode ser monitorizado.
- A permissão Acesso aos dados do pedido provisório. 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.
- Selecione o tipo de recurso Pedido provisório.
- Assinale o metacampo «Estado da cotaçã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 novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo nos seus pedidos provisórios existentes e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já venha com o valor anterior correto.
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 |
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 acompanha, pelo que esta condição limita este fluxo de trabalho aos pedidos provisórios. Caso acompanhe vários metacampos deste tipo, adicionemetafieldKeyé igual acustom.quote_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
.flow, que se encontra em anexo na parte inferior 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. - Marcar o rascunho: adicione a ação Adicionar etiquetas de pedido provisório ao rascunho e insira
{{resourceId}}no campo «Pedido provisório» do rascunho. - Envie a alteração para o seu CRM através da opção Enviar pedido HTTP.
Com que rapidez reage
O Shopify notifica a aplicação quando um pedido provisório é guardado, pelo que o fluxo de trabalho geralmente começa em poucos segundos.
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.
