Gatilho do metacampo “Localização da empresa”

Gatilho do metacampo “Localização da empresa”

Copiar página

Inicie um fluxo do Shopify Flow quando um metacampo da localização da empresa (B2B) mudar e receba o valor antigo e o novo.

Um cliente B2B possui várias filiais, e cada uma delas aceita entregas em horários diferentes. Esses horários são registrados no metacampo Janela de entrega (custom.delivery_window) da localização da empresa, e o departamento de logística deve ser informado sobre qualquer alteração antes do planejamento da próxima remessa.

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

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 > Locais da empresa. Um metacampo sem definição não pode ser rastreado.
  • A permissão Acesso a dados de empresas e localização (B2B). Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.
  • As localizações das empresas fazem parte do B2B no Shopify. Esse tipo de recurso só é útil em uma loja que possua empresas.

1. Acompanhar o metacampo

  1. Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Localização da empresa.
  3. Marque o metacampo, neste caso Janela de entrega. É possível marcar vários de uma só vez ou usar a opção Selecionar tudo.
  4. 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.

A caixa de diálogo “Adicionar gatilho de metacampo” com o tipo de recurso “Localização da empresa” e o metacampo “Janela de entrega”, custom.delivery_window, marcado
Tipo de recurso: Localização da empresa, com o metacampo marcado. A opção “Todos os metacampos” rastreia, em vez disso, todos os metacampos desse tipo.

O novo gatilho exibe Inicializando enquanto o aplicativo lê o valor atual do metacampo nas localizações existentes da sua empresa 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 COMPANYLOCATION
resourceId O ID do local 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 metacampo é iniciada para cada tipo de recurso que você rastreia; portanto, essa condição restringe este fluxo de trabalho aos locais da empresa. Caso você rastreie vários metacampos desse tipo, adicione metafieldKey é igual a custom.delivery_window como um segundo critério.
  3. Adicione a ação necessária. No exemplo, é enviado um e-mail interno com o valor antigo e o novo.
O fluxo de trabalho de exemplo no Shopify Flow: Atualização de metacampo, uma condição no 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. Faça o download do arquivo .flow, anexado na parte inferior desta página.
  2. No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
  3. Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
  4. Ative o fluxo de trabalho.

Faça disso algo seu

  • Envie uma nova janela para sua operadora ou ferramenta de planejamento por meio da opção Enviar solicitação HTTP.
  • Adicione uma condição no metafieldKey ao rastrear vários metacampos de localização da empresa.
  • Mantenha o valor anterior no e-mail por meio de metafield.previousValue, para que ninguém precise procurá-lo.

Com que rapidez ele reage

O Shopify notifica o aplicativo quando a localização de uma empresa é salva. No caso de uma alteração que afete apenas um metacampo, às vezes não é enviada nenhuma notificação; por isso, o aplicativo também verifica as localizações de sua empresa aproximadamente uma vez por minuto. O fluxo de trabalho deve ocorrer em questão de segundos e, no máximo, após um ou dois minutos.

Mais