Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.revize.app/llms.txt

Use this file to discover all available pages before exploring further.

Precisa de ajuda para configurar? Nossa equipe pode configurar a integração completa Shopify Flow + Klaviyo para você. Entre em contato conosco e cuidaremos disso.

​
Do que você precisa

  • Shopify Flow (disponível em todos os planos Shopify)
  • Uma conta Klaviyo com o app Klaviyo Shopify instalado
  • Revize instalado com gatilhos do Shopify Flow habilitados

​
Como funciona

O Revize dispara um gatilho do Shopify Flow sempre que um cliente edita o pedido. Você conecta esse gatilho à ação “Track an Event” do Klaviyo, que envia os dados do pedido para o Klaviyo. A partir daí, você cria um Klaviyo Flow para enviar o e-mail. Gatilho Revize → Shopify Flow → Evento Klaviyo → E-mail Klaviyo

​
Gatilhos disponíveis

Você pode enviar e-mails do Klaviyo para qualquer um destes gatilhos do Revize:

Pedido editado

Dispara em qualquer edição de pedido, incluindo alterações de produto e edições de código de desconto.

Endereço de entrega atualizado

Dispara quando um cliente altera o endereço de entrega.

Endereço de e-mail atualizado

Dispara quando um cliente atualiza o endereço de e-mail.

Número de telefone atualizado

Dispara quando um cliente atualiza o número de telefone.

Data de entrega atualizada

Dispara quando um cliente seleciona ou altera uma data de entrega.

Pedido cancelado

Dispara quando um cliente cancela o pedido.

Ticket de suporte criado

Dispara quando um cliente envia uma solicitação de suporte pelo portal.

Nota fiscal gerada

Dispara quando um cliente gera uma nota fiscal para o pedido.
Cada gatilho segue o mesmo processo de configuração. As únicas coisas que mudam são o gatilho que você seleciona no Shopify Flow, o nome do evento que você envia ao Klaviyo e as propriedades do evento.

​
Parte 1: Configurar o Shopify Flow

​
Etapa 1: Encontre sua Public API Key do Klaviyo

1

Faça login no Klaviyo

Vá para o painel do Klaviyo.
2

Abra Configurações

Clique no nome da conta no canto inferior esquerdo, depois vá para Settings.
3

Navegue até API Keys

Vá para a seção API Keys.
4

Copie sua Public API Key

Copie a Public API Key (um código alfanumérico curto). Você precisará disto na Etapa 3.
Certifique-se de copiar a chave Public API, não a Private API. A chave pública é a mais curta.

​
Etapa 2: Crie um workflow do Shopify Flow

1

Abra o Shopify Flow

No seu Admin Shopify, vá para Apps → Shopify Flow e clique em Create workflow.
2

Selecione um gatilho Revize

Clique em Select a trigger, busque por Revize e escolha o gatilho que deseja (ex.: Pedido editado, Endereço de entrega atualizado, etc.).
3

Adicione uma ação Wait

Clique no + abaixo do gatilho e adicione uma ação Wait. Defina a duração para 10 segundos.
4

Adicione uma ação Get Order Data

Clique no + abaixo da etapa Wait e adicione uma ação Get Order Data (ação Shopify).Configure-a da seguinte forma:
  • Defina Select a query como Advanced
  • No campo Edit query, insira: id:{{order.legacyResourceId}}
  • Defina Maximum number of orders como 1
  • Defina Sort data by como Updated at, Descending
Por que a espera de 10 segundos? Dá tempo à API da Shopify para refletir as últimas alterações do pedido antes de buscar dados frescos. A etapa Get Order Data então puxa os itens de linha e variantes atuais corretos.

​
Etapa 3: Adicione a ação Klaviyo “Track an Event”

1

Busque por Klaviyo

Na lista de ações, busque por Klaviyo e selecione Track an Event.
2

Preencha os campos

Use a tabela abaixo para preencher cada campo.
CampoValor
Klaviyo Public API KeySua Public API Key da Etapa 1
Event NameVeja a tabela de nomes de evento abaixo
Customer Email Address{{order.customer.email}}
Customer First Name{{order.customer.firstName}}
Customer Last Name{{order.customer.lastName}}

​
Nomes de evento por gatilho

Use um nome de evento descritivo para que possa identificar cada gatilho no Klaviyo:
Gatilho RevizeNome de Evento Recomendado
Pedido editadoRevize_Order_Edited
Endereço de entrega atualizadoRevize_Address_Updated
Endereço de e-mail atualizadoRevize_Email_Updated
Número de telefone atualizadoRevize_Phone_Updated
Data de entrega atualizadaRevize_Delivery_Date_Updated
Pedido canceladoRevize_Order_Cancelled
Ticket de suporte criadoRevize_Support_Ticket
Nota fiscal geradaRevize_Tax_Invoice
Você pode nomear esses eventos como quiser. Estes são apenas nossos nomes recomendados para manter a organização.

​
Etapa 4: Defina as Customer Properties

No campo Customer Properties, cole o seguinte JSON: 
{
  "$email": "{{order.customer.email}}",
  "$first_name": "{{order.customer.firstName}}",
  "$last_name": "{{order.customer.lastName}}"
}
Isto diz ao Klaviyo a qual perfil de cliente associar o evento.

​
Etapa 5: Defina as Event Properties

No campo Event Properties, cole o JSON que corresponde ao seu gatilho. Isto usa dados de pedido recém-buscados da etapa Get Order Data, então o Klaviyo sempre recebe os dados atuais corretos.
Use isto quando quiser enviar os detalhes completos do pedido atualizado, incluindo itens de linha:
{% for single_order in getOrderData %}
{
  "order_id": "{{single_order.id}}",
  "order_name": "{{single_order.name}}",
  "order_number": "{{single_order.legacyResourceId}}",
  "total_price": "{{single_order.totalPriceSet.shopMoney.amount}}",
  "subtotal_price": "{{single_order.subtotalPriceSet.shopMoney.amount}}",
  "total_tax": "{{single_order.totalTaxSet.shopMoney.amount}}",
  "total_shipping": "{{single_order.totalShippingPriceSet.shopMoney.amount}}",
  "currency": "{{single_order.currencyCode}}",
  "edited_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}",
  "line_items": [{% assign comma = "" %}{% for item in single_order.lineItems %}
    {% if item.currentQuantity != 0 %}{{comma}}
    {"title": {{item.title | json}}, "quantity": {{item.currentQuantity}},
     "price": "{{item.originalUnitPriceSet.shopMoney.amount}}",
     "variant_title": {{item.variantTitle | json}}, "sku": {{item.sku | json}}}
    {% assign comma = "," %}{% endif %}
  {% endfor %}]
}
{% endfor %}
Não envolva os colchetes do array line_items [ ] em aspas. Os colchetes devem estar fora de todas as aspas para que o Klaviyo receba um array adequado.
O loop {% for single_order in getOrderData %} lê dos dados do pedido recém-buscados, não do gatilho original. Isto garante dados corretos toda vez.

​
Etapa 6: Ative o workflow

1

Revise todos os campos

Certifique-se de que tudo está preenchido corretamente.
2

Ative o workflow

Clique em Turn on workflow no canto superior direito.
3

Pronto

O workflow agora está ativo. Toda vez que um cliente dispara essa ação pelo Revize, o evento é enviado ao Klaviyo com dados atualizados do pedido.

​
Parte 2: Configurar o e-mail do Klaviyo

​
Etapa 7: Crie um Klaviyo Flow

1

Crie um novo Flow

No Klaviyo, vá para Flows → Create Flow e selecione Build your own.
2

Defina o gatilho

Para o gatilho, escolha Metric e busque pelo nome do evento que você usou (ex.: Revize_Order_Edited).
3

Adicione uma ação de e-mail

Arraste uma ação Email para o flow.
4

Crie seu modelo

Use as variáveis abaixo para puxar dados do pedido dinamicamente.

​
Etapa 8: Variáveis do modelo de e-mail

Use estas variáveis no seu modelo de e-mail Klaviyo:
DadoVariável Klaviyo
Nome do Cliente{{ event.customer_name }}
Número do Pedido{{ event.order_name }}
Subtotal{{ event.subtotal_price }}
Imposto Total{{ event.total_tax }}
Frete{{ event.total_shipping }}
Preço Total{{ event.total_price }}
Moeda{{ event.currency }}
Data da Edição{{ event.edited_at }}
E-mail do Cliente{{ event.customer_email }}
Endereço de Entrega{{ event.shipping_address }}

​
Exibindo itens de linha

Para exibir cada produto no pedido editado, use este loop no seu modelo de e-mail Klaviyo: 
{% for item in event.line_items %}
  {{ item.title }}
  Variant: {{ item.variant_title }}
  Qty: {{ item.quantity }}
  Price: {{ item.price }}
{% endfor %}
Você pode estilizar este loop com HTML/CSS no seu modelo de e-mail Klaviyo para combinar com sua marca. Por exemplo, coloque-o dentro de uma tabela para um visual de nota fiscal limpo.

​
E-mail de exemplo

Aqui está um exemplo de como o assunto e o corpo do seu e-mail podem ficar: 
Subject: Your order {{ event.order_name }} has been updated

Hi {{ event.customer_name }},

Your order has been updated. Here is your revised summary:

{% for item in event.line_items %}
  {{ item.title }} ({{ item.variant_title }})
  Qty: {{ item.quantity }}  |  Price: {{ item.price }} {{ event.currency }}
{% endfor %}

Total: {{ event.currency }} {{ event.total_price }}

​
Evite e-mails duplicados

Se um cliente faz várias edições rápidas em uma sessão, o Klaviyo pode enviar múltiplos e-mails. Para evitar isto:
  1. Abra seu Klaviyo Flow
  2. Adicione um Flow Filter
  3. Defina-o para suprimir se o cliente recebeu este e-mail nos últimos 5 minutos

​
Solução de problemas

Verifique se a Public API Key no Shopify Flow corresponde à da sua conta Klaviyo. Este é o problema mais comum.
O JSON de Event Properties pode estar inválido. Certifique-se de que não há quebras de linha dentro de valores de string e que line_items usa colchetes [ ] sem aspas ao redor.
Certifique-se de estar usando a etapa Get Order Data com a espera de 10 segundos e que suas Event Properties usam o loop getOrderData, não order.lineItems diretamente.
Adicione um Flow Filter no Klaviyo para suprimir se o cliente recebeu este e-mail nos últimos 5 minutos.
Vá para Analytics → Metrics e busque pelo nome do evento (ex.: Revize_Order_Edited). É criado automaticamente na primeira vez que um evento é recebido.
Vá para Audience → Profiles no Klaviyo, encontre o e-mail do cliente e verifique a aba Activity para o evento.

​
Quer múltiplos gatilhos?

Você pode configurar workflows separados do Shopify Flow para cada gatilho. Por exemplo:
  • Workflow 1: Pedido editado → Revize_Order_Edited → e-mail “Seu pedido foi atualizado”
  • Workflow 2: Endereço atualizado → Revize_Address_Updated → e-mail “Seu endereço de entrega foi alterado”
  • Workflow 3: Pedido cancelado → Revize_Order_Cancelled → e-mail “Seu pedido foi cancelado”
Cada workflow segue os mesmos passos acima. Apenas mude o gatilho, o nome do evento e as propriedades do evento.
Precisa de ajuda? Entre em contato conosco e configuraremos a integração completa Shopify Flow + Klaviyo para você.