Gatilho de metacampo da empresa
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de uma empresa B2B mudar, como o limite de crédito, e receba o valor antigo e o novo.
Um grossista registra o crédito acordado para cada cliente B2B no metacampo da empresa Limite de crédito (custom.credit_limit). Quando o departamento financeiro o aumentar ou reduzir, o gestor de contas deverá ser informado antes do próximo pedido.
Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma empresa for alterado, utilizando o Workflow Trigger Extensions. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza o Limite de crédito (custom.credit_limit).
O que precisa
- Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Empresas. 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 empresas fazem parte do B2B no Shopify. Este tipo de recurso só é útil numa loja que tenha empresas.
1. Acompanhar o metacampo
- Abra a secção Gatilhos de Metacampos na aplicação e clique em Adicionar gatilho.
- Escolha o tipo de recurso Empresa.
- Assinale o metacampo, neste caso Limite de crédito. 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 apenas alguns 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 nas suas empresas existentes 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 |
COMPANY |
resourceId |
O ID da empresa, por exemplo, gid://shopify/Company/1234567890 |
metafieldKey |
Espaço de nomes e chave, neste caso custom.credit_limit |
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 aCOMPANY. A atualização do metacampo é iniciada para cada tipo de recurso que acompanha, pelo que esta condição limita este fluxo de trabalho às empresas. Caso acompanhe vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.credit_limitcomo 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
- Compare
metafield.previousValuecommetafield.valuepara distinguir um aumento de uma redução. - Envie o novo limite para o seu ERP através da opção Enviar pedido HTTP.
- Adicione uma condição ao
metafieldKeyquando monitorizar vários metacampos da empresa.
Com que rapidez reage
O Shopify notifica a aplicação quando uma empresa é guardada. 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 suas empresas aproximadamente uma vez por minuto. O fluxo de trabalho deverá ocorrer em poucos segundos e, o mais tardar, após um ou dois minutos.
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.
