Obter dados de clientes

Em fluxos de trabalho que usam dados de clientes, é possível usar a ação Obter dados de clientes para recuperar informações de clientes da sua loja.

Configuração

Campos

A ação Obter dados de clientes contém os seguintes campos, usados para criar a consulta:

String de consulta

Este é um exemplo de consulta para buscar clientes que foram atualizados no último dia:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

A variável updated_at é um filtro disponível na consulta de Clientes e pode ser usada várias vezes ou combinada com outras variáveis. A variável do Liquid scheduledAt está disponível em workflows que usam o acionador de horário agendado. A tag do Liquid date_minus é uma tag especial do Flow que permite subtrair tempo de uma data.

Ao consultar dados, é útil saber o seguinte:

• Lista de filtros de cliente disponíveis
• As consultas precisam seguir uma sintaxe específica
• Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, é possível encontrá-los na documentação da API. Como alternativa, é comum que os valores dos campos estejam nos URLs do admin quando você aplica filtros. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no admin e verifique o URL.
• É possível executar ou testar uma consulta na sua loja com o app GraphiQL da Shopify.
• Preste atenção no que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados, em vez de nenhum.

Dados retornados

Todas as ações Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do seu caso de uso, é possível usar esses dados de várias maneiras:

• Se você precisa lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
• Se você precisa agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
• Se você precisa da lista como resultado, por exemplo, para enviar um e-mail com todos os itens, pode usar os dados retornados diretamente em ações subsequentes.

Para acessar os dados retornados em etapas posteriores a esta ação, use a variável Obter dados do cliente, que é uma lista de clientes. Você pode usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de pedidos em uma ação Enviar e-mail interno como esta:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

Acionadores

É possível usar esta ação em qualquer workflow, incluindo o acionador Horário agendado. Em um workflow que usa o acionador Horário agendado, o workflow é iniciado no horário que você especificou, em vez de como resultado de um evento. Como não há nenhum evento específico em sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.

Detalhes da API

• Recurso de cliente
• Filtros de consulta de cliente

Modelos

Converter um metacampo de cliente em tags para todos os clientes

Este workflow preenche as tags para todos os seus clientes com base em um valor de metacampo. Ele é executado a cada hora e busca até 100 clientes que não tenham a tag “processed”. Para cada cliente, ele analisa o valor de um metacampo custom.test e o adiciona como uma tag. O workflow também adiciona uma tag “processed” para que o cliente não seja retornado na próxima execução agendada do workflow. Para usar o workflow, você precisará alterar o namespace e a chave do metacampo para corresponderem a um metacampo na sua loja. Ver modelo

Excluir clientes inativos

Excluir clientes com mais de 5 anos que nunca fizeram um pedido. Ver modelo