Klaviyo

Cosa ti serve

Shopify Flow (disponibile su tutti i piani Shopify)
Un account Klaviyo con la Klaviyo Shopify app installata
Revize installato con i trigger di Shopify Flow abilitati

Preferisci saltare il setup? Possiamo configurare l’intera integrazione Shopify Flow + Klaviyo per te. Reach out.

Come funziona

Revize attiva un trigger Shopify Flow ogni volta che un cliente modifica il suo ordine. Tu colleghi quel trigger all’azione “Track an Event” di Klaviyo, che invia i dati dell’ordine a Klaviyo. Da lì costruisci un Klaviyo Flow per inviare l’email. Trigger Revize → Shopify Flow → evento Klaviyo → email Klaviyo

Trigger disponibili

Puoi inviare email Klaviyo per ognuno di questi trigger Revize:

Order edited — si attiva a ogni modifica dell’ordine, inclusi cambi di prodotto e codici sconto
Shipping address updated
Email address updated
Phone number updated
Delivery date updated
Order cancelled
Support ticket created
Tax invoice generated

Ogni trigger segue lo stesso processo di setup. Cambiano solo il trigger selezionato in Shopify Flow, il nome dell’evento inviato a Klaviyo e le Event Properties.

Parte 1: Configurare Shopify Flow

Passaggio 1: Trova la tua Klaviyo Public API Key

Accedi a Klaviyo

Vai sulla tua dashboard Klaviyo.

Apri Settings

Clicca sul nome del tuo account in basso a sinistra, poi vai su Settings.

Vai su API Keys

Vai nella sezione API Keys.

Copia la Public API Key

Copia la Public API Key (un breve codice alfanumerico). Ti servirà al passaggio 3.

Assicurati di copiare la Public API key, non la Private API key. La public key è quella più corta.

Passaggio 2: Crea un workflow Shopify Flow

Apri Shopify Flow

Nel tuo Shopify Admin vai su Apps → Shopify Flow e clicca su Create workflow.

Seleziona un trigger Revize

Clicca su Select a trigger, cerca Revize e scegli il trigger desiderato (es. Order edited, Shipping address updated, ecc.).

Aggiungi un'azione Wait

Clicca sul + sotto al trigger e aggiungi un’azione Wait. Imposta la durata a 10 secondi.

Aggiungi un'azione Get Order Data

Clicca sul + sotto al Wait e aggiungi un’azione Get Order Data (azione Shopify).Configurala così:

Select a query su Advanced
In Edit query inserisci: id:{{order.legacyResourceId}}
Maximum number of orders a 1
Sort data by su Updated at, Descending

Perché il wait di 10 secondi? Dà all’API di Shopify il tempo di riflettere le ultime modifiche dell’ordine prima di prendere dati freschi. Get Order Data poi recupera line items e varianti corretti e attuali.

Passaggio 3: Aggiungi l’azione Klaviyo “Track an Event”

Cerca Klaviyo

Nella lista delle azioni cerca Klaviyo e seleziona Track an Event.

Compila i campi

Usa la tabella sotto per compilare ogni campo.

Campo	Valore
Klaviyo Public API Key	La tua Public API Key del passaggio 1
Event Name	Vedi la tabella dei nomi evento sotto
Customer Email Address	`{{order.customer.email}}`
Customer First Name	`{{order.customer.firstName}}`
Customer Last Name	`{{order.customer.lastName}}`

Nomi evento per trigger

Usa un nome evento descrittivo per identificare facilmente ogni trigger in Klaviyo:

Trigger Revize	Nome evento consigliato
Order edited	`Revize_Order_Edited`
Shipping address updated	`Revize_Address_Updated`
Email address updated	`Revize_Email_Updated`
Phone number updated	`Revize_Phone_Updated`
Delivery date updated	`Revize_Delivery_Date_Updated`
Order cancelled	`Revize_Order_Cancelled`
Support ticket created	`Revize_Support_Ticket`
Tax invoice generated	`Revize_Tax_Invoice`

Puoi chiamare gli eventi come vuoi. Questi sono solo i nomi consigliati per restare organizzati.

Passaggio 4: Imposta Customer Properties

Nel campo Customer Properties, incolla questo JSON:

{
  "$email": "{{order.customer.email}}",
  "$first_name": "{{order.customer.firstName}}",
  "$last_name": "{{order.customer.lastName}}"
}

Questo dice a Klaviyo a quale profilo cliente associare l’evento.

Passaggio 5: Imposta Event Properties

Nel campo Event Properties incolla il JSON che corrisponde al tuo trigger. Usa i dati ordine appena recuperati da Get Order Data, così Klaviyo riceve sempre i dati corretti.

Order Edited
Address / Email / Phone / Delivery Date
Cancellation

Usa questo quando vuoi inviare i dettagli completi dell’ordine aggiornato, line items inclusi:

{% 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 %}

Non racchiudere le parentesi quadre [ ] dell’array line_items tra virgolette. Le parentesi devono stare fuori da qualsiasi virgoletta perché Klaviyo riceva un vero array.

Usa questo per aggiornamenti di indirizzo di spedizione, contatti o data di consegna. Invia il riepilogo dell’ordine senza line items:

{% 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 %}

Usa questo per gli eventi di annullamento ordine:

{% 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 %}

Il loop {% for single_order in getOrderData %} legge dai dati ordine appena recuperati, non dal trigger originale. Questo garantisce sempre dati corretti.

Passaggio 6: Attiva il workflow

Controlla tutti i campi

Assicurati che sia tutto compilato correttamente.

Attiva il workflow

Clicca su Turn on workflow in alto a destra.

Fatto

Il workflow è attivo. Ogni volta che un cliente attiva quell’azione tramite Revize, l’evento viene inviato a Klaviyo con dati ordine aggiornati.

Parte 2: Configurare l’email Klaviyo

Passaggio 7: Crea un Klaviyo Flow

Crea un nuovo Flow

In Klaviyo vai su Flows → Create Flow e seleziona Build your own.

Imposta il trigger

Per il trigger scegli Metric e cerca il nome evento che hai usato (es. Revize_Order_Edited).

Aggiungi un'azione email

Trascina un’azione Email nel flow.

Progetta il template

Usa le variabili sotto per inserire dinamicamente i dati dell’ordine.

Passaggio 8: Variabili del template email

Usa queste variabili nel tuo template Klaviyo:

Dato	Variabile Klaviyo
Customer Name	`{{ event.customer_name }}`
Order Number	`{{ event.order_name }}`
Subtotal	`{{ event.subtotal_price }}`
Total Tax	`{{ event.total_tax }}`
Shipping	`{{ event.total_shipping }}`
Total Price	`{{ event.total_price }}`
Currency	`{{ event.currency }}`
Edit Date	`{{ event.edited_at }}`
Customer Email	`{{ event.customer_email }}`
Shipping Address	`{{ event.shipping_address }}`

Mostrare i line items

Per mostrare ogni prodotto dell’ordine modificato, usa questo loop nel tuo template Klaviyo:

{% for item in event.line_items %}
  {{ item.title }}
  Variant: {{ item.variant_title }}
  Qty: {{ item.quantity }}
  Price: {{ item.price }}
{% endfor %}

Avvolgi il loop in una tabella o HTML stilizzato nel template Klaviyo per adattarlo al tuo brand.

Esempio di email

Ecco un esempio di oggetto e corpo dell’email:

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 }}

Evitare email duplicate

Se un cliente fa più modifiche rapide nella stessa sessione, Klaviyo potrebbe inviare più email. Per evitarlo:

Apri il tuo Klaviyo Flow
Aggiungi un Flow Filter
Imposta in modo da sopprimere se il cliente ha ricevuto questa email negli ultimi 5 minuti

Risoluzione dei problemi

Il Flow mostra 'Succeeded' ma non c'è alcun evento in Klaviyo

Controlla bene che la Public API Key in Shopify Flow corrisponda a quella nel tuo account Klaviyo. È il problema più frequente.

L'evento arriva ma i dati sono vuoti

Il JSON di Event Properties potrebbe essere non valido. Controlla che non ci siano a capo dentro le stringhe e che line_items usi le parentesi [ ] senza virgolette intorno.

Variante sbagliata nei line items

Assicurati di usare il passaggio Get Order Data con il wait di 10 secondi, e che le tue Event Properties usino il loop getOrderData, non order.lineItems direttamente.

Vengono inviate più email

Aggiungi un Flow Filter in Klaviyo per sopprimere se il cliente ha ricevuto questa email negli ultimi 5 minuti.

Dove trovo la metric in Klaviyo

Vai su Analytics → Metrics e cerca il nome del tuo evento (es. Revize_Order_Edited). Viene creato automaticamente alla prima ricezione.

Come verifico che funzioni

In Klaviyo vai su Audience → Profiles, trova l’email del cliente e controlla la tab Activity per l’evento.

Vuoi più trigger?

Puoi creare workflow Shopify Flow separati per ciascun trigger. Ad esempio:

Workflow 1: Order edited → Revize_Order_Edited → email “Your order has been updated”
Workflow 2: Address updated → Revize_Address_Updated → email “Your shipping address has been changed”
Workflow 3: Order cancelled → Revize_Order_Cancelled → email “Your order has been cancelled”

Ogni workflow segue gli stessi passaggi sopra. Cambia solo il trigger, il nome evento e le Event Properties.

Per iniziare

Setup di base

Funzionalità

Tech Stack

Cosa ti serve

Come funziona

Trigger disponibili

Parte 1: Configurare Shopify Flow

Passaggio 1: Trova la tua Klaviyo Public API Key

Passaggio 2: Crea un workflow Shopify Flow

Passaggio 3: Aggiungi l’azione Klaviyo “Track an Event”

Nomi evento per trigger

Passaggio 4: Imposta Customer Properties

Passaggio 5: Imposta Event Properties

Passaggio 6: Attiva il workflow

Parte 2: Configurare l’email Klaviyo

Passaggio 7: Crea un Klaviyo Flow

Passaggio 8: Variabili del template email

Mostrare i line items

Esempio di email

Evitare email duplicate

Risoluzione dei problemi

Vuoi più trigger?

Per iniziare

Setup di base

Funzionalità

Tech Stack

Documentation Index

​Cosa ti serve

​Come funziona

​Trigger disponibili

​Parte 1: Configurare Shopify Flow

​Passaggio 1: Trova la tua Klaviyo Public API Key

​Passaggio 2: Crea un workflow Shopify Flow

​Passaggio 3: Aggiungi l’azione Klaviyo “Track an Event”

​Nomi evento per trigger

​Passaggio 4: Imposta Customer Properties

​Passaggio 5: Imposta Event Properties

​Passaggio 6: Attiva il workflow

​Parte 2: Configurare l’email Klaviyo

​Passaggio 7: Crea un Klaviyo Flow

​Passaggio 8: Variabili del template email

​Mostrare i line items

​Esempio di email

​Evitare email duplicate

​Risoluzione dei problemi

​Vuoi più trigger?

Cosa ti serve

Come funziona

Trigger disponibili

Parte 1: Configurare Shopify Flow

Passaggio 1: Trova la tua Klaviyo Public API Key

Passaggio 2: Crea un workflow Shopify Flow

Passaggio 3: Aggiungi l’azione Klaviyo “Track an Event”

Nomi evento per trigger

Passaggio 4: Imposta Customer Properties

Passaggio 5: Imposta Event Properties

Passaggio 6: Attiva il workflow

Parte 2: Configurare l’email Klaviyo

Passaggio 7: Crea un Klaviyo Flow

Passaggio 8: Variabili del template email

Mostrare i line items

Esempio di email

Evitare email duplicate

Risoluzione dei problemi

Vuoi più trigger?