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

Só precisa de alterações de endereço e edições pagas? No plano Pro, você pode conectar o Klaviyo diretamente em Integrations no app Revize, sem o Shopify Flow. O Revize então envia um evento Revize - Address Changed quando um cliente altera o endereço de entrega e um evento Revize - Order Updated quando um pedido editado é pago. Use a configuração com o Shopify Flow abaixo para qualquer outro gatilho ou para dados de evento personalizados. Veja Integrações nativas.

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.

Método de envio atualizado

Dispara quando um cliente altera o método de envio.

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.

Nota personalizada adicionada

Dispara quando um cliente adiciona uma nota personalizada ao pedido.

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`
Método de envio atualizado	`Revize_Shipping_Method_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`
Nota personalizada adicionada	`Revize_Custom_Note_Added`
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, método de envio, informações de contato, data de entrega ou nota personalizada. 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

Método de envio atualizado

Endereço de e-mail atualizado

Número de telefone atualizado

Data de entrega atualizada

Nota personalizada adicionada

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

Método de envio atualizado

Endereço de e-mail atualizado

Número de telefone atualizado

Data de entrega atualizada

Nota personalizada adicionada

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?