Klaviyo

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

Faça login no Klaviyo

Vá para o painel do Klaviyo.

Abra Configurações

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

Navegue até API Keys

Vá para a seção API Keys.

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

Abra o Shopify Flow

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

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.).

Adicione uma ação Wait

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

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”

Busque por Klaviyo

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

Preencha os campos

Use a tabela abaixo para preencher cada campo.

Campo	Valor
Klaviyo Public API Key	Sua Public API Key da Etapa 1
Event Name	Veja 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 Revize	Nome de Evento Recomendado
Pedido editado	`Revize_Order_Edited`
Endereço de entrega atualizado	`Revize_Address_Updated`
Endereço de e-mail atualizado	`Revize_Email_Updated`
Número de telefone atualizado	`Revize_Phone_Updated`
Data de entrega atualizada	`Revize_Delivery_Date_Updated`
Pedido cancelado	`Revize_Order_Cancelled`
Ticket de suporte criado	`Revize_Support_Ticket`
Nota fiscal gerada	`Revize_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.

Pedido Editado
Endereço / E-mail / Telefone / Data de Entrega
Cancelamento

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.

Use isto para atualizações de endereço de entrega, informações de contato ou data de entrega. Envia o resumo do pedido sem 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}}",
  "currency": "{{single_order.currencyCode}}",
  "updated_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}",
  "shipping_address": "{{single_order.shippingAddress.address1}}, {{single_order.shippingAddress.city}}, {{single_order.shippingAddress.province}} {{single_order.shippingAddress.zip}}, {{single_order.shippingAddress.country}}"
}
{% endfor %}

Use isto para eventos de cancelamento de pedido:

{% 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}}",
  "currency": "{{single_order.currencyCode}}",
  "cancelled_at": "{{single_order.updatedAt}}",
  "customer_email": "{{single_order.customer.email}}",
  "customer_name": "{{single_order.customer.firstName}} {{single_order.customer.lastName}}"
}
{% endfor %}

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

Revise todos os campos

Certifique-se de que tudo está preenchido corretamente.

Ative o workflow

Clique em Turn on workflow no canto superior direito.

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

Crie um novo Flow

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

Defina o gatilho

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

Adicione uma ação de e-mail

Arraste uma ação Email para o flow.

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:

Dado	Variá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:

Abra seu Klaviyo Flow
Adicione um Flow Filter
Defina-o para suprimir se o cliente recebeu este e-mail nos últimos 5 minutos

Solução de problemas

Flow mostra 'Succeeded' mas sem evento no Klaviyo

Verifique se a Public API Key no Shopify Flow corresponde à da sua conta Klaviyo. Este é o problema mais comum.

Evento chega, mas os dados estão vazios

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.

Variante errada aparecendo nos itens de linha

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.

Múltiplos e-mails sendo enviados

Adicione um Flow Filter no Klaviyo para suprimir se o cliente recebeu este e-mail nos últimos 5 minutos.

Onde encontrar a métrica no Klaviyo

Vá para Analytics → Metrics e busque pelo nome do evento (ex.: Revize_Order_Edited). É criado automaticamente na primeira vez que um evento é recebido.

Como verificar se funcionou

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ê.

Começando

Configuração principal

Recursos

Tech Stack

Do que você precisa

Como funciona

Gatilhos disponíveis

Pedido editado

Endereço de entrega atualizado

Endereço de e-mail atualizado

Número de telefone atualizado

Data de entrega atualizada

Pedido cancelado

Ticket de suporte criado

Nota fiscal gerada

Parte 1: Configurar o Shopify Flow

Etapa 1: Encontre sua Public API Key do Klaviyo

Etapa 2: Crie um workflow do Shopify Flow

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

Nomes de evento por gatilho

Etapa 4: Defina as Customer Properties

Etapa 5: Defina as Event Properties

Etapa 6: Ative o workflow

Parte 2: Configurar o e-mail do Klaviyo

Etapa 7: Crie um Klaviyo Flow

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

Exibindo itens de linha

E-mail de exemplo

Evite e-mails duplicados

Solução de problemas

Quer múltiplos gatilhos?

​Do que você precisa

​Como funciona

​Gatilhos disponíveis

Pedido editado

Endereço de entrega atualizado

Endereço de e-mail atualizado

Número de telefone atualizado

Data de entrega atualizada

Pedido cancelado

Ticket de suporte criado

Nota fiscal gerada

​Parte 1: Configurar o Shopify Flow

​Etapa 1: Encontre sua Public API Key do Klaviyo

​Etapa 2: Crie um workflow do Shopify Flow

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

​Nomes de evento por gatilho

​Etapa 4: Defina as Customer Properties

​Etapa 5: Defina as Event Properties

​Etapa 6: Ative o workflow

​Parte 2: Configurar o e-mail do Klaviyo

​Etapa 7: Crie um Klaviyo Flow

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

​Exibindo itens de linha

​E-mail de exemplo

​Evite e-mails duplicados

​Solução de problemas

​Quer múltiplos gatilhos?

Do que você precisa

Como funciona

Gatilhos disponíveis

Parte 1: Configurar o Shopify Flow

Etapa 1: Encontre sua Public API Key do Klaviyo

Etapa 2: Crie um workflow do Shopify Flow

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

Nomes de evento por gatilho

Etapa 4: Defina as Customer Properties

Etapa 5: Defina as Event Properties

Etapa 6: Ative o workflow

Parte 2: Configurar o e-mail do Klaviyo

Etapa 7: Crie um Klaviyo Flow

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

Exibindo itens de linha

E-mail de exemplo

Evite e-mails duplicados

Solução de problemas

Quer múltiplos gatilhos?