Seu primeiro fluxo de trabalho, passo a passo

Este tutorial mostra como criar um fluxo de trabalho completo a partir de uma tela em branco do Shopify Flow: alertar a equipe quando o preço de um produto for reduzido em mais de 10%. Ele utiliza o gatilho “Alteração no preço da variante do produto”, mas todos os gatilhos desse aplicativo são usados da mesma forma; portanto, os cinco passos a seguir se aplicam a todos eles.

É necessário ter o aplicativo instalado e ter permissão para acessar os dados de produtos, variantes e coleções. Caso contrário, comece por Instalar e configurar.

1. Crie um fluxo de trabalho e selecione o gatilho

Acesse Shopify Flow no seu painel de administração (Aplicativos > Flow) e clique em “Criar fluxo de trabalho”. O Flow abre um fluxo de trabalho vazio com um campo de prompt no meio. Para definir um gatilho para este aplicativo, clique em “Selecionar um gatilho” abaixo dele.

Um novo fluxo de trabalho vazio do Shopify Flow, com um campo de prompt e os botões “Selecionar um gatilho” e “Procurar modelos”
Um novo fluxo de trabalho. Para definir um gatilho para este aplicativo, clique em “Selecionar um gatilho”.

No painel que se abre, acesse “Workflow Trigger Extensions”. Todos os gatilhos do aplicativo estão listados ali, acompanhados de uma descrição de uma linha. Você também pode digitar um nome no campo de pesquisa na parte superior. Selecione “Product Variant Price Changed”.

O painel de gatilhos do Select do Flow, com o Workflow Trigger Extensions aberto e seus gatilhos listados, cada um com uma descrição
Todos os gatilhos do aplicativo, cada um com uma descrição de uma linha. O campo de pesquisa filtra a lista.

O gatilho é agora a primeira etapa do fluxo de trabalho. Seu painel mostra o que o gatilho transmite - ou seja, os dados que suas condições e ações podem utilizar.

A tela do fluxo de trabalho com “Alteração do preço da variante do produto” como primeira etapa
O gatilho é a primeira etapa do fluxo de trabalho.

2. Adicionar uma condição

Clique no + abaixo do gatilho e selecione “Condição”. Ao clicar em “Adicionar critérios: Fluxo”, o seletor de variáveis é aberto. Tudo o que aparece abaixo do nome do gatilho vem deste aplicativo.

Para uma variação de preço que seja priceChange entre o preço antigo e o novo, a diferença (delta), a porcentagem (percentChange) e o direction. Esses valores existem porque uma condição do Flow não pode realizar cálculos, e os valores monetários são fornecidos como texto - portanto, o aplicativo faz os cálculos e apresenta o resultado como um número.

O ícone de mais abaixo do passo do gatilho se abriu, exibindo “Ação” e “Condição”
O símbolo “+” abaixo de uma etapa oferece os dois elementos que compõem um fluxo de trabalho: uma condição e uma ação.
Seletor de variáveis do Flow exibindo oldPrice, newPrice, delta, percentChange e direction sob priceChange
O que o gatilho fornece ao seu fluxo de trabalho: o preço antes e depois, a diferença, a porcentagem e a direção.

Selecione percentChange, escolha “Menor que” e insira -10. A partir de agora, o fluxo de trabalho continuará apenas para descontos superiores a 10 por cento.

Uma condição do Flow: priceChange.percentChange é menor que -10
O estado final.

3. Adicionar uma ação

Em “Então”, clique em + e selecione “Ação”. Para um alerta, a opção “Enviar e-mail interno” é a mais simples: não requer nenhum outro aplicativo. Insira variáveis no texto com “Adicionar variável”, por exemplo:

{{productVariant.product.title}} / {{productVariant.title}}: {{priceChange.oldPrice.amount}} -> {{priceChange.newPrice.amount}} ({{priceChange.percentChange}} %)

Tudo o que o Flow pode fazer funciona aqui: adicionar tags, atualizar um metacampo, enviar uma solicitação HTTP para o Slack ou para o seu ERP.

Opcional: organize os dados com o código “Executar”

Quando o texto desejado envolver mais do que algumas variáveis - arredondamento, um valor alternativo para um valor vazio, um cálculo - , insira a etapa “Executar código” do Flow entre a condição e a ação. Ela recebe os dados do gatilho como uminputo e retorna um objeto que pode ser utilizado nas etapas seguintes.

Etapa de código “Run” do Flow que lê oldPrice, newPrice e percentChange a partir do gatilho
O código de execução recebe os dados do gatilho como entrada e retorna valores para as etapas subsequentes.

4. Ative o fluxo de trabalho

Dê um nome ao fluxo de trabalho e clique em “Ativar fluxo de trabalho”. O Flow informa ao aplicativo que um fluxo de trabalho com esse gatilho está ativo, e o aplicativo cuida do resto:

  • isso aciona o gatilho e
  • Quando ocorre um gatilho de alteração, ele lê o estado atual dos registros correspondentes uma única vez (a sincronização inicial), de modo que a primeira alteração já tenha algo com que comparar.

Em um catálogo grande, a sincronização inicial pode levar alguns minutos. Até que ela seja concluída, a primeira alteração em um registro pode não ser processada.

O fluxo de trabalho concluído: gatilho, condição, Executar código, com a opção “Ativar fluxo de trabalho” no canto superior direito
O fluxo de trabalho concluído. A opção “Ativar fluxo de trabalho” fica no canto superior direito.

5. Faça a alteração e verifique o Histórico de Eventos

Altere o preço de uma variante de teste em mais de 10%. Em seguida, abra o “Histórico de Eventos” no aplicativo: todos os eventos que o aplicativo enviou para o Flow estão listados ali, com seu status. Se for bem-sucedido, significa que o Shopify Flow aceitou o evento.

A página “Histórico de eventos” do aplicativo, que lista os gatilhos acionados com seus respectivos status
O “Histórico de eventos” lista todos os eventos que o aplicativo enviou para Shopify Flow.

Clique no evento para ver exatamente o que foi enviado - os mesmos valores que sua condição detectou. Se o fluxo de trabalho não funcionou como você esperava, esse é o primeiro lugar a verificar: o evento está lá e contém os valores que você supôs?

Foi registrado um evento no Histórico de Eventos: uma variação de preço de 89,00 para 69,00, com os parâmetros delta, percentChange e direction
Um evento, aberto: exatamente os valores que sua condição verificou.