Gatilho do metacampo «Localização da empresa»

Gatilho do metacampo «Localização da empresa»

Copiar página

Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de localização da empresa B2B for alterado e receba o valor antigo e o novo.

Um cliente B2B tem várias filiais, e cada uma delas aceita entregas em horários diferentes. Os horários estão registados no metacampo Janela de entrega (custom.delivery_window) da localização da empresa, e o departamento de logística deve ser informado de qualquer alteração antes de se planear a próxima remessa.

Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma localização da empresa for alterado, utilizando as Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza a Janela de entrega (custom.delivery_window).

O que precisa

  • Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Locais da empresa. Um metacampo sem definição não pode ser monitorizado.
  • A autorização Acesso a dados de empresas e locais (B2B). Conceda-a na página Autorizações da aplicação; consulte Autorizações e acesso aos dados.
  • As localizações das empresas fazem parte do B2B no Shopify. Este tipo de recurso só é útil numa loja que tenha empresas.

1. Acompanhar o metacampo

  1. Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
  2. Selecione o tipo de recurso Localização da empresa.
  3. Assinale o metacampo, neste caso Janela de entrega. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
  4. 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 apenas alguns e, em seguida, clique em Acompanhar todos os metacampos.

A caixa de diálogo «Adicionar Gatilho de Metacampo» com o tipo de recurso «Localização da Empresa» e a janela do metacampo «Entrega», custom.delivery_window, marcada
Tipo de recurso «Localização da empresa», com o metacampo assinalado. A opção «Todos os metacampos» monitoriza, em vez disso, todos os metacampos desse tipo.

O novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo nas localizações existentes da sua empresa e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já seja apresentada 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 COMPANYLOCATION
resourceId O ID da localização da empresa, por exemplo, gid://shopify/CompanyLocation/1234567890
metafieldKey Espaço de nomes e chave, neste caso custom.delivery_window
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

  1. No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
  2. Adicione uma condição: resourceType é igual a COMPANYLOCATION. A atualização do metafield é iniciada para cada tipo de recurso que acompanha, pelo que esta condição limita este fluxo de trabalho às localizações da empresa. Caso acompanhe vários metafields deste tipo, adicione metafieldKey é igual a custom.delivery_window como segundo critério.
  3. Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.
O fluxo de trabalho de exemplo no Shopify Flow: Atualização do metacampo, uma condição relativa ao tipo de recurso COMPANYLOCATION e Envio de e-mail interno
O fluxo de trabalho de exemplo: o gatilho, a condição relativa ao tipo de recurso e uma ação.

Comece pelo exemplo

  1. Descarregue o ficheiro .flow, que se encontra em anexo na parte inferior desta página.
  2. No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
  3. Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
  4. Ative o fluxo de trabalho.

Faça-o seu

  • Envie uma nova janela para o seu operador ou ferramenta de planeamento através da opção Enviar pedido HTTP.
  • Adicione uma condição ao metafieldKey quando monitorizar vários metacampos relativos à localização da empresa.
  • Mantenha o valor anterior no e-mail através de metafield.previousValue, para que ninguém tenha de o procurar.

Com que rapidez reage

O Shopify notifica a aplicação quando é guardada uma localização da empresa. No caso de uma alteração que afete apenas um metacampo, por vezes não é enviada qualquer notificação; por isso, a aplicação também verifica as localizações da sua empresa aproximadamente uma vez por minuto. Pode esperar que o fluxo de trabalho seja executado em segundos e, o mais tardar, após um ou dois minutos.

Mais