# Sesami Flows e Klaviyo
Integra Sesami con Klaviyo per potenziare l'email marketing e l'SMS marketing avanzati per la tua attività di prenotazione.
## 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 offre 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 aziende 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 con tempistica personalizzata)
* Flusso di completamento appuntamento
**Integrazioni combinate:**
* Richiedi recensioni ai clienti con piattaforme di recensioni (Okendo, Yotpo, Trustpilot, ecc.)
* Invita a o monitora programmi fedeltà dopo l'appuntamento (LoyaltyLion, Swell, ecc.)
* Personalizza le email degli appuntamenti (Limespot, Nosto, ecc.)
## Come funziona
Sesami usa **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. Poi crei dei 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 di Sesami si attiva e invia i dati dell'evento a Klaviyo tramite webhook
3. Klaviyo riceve l'evento come metrica personalizzata (ad es. "Sesami Appointment Created")
4. Il Flusso 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 Flusso in Sesami
1. Apri **Sesami** nell'Admin di Shopify
2. Vai a **Impostazioni > Flussi**
3. Fai clic su **Crea un Flusso**
### Passaggio 2: scegli un preset di Klaviyo
Seleziona uno dei 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 quanti Flussi di promemoria vuoi duplicando il preset di promemoria e modificando il momento di attivazione.
{% endhint %}
### 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 Klaviyo Private API Key
{% hint style="warning" %}
**Importante**: A partire dal 12 giugno 2024, i Flussi di Sesami utilizzano la Private API Key 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 una Private API Key**
4. Nominala "Sesami Integration" e scegli **Full Access Key**
5. Copia la Private API Key generata
### 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 Klaviyo Private API Key
3. **Salva** il Flusso
Tutto qui! Ripeti questi passaggi per ogni evento Klaviyo che vuoi inviare a Klaviyo.
## Proprietà evento disponibili
Quando Sesami invia i dati dell'appuntamento a Klaviyo, vengono incluse le seguenti proprietà che puoi utilizzare 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 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 | Luogo del servizio |
| `{{ event.service_image_url }}` | ... | 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 }}` | | 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 }}` | | Link per il cliente per gestire la prenotazione |
| `{{ event.line_item_properties }}` | Coppie Domanda/Risposta | Risposte del modulo personalizzato |
## Configurazione dei Flussi in Klaviyo
Una volta che Sesami invia eventi a Klaviyo, devi creare dei 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**
### Passaggio 2: scegli un trigger Metric
1. Seleziona **Metrica** come tipo di trigger
2. Cerca "Sesami" nel menu a discesa delle metriche
3. Scegli la metrica appropriata:
* **Sesami Appointment Created**
* **Sesami Appointment Rescheduled**
* **Sesami Appointment Canceled**
* **Sesami Appointment Completed**
* **Sesami Appointment Reminder**
### Passaggio 3: aggiungi un'azione Email o SMS
1. Fai clic su **Aggiungi azione**
2. Scegli **Email** o **SMS**
3. Progetta il tuo modello di messaggio
### Passaggio 4: usa le proprietà evento nel tuo modello
Quando modifichi il contenuto della tua email o SMS, puoi accedere a tutte le proprietà relative alla prenotazione utilizzando 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 progettato il messaggio e 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 altre comunicazioni simili sugli 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. Verifica che l'evento appaia in **Activity Feed** o **Metrics**
3. Verifica che tutte le proprietà dell'appuntamento vengano compilate correttamente
4. Testa il tuo Flusso Klaviyo per assicurarti che le email/SMS vengano inviati correttamente
5. Controlla il contenuto per assicurarti che tutte le proprietà dinamiche vengano visualizzate correttamente
{% hint style="success" %}
**Consiglio professionale**: Crea un indirizzo email cliente di prova ed effettua prenotazioni di prova per verificare l'intera esperienza del cliente prima di abilitare i Flussi per i clienti reali.
{% endhint %}
## FAQ
Cosa succede se devo impostare più di un flusso di promemoria?
Puoi creare tutti i flussi di promemoria che vuoi creando nuovi Flussi usando il preset di promemoria di Klaviyo e modificando il momento di attivazione 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
Posso usare Klaviyo sia per gli SMS che per l'email?
Sì! Klaviyo supporta sia email che SMS. Finché hai gli SMS abilitati nel tuo account Klaviyo e hai raccolto i numeri di telefono dei clienti con consenso, puoi usare le azioni SMS nei tuoi Flussi Klaviyo.
Cosa è successo al requisito della chiave API pubblica?
A partire dal 12 giugno 2024, Sesami ha aggiornato tutti i preset di Flusso per usare la Private API Key di Klaviyo invece della chiave pubblica, in linea con i requisiti API aggiornati di Klaviyo. Usa sempre una chiave privata quando configuri nuove integrazioni.
Gli eventi non compaiono in Klaviyo. Cosa dovrei controllare?
* Verifica che la tua Klaviyo Private API Key sia corretta e abbia Full Access
* Assicurati che il Flusso sia abilitato in Sesami
* Controlla di aver effettuato una prenotazione di prova dopo aver configurato il Flusso
* Esamina i log del Flusso di Sesami per vedere se il webhook è stato inviato correttamente
* Controlla l'Activity Feed di Klaviyo per vedere se gli eventi vengono ricevuti
## 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 Klaviyo](/it/apps-integrations/klaviyo.md) - Modelli generali di Klaviyo
* [Email di notifica](/it/notifiche/notification-emails.md) - Sistema di notifiche predefinito di Sesami
---
# Agent Instructions: 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:
```
GET https://help.sesami.co/it/automazioni/sesami-flows-and-klaviyo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.