> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/it/automazioni/sesami-flows-and-klaviyo.md).

# Flussi Sesami e Klaviyo

Integra Sesami con Klaviyo per potenziare il marketing avanzato via email e SMS per la tua attività di prenotazioni.

## Che cos'è Klaviyo?

Klaviyo è una piattaforma di automazione del marketing utilizzata principalmente per l'email marketing e il marketing SMS. In qualità di partner strategici di Sesami, Klaviyo offre potenti strumenti di comunicazione con i clienti per le attività basate su appuntamento.

## Perché integrare Sesami con Klaviyo?

Puoi semplificare tutte le interazioni rivolte ai clienti inviando i dati degli eventi di Sesami a Klaviyo e attivando tutte le comunicazioni (Email o SMS) tramite Klaviyo. Per molte aziende che già utilizzano Klaviyo per inviare conferme d'ordine, messaggi di marketing SMS e altre comunicazioni, inviare anche le conferme di prenotazione e i promemoria appuntamento tramite Klaviyo crea un'esperienza cliente unificata.

### Casi d'uso comuni

**Flussi email e SMS:**

* Flusso di conferma appuntamento
* Flusso di riprogrammazione appuntamento
* Flusso di cancellazione appuntamento
* Flusso di promemoria appuntamento (24 ore prima, o con tempistica personalizzata)
* Flusso di completamento appuntamento

**Integrazioni combinate:**

* Richiedi recensioni ai clienti con piattaforme di recensioni (Okendo, Yotpo, Trustpilot, ecc.)
* Invita a programmi fedeltà o tracciali dopo l'appuntamento (LoyaltyLion, Swell, ecc.)
* Personalizza le email degli appuntamenti (Limespot, Nosto, ecc.)

## Come funziona

Sesami utilizza **Sesami Flows** per inviare eventi di prenotazione a Klaviyo in tempo reale. Quando un appuntamento viene creato, riprogrammato, cancellato o completato, Sesami invia quei dati dell'evento a Klaviyo come metrica personalizzata. Successivamente crei i Flows in Klaviyo che attivano messaggi email o SMS in base a queste metriche.

### Il flusso dei dati

1. Il cliente prenota un appuntamento in Sesami
2. Il Flow di Sesami si attiva e invia i dati dell'evento a Klaviyo tramite webhook
3. Klaviyo riceve l'evento come metrica personalizzata (ad esempio, "Appuntamento creato in Sesami")
4. Il Flow di Klaviyo si attiva in base a quella metrica
5. Il cliente riceve un'email o un SMS con i dettagli dell'appuntamento

## Istruzioni di configurazione

### Passaggio 1: crea un Flow in Sesami

1. Apri il [Portale Admin di Sesami](https://help.sesami.co/admin/sesami-admin-portal)
2. Vai a **Flows**
3. Fai clic su **Crea Flow**

### Passaggio 2: scegli un preset di Klaviyo

Seleziona uno dei preset Flow di Klaviyo disponibili:

* **evento Klaviyo, appuntamento creato**
* **evento Klaviyo, appuntamento riprogrammato**
* **evento Klaviyo, appuntamento cancellato**
* **evento Klaviyo, appuntamento completato**
* **evento Klaviyo, promemoria appuntamento 24 ore prima**

{% hint style="info" %}
Puoi creare tutti i Flow di promemoria necessari duplicando il preset di promemoria e modificando la tempistica del trigger.
{% endhint %}

<figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FuxdHvTIRYlwCWGpBwGIH%2FScreenshot%202026-08-27%20at%2013.33.08.png?alt=media&amp;token=2071f95d-dbf7-4dcf-a786-e0d1c0e5434d" alt=""><figcaption></figcaption></figure>

### Passaggio 3: rivedi le impostazioni del Flow

Rivedi le impostazioni generali del Flow per comprendere le condizioni di attivazione e la configurazione del webhook.

### Passaggio 4: ottieni la tua chiave API privata di Klaviyo

{% hint style="warning" %}
**Importante**: A partire dal 12 giugno 2024, Sesami Flows utilizza la chiave API privata di Klaviyo (non la chiave pubblica). Assicurati di creare una chiave privata.
{% endhint %}

1. Accedi al tuo **account Klaviyo**
2. Vai a **Impostazioni > Chiavi API**
3. Fai clic su **Crea chiave API privata**
4. Nominala "Integrazione Sesami" e scegli **Chiave ad accesso completo**
5. **Copia la chiave API privata generata**

<div><figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJQQrLNJF0Wc1v55x5pw6%2FScreenshot%202026-08-27%20at%2013.37.52.png?alt=media&amp;token=2482f74f-2bd7-416a-b74c-e617cbd40076" alt=""><figcaption></figcaption></figure> <figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FtDaqzIIZt1JaRJaFN2Zo%2FScreenshot%202026-08-27%20at%2013.43.28.png?alt=media&amp;token=bdf7fd77-bbd9-4867-aa5c-dd62512056bf" alt=""><figcaption></figcaption></figure></div>

### Passaggio 5: aggiungi la tua chiave API al Flow

1. Nelle impostazioni del tuo Flow di Sesami, trova il segnaposto `KLAVIYO_PRIVATE_API_KEY`
2. Sostituiscilo con la tua vera chiave API privata di Klaviyo
3. **Salva** il Flow

<figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi5oTyjoqq0PXgNihjLCt%2FScreenshot%202026-08-27%20at%2013.46.46.png?alt=media&amp;token=cf59b1ba-62f8-4910-aef2-a545e114fd05" alt=""><figcaption></figcaption></figure>

### Passaggio 6: crea e testa una prenotazione

1. Crea un appuntamento di prova in Sesami per collegare Sesami con Klaviyo e inviare i dati dell'evento.<br>
2. Una volta completato il test, l'evento corrispondente e le sue proprietà saranno disponibili in Klaviyo. Potrai quindi proseguire con i passaggi successivi della configurazione del Flow di Klaviyo.

{% hint style="info" %}
**Nota:** La creazione di un appuntamento di prova è necessaria per stabilire la connessione tra il Flow di Sesami appena configurato e l'API di Klaviyo.

L'azione di test deve corrispondere al trigger del Flow:

* Appuntamento creato → Crea un nuovo appuntamento di prova.
* Appuntamento riprogrammato → Riprogramma un appuntamento esistente.
* Cliente registrato all'arrivo → Registra il cliente per il suo appuntamento.
* Appuntamento iniziato → Attendi l'inizio dell'appuntamento.
* Appuntamento cancellato → Cancella un appuntamento esistente.
* Nessuna presentazione → Segna l'appuntamento come No Show.
  {% endhint %}

## Configurazione dei Flow in Klaviyo

Una volta che Sesami invia eventi a Klaviyo, devi creare i Flow in Klaviyo per inviare comunicazioni ai clienti.

### Passaggio 1: crea un Flow in Klaviyo

1. Accedi a **Klaviyo**
2. Vai a **Flows**
3. Fai clic su **Crea Flow** e poi **Crea il tuo**

<figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgF1uw6IQslc07hlOzuBD%2FScreenshot%202026-08-27%20at%2014.23.17.png?alt=media&amp;token=daee427d-8831-4abc-979c-0f87e44b10ff" alt=""><figcaption></figcaption></figure>

### Passaggio 2: scegli un trigger Metric

1. Seleziona **Metrica** come tipo di trigger&#x20;
2. Fai clic su API
3. Trova "Sesami" e scegli la metrica appropriata.

<div><figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FdeylxlHLsqqiXcWoO3pb%2FScreenshot%202026-08-27%20at%2014.26.23.png?alt=media&amp;token=8c59d1a1-ec7f-413b-ae5c-b61baf23116c" alt=""><figcaption></figcaption></figure> <figure><img src="https://792414832-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5XGdGYX0ttyeANtcq58A%2FScreenshot%202026-08-27%20at%2014.30.23.png?alt=media&amp;token=c9c3fb06-9ad7-4f05-bc2b-9b6aa25f767f" alt=""><figcaption></figcaption></figure></div>

### Passaggio 3: aggiungi un'azione Email o SMS

1. Fai clic su **Aggiungi azione**
2. Scegli **Email** o **SMS**
3. Progetta il modello del tuo messaggio

### Passaggio 4: usa le proprietà dell'evento nel tuo modello

Quando modifichi il contenuto della tua email o del tuo SMS, puoi accedere a tutte le proprietà relative alla prenotazione usando la sintassi mostrata nella tabella sopra. Ad esempio:

* `{{ event.datetime }}` - Mostra la data e l'ora dell'appuntamento
* `{{ event.service_name }}` - Mostra il nome del servizio
* `{{ event.team_member }}` - Mostra il membro del team assegnato
* `{{ event.customer_management_link }}` - Fornisce un link per consentire ai clienti di riprogrammare o cancellare

### Passaggio 5: rendi attivo il tuo Flow

Una volta progettato il tuo messaggio e testato, imposta il tuo Flow su **Attivo** per iniziare a inviare messaggi automatici.

{% hint style="info" %}
**Contrassegna i tuoi Flow di Klaviyo come transazionali.** Le conferme di prenotazione, i promemoria, gli avvisi di riprogrammazione/cancellazione e le comunicazioni simili sugli appuntamenti sono transazionali, non di marketing. Contrassegnarli come transazionali in Klaviyo garantisce che vengano inviati a tutti i clienti indipendentemente dal consenso al marketing e mantiene pulita la deliverability del marketing.

In Klaviyo, apri l'azione messaggio del Flow, vai su **Opzioni aggiuntive**, e disattiva **Smart Sending** e imposta il tipo di messaggio su **Transazionale**.
{% endhint %}

## Test della tua integrazione

Prima di andare live, testa l'integrazione:

1. Crea una prenotazione di prova in Sesami
2. Verifica che l'evento appaia in **Activity Feed** o **Metriche**
3. Verifica che tutte le proprietà dell'appuntamento vengano compilate correttamente
4. Testa il tuo Flow di Klaviyo per assicurarti che le email/SMS vengano inviati correttamente
5. Rivedi il contenuto per assicurarti che tutte le proprietà dinamiche vengano visualizzate correttamente

{% hint style="success" %}
**Suggerimento**: Crea un indirizzo email cliente di prova e fai prenotazioni di prova per verificare l'intera esperienza del cliente prima di abilitare i Flow per i clienti reali.
{% endhint %}

## Proprietà evento disponibili

Quando Sesami invia i dati dell'appuntamento a Klaviyo, vengono incluse le seguenti proprietà che possono essere utilizzate nei tuoi modelli email o SMS di Klaviyo:

| Proprietà                              | Valore di esempio                              | Descrizione                                     |
| -------------------------------------- | ---------------------------------------------- | ----------------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55                       | ID appuntamento univoco                         |
| `{{ event.datetime }}`                 | 29 luglio 2022 alle 16:30                      | Data e ora dell'appuntamento                    |
| `{{ event.order_id }}`                 | 4447608111157                                  | ID ordine Shopify                               |
| `{{ event.quantity }}`                 | 1                                              | Numero di prenotazioni                          |
| `{{ event.service_name }}`             | Rimozione tatuaggi                             | Nome del servizio                               |
| `{{ event.service_description }}`      | Si prega di arrivare con 15 minuti di anticipo | Istruzioni del servizio                         |
| `{{ event.service_duration }}`         | 30                                             | Durata in minuti                                |
| `{{ event.service_price }}`            | 149                                            | Prezzo del servizio                             |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA                          | Posizione del servizio                          |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>...                  | URL immagine del servizio                       |
| `{{ event.team_member }}`              | David                                          | Nome del membro del team assegnato              |
| `{{ event.team_member_description }}`  | David ha dieci anni di esperienza              | Biografia del membro del team                   |
| `{{ event.team_member_email }}`        | <david@email.com>                              | Email del membro del team                       |
| `{{ event.team_member_phone }}`        | 0000000000                                     | Telefono del membro del team                    |
| `{{ event.variant_title }}`            | 30 minuti                                      | Titolo della variante del prodotto              |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>                     | Link per il cliente per gestire la prenotazione |
| `{{ event.line_item_properties }}`     | Coppie domanda/risposta                        | Risposte del modulo personalizzato              |

## FAQ

<details>

<summary>Cosa succede se devo impostare più di un flusso di promemoria?</summary>

Puoi creare tutti i flussi di promemoria che desideri creando nuovi Flow usando il preset di promemoria di Klaviyo e modificando la tempistica del trigger nella configurazione del Flow. Ad esempio, potresti inviare promemoria a:

* 7 giorni prima dell'appuntamento
* 24 ore prima dell'appuntamento
* 2 ore prima dell'appuntamento

</details>

<details>

<summary>Posso usare Klaviyo anche per gli SMS oltre che per le email?</summary>

Sì! Klaviyo supporta sia le email sia gli SMS. Finché hai gli SMS abilitati nel tuo account Klaviyo e hai raccolto i numeri di telefono dei clienti con il consenso, puoi usare azioni SMS nei tuoi Flow di Klaviyo.

</details>

<details>

<summary>Cosa è successo al requisito della chiave API pubblica?</summary>

A partire dal 12 giugno 2024, Sesami ha aggiornato tutti i preset Flow per utilizzare la chiave API privata di Klaviyo invece della chiave pubblica, in linea con i requisiti API aggiornati di Klaviyo. Usa sempre una chiave privata quando configuri nuove integrazioni.

</details>

<details>

<summary>Gli eventi non compaiono in Klaviyo. Cosa dovrei controllare?</summary>

* Verifica che la tua chiave API privata di Klaviyo sia corretta e abbia l'accesso completo
* Assicurati che il Flow sia abilitato in Sesami
* Controlla di aver effettuato una prenotazione di prova dopo aver configurato il Flow
* Rivedi i log del Flow di Sesami per vedere se il webhook è stato inviato correttamente
* Controlla l'Activity Feed di Klaviyo per vedere se gli eventi vengono ricevuti

</details>

## Correlati

* [Sesami Flows](/it/automazioni/sesami-flows.md) - Panoramica del sistema di automazione di Sesami
* [Azioni Email e Webhook](/it/automazioni/email-and-webhook-as-action-types.md) - Comprendere i tipi di azione
* [Panoramica dell'integrazione con Klaviyo](/it/apps-integrations/klaviyo.md) - Pattern generali di Klaviyo
* [Email di notifica](/it/notifiche/notification-emails.md) - Sistema di notifica predefinito di Sesami


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.sesami.co/it/automazioni/sesami-flows-and-klaviyo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.