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

{% hint style="success" %}
**Ci sono due modi per connettere Klaviyo.** Il [App Klaviyo](https://help.sesami.co/it/apps-integrations/klaviyo/klaviyo-app.md) invia eventi di prenotazione senza alcuna chiave API o configurazione webhook. Questa pagina tratta Sesami Flows, che utilizza la tua chiave API Klaviyo e gestisce anche i promemoria prima della visita. Vedi [Klaviyo](https://help.sesami.co/it/apps-integrations/klaviyo.md) per capire quale usare e quando.
{% endhint %}

## Che cos'è Klaviyo?

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

## Perché integrare Sesami con Klaviyo?

Puoi semplificare tutte le interazioni con i clienti inviando i dati degli eventi di Sesami a Klaviyo e attivando tutte le comunicazioni (Email o SMS) tramite Klaviyo. Per molte attività che già utilizzano Klaviyo per inviare conferme d'ordine, messaggi di marketing via SMS e altre comunicazioni, inviare anche le conferme di prenotazione e i promemoria degli appuntamenti 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 in orario personalizzato)
* Flusso di completamento appuntamento

**Integrazioni combinate:**

* Richiedi recensioni ai clienti con piattaforme di recensioni (Okendo, Yotpo, Trustpilot, ecc.)
* Invita o monitora programmi fedeltà 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, registrato, avviato, cancellato o contrassegnato come no-show, Sesami invia quei dati dell'evento a Klaviyo come metrica personalizzata. Quindi crei i Flussi 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 Flusso Sesami si attiva e invia i dati dell'evento a Klaviyo tramite webhook
3. Klaviyo riceve l'evento come metrica personalizzata (ad es. "Appointment Created di Sesami")
4. Il Flusso 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 Flusso in Sesami

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

### Passaggio 2: scegli un preset di Klaviyo

Seleziona tra i preset di Flusso 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 Flussi di promemoria di cui hai bisogno duplicando il preset di promemoria e modificando il timing 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 Flusso

Rivedi le impostazioni generali del Flusso 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**: 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 "Sesami Integration" e scegli **Chiave con 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 Flusso

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

<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 connettere 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 Flusso Klaviyo.

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

L'azione di prova deve corrispondere al trigger del Flusso:

* Appuntamento creato → Crea un nuovo appuntamento di prova.
* Appuntamento riprogrammato → Riprogramma un appuntamento esistente.
* Cliente registrato → Registra il cliente per il suo appuntamento.
* Appuntamento iniziato → Attendi che l'appuntamento inizi.
* Appuntamento cancellato → Cancella un appuntamento esistente.
* No Show → Contrassegna l'appuntamento come No Show.
  {% endhint %}

## Configurare i Flussi in Klaviyo

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

### Passaggio 1: crea un Flusso in Klaviyo

1. Accedi a **Klaviyo**
2. Vai a **Flussi**
3. Fai clic su **Crea flusso** 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
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: utilizza 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 Flusso

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

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

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

## Testare la tua integrazione

Prima di andare live, testa l'integrazione:

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

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

## Proprietà evento disponibili

Quando Sesami invia i dati dell'appuntamento a Klaviyo, le seguenti proprietà sono incluse e 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 tatuaggio                      | Nome del servizio                               |
| `{{ event.service_description }}`      | Ti preghiamo di arrivare 15 minuti prima | 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>E se devo impostare più di un flusso di promemoria?</summary>

Puoi creare tutti i flussi di promemoria che desideri creando nuovi Flussi usando il preset di promemoria di Klaviyo e modificando il timing del trigger nella configurazione del Flusso. 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 che gli SMS. Finché hai abilitato gli SMS nel tuo account Klaviyo e hai raccolto i numeri di telefono dei clienti con consenso, puoi utilizzare le azioni SMS nei tuoi Flussi Klaviyo.

</details>

<details>

<summary>Che fine ha fatto il requisito della chiave API pubblica?</summary>

Dal 12 giugno 2024, Sesami ha aggiornato tutti i preset dei Flussi 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 devo controllare?</summary>

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

</details>

## Correlato

* [Sesami Flows](https://help.sesami.co/it/automazioni/sesami-flows.md) - Panoramica del sistema di automazione di Sesami
* [Azioni Email e Webhook](https://help.sesami.co/it/automazioni/email-and-webhook-as-action-types.md) - Comprendere i tipi di azione
* [Panoramica dell'integrazione con Klaviyo](https://help.sesami.co/it/apps-integrations/klaviyo.md) - Pattern generali di Klaviyo
* [Email di notifica](https://help.sesami.co/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
