Quando seu fluxo começa com um gatilho da Shopify, a SleekFlow pode recuperar informações do evento correspondente, como o e-mail de um cliente, o número de rastreamento de um pedido ou os produtos deixados em um carrinho abandonado. Essas informações são chamadas de variáveis.
Este guia ajudará você a:
- Encontrar a variável certa para o que deseja fazer, por exemplo, enviar o número de rastreamento de um pedido a um cliente.
- Identificar qual gatilho de fluxo é necessário para usar cada variável.
- Entender o que esperar quando uma variável retornar um valor vazio.
Antes de começar
Ao usar variáveis da Shopify, lembre-se do seguinte:
- As variáveis dependem do gatilho: cada gatilho da Shopify disponibiliza um conjunto diferente de variáveis. Por exemplo, as informações de pedidos só ficam disponíveis quando o fluxo começa com um gatilho de pedido da Shopify.
- Uma variável pode estar disponível, mas não ter um valor: a Shopify pode ainda não ter as informações de determinado pedido, cliente ou carrinho abandonado. Nesse caso, a variável estará disponível, mas retornará um valor vazio.
Usando variáveis em uma mensagem
Em um Bloco de Ação "Enviar mensagem", clique no ícone para selecionar uma variável.
As variáveis disponíveis na mensagem são as mesmas disponibilizadas pelo gatilho da Shopify. Se uma variável estiver disponível no seu fluxo, você também poderá usá-la em uma mensagem.
Variáveis de pedidos
Estas variáveis ficam disponíveis quando o fluxo começa com um dos seguintes gatilhos:
- Pedido criado na Shopify
- Pedido atualizado na Shopify
| Informação desejada | Variável a usar | Exemplo |
|---|---|---|
| ID do pedido | order/id |
5723841923 |
| Número de telefone do cliente | order/primary_phone |
+85212345678 |
| E-mail do cliente | order/customer/email |
jane@example.com |
| Produtos do pedido | order/normalized_line_items |
Camiseta azul x 2 |
| Data e hora de criação do pedido | order/created_at |
2026-08-01, 10:15am |
| Data e hora da última atualização do pedido | order/updated_at |
2026-08-03, 9:00am |
| Data e hora de processamento do pedido | order/processed_at |
2026-08-01, 10:16am |
| Data e hora de cancelamento do pedido | order/cancelled_at |
Vazio se não tiver sido cancelado |
| Data e hora de fechamento do pedido | order/closed_at |
Vazio se não tiver sido fechado |
| Método de envio | order/shipping_method |
Envio padrão |
| Transportadora | order/tracking_company |
FedEx |
| Número de rastreamento | order/tracking_number |
1Z999AA10123456784 |
| Link de rastreamento | order/tracking_url |
https://track.example.com/... |
Variáveis de envio e rastreamento
Estas variáveis ficam disponíveis quando o fluxo começa com um dos seguintes gatilhos:
- Pedido criado na Shopify
- Pedido atualizado na Shopify
| Informação desejada | Variável a usar | Exemplo |
|---|---|---|
| Método de envio | order/shipping_method |
Envio padrão |
| Transportadora | order/tracking_company |
FedEx |
| Número de rastreamento | order/tracking_number |
1Z999AA10123456784 |
| Link de rastreamento | order/tracking_url |
https://track.example.com/... |
Essas variáveis funcionam apenas com gatilhos de pedidos. Elas não aparecerão se o fluxo começar com um gatilho de cliente ou de carrinho abandonado.
Observação: as informações de rastreamento podem estar vazias quando um pedido é realizado. Normalmente, a Shopify adiciona a transportadora, o número de rastreamento e o link de rastreamento depois que o pedido é atendido e as informações de envio ficam disponíveis.
Observação: se um pedido for enviado em vários pacotes, a Shopify poderá retornar vários números ou links de rastreamento. Recomendamos enviar uma mensagem de teste para você mesmo antes de enviar aos clientes, para verificar como essas informações serão exibidas.
Variáveis de clientes
Estas variáveis ficam disponíveis quando o fluxo começa com um dos seguintes gatilhos:
- Cliente criado na Shopify
- Cliente atualizado na Shopify
| Informação desejada | Variável a usar | Exemplo |
|---|---|---|
| ID do cliente | customer/id |
7734921 |
| Número de telefone do cliente | customer/primary_phone |
+85212345678 |
| E-mail do cliente | customer/email |
jane@example.com |
| Nome do cliente | customer/first_name |
Jane |
| Sobrenome do cliente | customer/last_name |
Doe |
| Número de telefone do cliente, conforme informado na Shopify | customer/phone |
+85212345678 |
| Data e hora de criação do perfil | customer/created_at |
2026-08-01, 9:00am |
| Data e hora da última atualização do perfil | customer/updated_at |
2026-08-03, 10:16am |
Qual variável de número de telefone devo usar?
Existem duas variáveis de número de telefone do cliente:
-
customer/primary_phone: número de telefone principal do cliente, processado pela SleekFlow. Recomendamos usar esta variável porque é menos provável que ela retorne um valor vazio.
-
customer/phone: número de telefone armazenado diretamente na Shopify.
Para a maioria dos fluxos, recomendamos usar customer/primary_phone.
Variáveis de carrinhos abandonados
Estas variáveis ficam disponíveis quando o fluxo começa com um dos seguintes gatilhos:
- Carrinho abandonado criado
- Carrinho abandonado atualizado
| Informação desejada | Variável a usar | Exemplo |
|---|---|---|
| ID do cliente | checkout/id |
7734921 |
| Número de telefone do cliente | checkout/primary_phone |
+85212345678 |
| E-mail do cliente | checkout/email |
jane@example.com |
| Produtos deixados no carrinho | checkout/normalized_line_items |
Camiseta azul x 1 |
| ID da sessão de checkout | checkout/token |
a1b2c3... |
| ID da sessão do carrinho | checkout/cart_token |
d4e5f6... |
| Método de pagamento | checkout/gateway |
shopify_payments |
| Data e hora de criação do carrinho | checkout/created_at |
2026-08-03, 10:16am |
| Consentimento para receber mensagens de marketing | checkout/buyer_accepts_marketing |
true / false |
Se uma variável não estiver exibindo dados
Se uma variável não exibir nenhuma informação, verifique o seguinte:
- Verifique o gatilho do fluxo: certifique-se de que o gatilho corresponde às informações que você deseja usar. Por exemplo, as informações de rastreamento exigem um gatilho de pedido.
-
Verifique se as informações estão disponíveis na Shopify: algumas variáveis só recebem um valor após a ocorrência de um evento específico. Por exemplo,
order/cancelled_atpermanece vazia até que o pedido seja cancelado, enquanto as informações de rastreamento podem continuar vazias até que o pedido seja atendido.
- Verifique se os dados foram sincronizados com a SleekFlow: acesse as configurações da integração com a Shopify e abra a aba "Sincronização de dados" para confirmar se o pedido ou cliente correspondente foi sincronizado com sucesso.