Entender as ações no Shopify Flow

Em um fluxo de trabalho, as ações são as tarefas que o Flow executa quando as condições de um fluxo de trabalho são atendidas. As ações comuns incluem adicionar tags a pedidos ou clientes, enviar e-mails ou notificações do Slack, atualizar o estoque, suspender o processamento de pedidos, cancelar pedidos e criar rascunhos de pedido. Também é possível automatizar ações em apps de conectores de terceiros que você instalou, como enviar dados para o Planilhas Google, o Klaviyo ou o ShipStation.

As ações podem se conectar a qualquer outro tipo de etapa em um fluxo de trabalho, como um acionador, uma condição ou outra ação. Um fluxo de trabalho pode conter qualquer número de ações, e cada etapa pode se conectar a qualquer número de ações para um único resultado. Por exemplo, se uma condição for atendida, será possível conectar cinco etapas de ação separadas para que o fluxo de trabalho execute cinco tarefas ao mesmo tempo.

Nesta página

Como escolher ações para o fluxo de trabalho

Há muitas ações diferentes para escolher para realizar uma tarefa durante um fluxo de trabalho. Entender quais tarefas específicas podem ser automatizadas no Shopify Flow ajuda a garantir que o fluxo de trabalho funcione corretamente.

As ações se enquadram nas seguintes categorias:

Ações da loja: alteram algo na sua loja na Shopify, como adicionar tags, atualizar o estoque ou cancelar pedidos.
Ações de comunicação: enviam notificações personalizáveis por uma plataforma de sua escolha, como enviar um e-mail para você ou para sua equipe, publicar uma mensagem no Slack ou enviar um e-mail de marketing para seus clientes.
Ações de apps: executam uma tarefa em um app conectado. As opções disponíveis dependem de quais conectores de apps estão instalados na sua loja. Nem todos os apps têm um conector associado ao Shopify Flow.
Ações avançadas: estas ações modificam o comportamento ou os dados do fluxo de trabalho e incluem os seguintes tipos:
- Ações para coletar dados: buscam uma lista de dados adicionais de sua loja que não são fornecidos por padrão no acionador para usar no fluxo de trabalho. Essas ações chamam uma consulta com um conjunto de filtros, como para obter uma lista de dados de produtos atualizados no último dia.
- Ações de agregação: realizam cálculos em dados de lista em um fluxo de trabalho, como Contagem ou Soma.
- Ação de loop “para cada” (iterar): permite realizar uma tarefa em um loop para cada item retornado em uma lista.
- Ação para enviar solicitação: essas ações servem para enviar e receber dados da Shopify GraphQL Admin API ou de APIs externas.
- Ação de espera: um tipo exclusivo de ação que impede que o fluxo de trabalho avance para a próxima etapa até que um determinado período de tempo tenha passado.

Ao decidir como implementar a ação durante a criação de um fluxo de trabalho, analise as considerações a seguir com base na tarefa que o fluxo de trabalho deve automatizar:

Confirmar quais dados o fluxo de trabalho fornece

As ações precisam de dados para funcionar, e os dados precisam ser fornecidos à ação pelo acionador ou pela inclusão de uma ação Coletar dados durante o fluxo de trabalho. Se uma ação for selecionada sem receber os dados necessários, o fluxo de trabalho não será executado e exibirá uma mensagem de erro. Por exemplo, um fluxo de trabalho que começa com o acionador Cliente criado importa os dados do cliente para o fluxo de trabalho. Se esse acionador for seguido por uma ação Adicionar tags de pedido, que exige dados do pedido, e não do cliente, o fluxo de trabalho resultará em um erro de dados ausentes.

Por que isso é importante: esse é um motivo comum pelo qual fluxos de trabalho personalizados falham ou nunca funcionam. Antes de finalizar o fluxo de trabalho, pense nas informações de que a ação precisa para concluir a tarefa e certifique-se de que o conjunto de dados importado nas etapas anteriores possa oferecer esses dados.

Confirmar o tempo das ações em um fluxo de trabalho

Os workflows funcionam como uma série de etapas. Graças à tela de arrastar e soltar, é possível criar um workflow que executa várias ações simultaneamente ou organizá-lo para que as ações ocorram uma após a outra. Por exemplo, se a condição A for atendida, o workflow pode executar as ações X e Y ao mesmo tempo, ou pode executar a ação X e, em seguida, a ação Y. Isso pode ser importante quando determinadas condições ou ações exigem que outras ações tenham ocorrido anteriormente no workflow.

Normalmente, as ações ocorrem imediatamente quando uma condição é atendida e a etapa de ação é a seguinte no workflow. No entanto, também é possível controlar quando uma ação acontece usando a ação Aguardar. Isso pode ser útil para workflows que automatizam as comunicações com o cliente, como aguardar um dia antes de enviar um e-mail de marketing para um novo cliente. A organização de quando as ações ocorrem durante o workflow fica a seu critério.

Por que isso é importante: o tempo das ações determina quando as tarefas são executadas no workflow. Organizar as ações para que ocorram simultaneamente ou em sequência garante que as tarefas automatizadas aconteçam na ordem certa e atendam aos seus requisitos. Por exemplo, usando a ação Aguardar, é possível controlar o tempo das notificações para o cliente ou outras tarefas de acompanhamento para atender às suas necessidades.

Adicionar variáveis em ações para retornar dados dinâmicos

As variáveis podem ser usadas em etapas de ação para inserir dados dinâmicos em texto personalizado, como em e-mails para clientes. Elas são formatadas na mesma notação de ponto da GraphQL Admin API usada em condições e envolvidas por colchetes duplos {{ }}. Quando usadas em ações, as variáveis funcionam como um marcador de posição que retorna o valor específico da variável com base nos dados fornecidos durante o workflow.

Por exemplo, na ação Enviar fatura do pedido, o campo Assunto do e-mail contém a variável order.name por padrão e é formatado como “Fatura {{order.name}}”. Isso significa que, quando o e-mail é enviado, a linha de assunto do e-mail final exibe “Fatura nº 1000” ou qualquer que seja o número do pedido com base nesse valor para o pedido.

Quando aplicável, clique em Adicionar variável para pesquisar as variáveis disponíveis em um campo de uma ação. Isso permite personalizar o conteúdo de qualquer campo com base nas variáveis disponíveis para essa ação usando o Liquid. Também é possível adicionar instruções condicionais no código Liquid usando a variável para personalizar quando o conteúdo é exibido.

Por exemplo, na mesma ação Enviar fatura do pedido, é possível adicionar o seguinte conteúdo no campo Mensagem personalizada, que contém diversas variáveis que incluem valores dinâmicos com base nos dados fornecidos pelo workflow:

Hello {{order.customer.firstName}}! This is the invoice for order {{order.name}}, which you placed on {{order.createdAt}}.

{% if order.fullyPaid = 'false' %}
     Please complete any outstanding payments in the next 5 business days.
{% endif %}

Saiba mais sobre o uso de variáveis para exibir ou transformar dados no Shopify Flow.