> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Usare Klaviyo

Klaviyo può inviare le email e gli SMS dei tuoi abbonamenti con i tuoi modelli e nelle tue lingue, e noi gli comunichiamo cosa è successo. Quando un abbonamento inizia, si rinnova, viene messo in pausa, non riesce o viene annullato, inviamo a Klaviyo un evento con l'abbonamento, i suoi prodotti e le sue date. Il messaggio lo crei tu come flow di Klaviyo.

È utile se il tuo marketing è già su Klaviyo e vuoi che i messaggi degli abbonamenti abbiano lo stesso aspetto e lo stesso tono del resto, oppure se vuoi aggiungere gli SMS ai messaggi degli abbonamenti.

## Collega il tuo account Klaviyo

1. In Klaviyo, vai a **Settings > Account > API keys** e crea una **Private API key**. **Full Access** funziona. Se scegli **Custom**, imposta **Events** su **Full** e **Accounts** su **Read**. Una chiave **Read-Only** non può inviare eventi. Klaviyo non ti permette di cambiare i permessi di una chiave in seguito, quindi se hai scelto quelli sbagliati, crea una nuova chiave.
2. Vai a [**Supr Bundles & Subscriptions > Impostazioni > Integrazioni > Klaviyo**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/klaviyo). Incolla la chiave in **Chiave API privata** e fai clic su **Collega**.

La pagina mostra **Collegato** con il nome del tuo account Klaviyo. Per i tuoi clienti non cambia ancora nulla: continuiamo a inviare tutte le email finché non decidi diversamente.

## Invia prima un evento di prova

In **Prova un evento**, scegli una notifica e un abbonamento, oppure usa il nostro abbonamento di esempio, e fai clic su **Invia evento di prova**.

La prova viene inviata all'email di contatto del tuo negozio, non a un cliente, ed è contrassegnata con `test: true` così puoi escluderla da un flow attivo. Funziona anche mentre continuiamo a inviare noi le email ai tuoi clienti, quindi puoi prima creare i tuoi flow e cambiare il mittente dopo.

Una metrica appare in Klaviyo quando arriva il suo primo evento, ed è a questo che serve la prova. Klaviyo impiega qualche secondo, quindi ricarica la pagina se non la vedi subito.

## Crea un flow per ogni evento

In Klaviyo, crea un flow e scegli una **Metric** come trigger. Ogni notifica arriva come metrica separata:

| Metrica in Klaviyo | Inviata quando |
|---|---|
| Subscription Started | Inizia un abbonamento |
| Subscription Restarted | Un abbonamento viene riattivato |
| Subscription Paused | Un abbonamento viene messo in pausa |
| Subscription Cancelled | Un abbonamento viene annullato |
| Subscription Renewed | Un abbonamento viene rinnovato correttamente |
| Subscription Updated | Un abbonamento viene modificato |
| Subscription Next Order Date Changed | Cambia la data del prossimo ordine |
| Subscription Renewing Soon | Prima del rinnovo di un abbonamento, con l'anticipo che scegli |
| Subscription Price Changed | Cambia il prezzo di un abbonamento |
| Subscription Item Out Of Stock | Un articolo di un rinnovo in arrivo è esaurito |
| Subscription Failed | Un abbonamento non va a buon fine |
| Subscription Payment Failed | Un rinnovo non riesce a causa del pagamento del cliente, che deve sistemare la sua carta |
| Subscription Renewal Failed | Un rinnovo non riesce per un motivo che il cliente non può risolvere |
| Subscription Pause Reminder | Qualche giorno dopo che un abbonamento è stato messo in pausa |
| Subscription Pause Win-Back | A un cliente in pausa viene inviata un'offerta per tornare |
| Subscription Resuming Soon | Qualche giorno prima che un abbonamento in pausa riprenda da solo |
| Subscription Auto Resumed | Un abbonamento in pausa riprende da solo |
| Subscription Auto Cancelled | Un abbonamento in pausa viene annullato dopo il limite di pausa |
| Subscription Win-Back 1, 2 and 3 | 14, 30 e 60 giorni dopo l'annullamento di un abbonamento |
| Subscription Box Revealed | Il contenuto di un box in abbonamento viene svelato, nella data che hai impostato per quel box |

Ogni evento contiene l'abbonamento, i suoi prodotti, i totali, la data del prossimo ordine e un link al portale clienti. Usa i campi nel tuo modello Klaviyo, per esempio `{{ event.customerPortalUrl }}` per il link per gestire l'abbonamento, oppure `{{ event.linesSummary }}` per un elenco leggibile del suo contenuto. Per mostrare ogni prodotto con immagine e prezzo, scorri `event.lines` con un ciclo.

Sono inclusi anche i bundle in abbonamento. Ogni riga di prodotto indica a quale bundle appartiene e se è un prodotto acquistato dal cliente o un premio, così un flow può trattare un omaggio diversamente dalla confezione.

## Scegli chi invia le email ai tuoi clienti

In **Chi invia le email ai tuoi clienti**, scegli una di queste opzioni:

- **Supr Bundles & Subscriptions**: continuiamo a inviare noi tutte le email ai clienti. È l'impostazione predefinita.
- **Klaviyo**: smettiamo di inviare le email ai clienti e inviamo invece gli eventi a Klaviyo.
- **Scegli per ogni notifica**: spunta quelle che deve inviare Klaviyo, e noi continuiamo a inviare le altre.

Fai clic su **Salva**. Quando la modifica affida delle email a Klaviyo, l'app ti chiede di confermare ed elenca le email che non arriveranno più da noi.

**Crea e attiva il flow prima di affidare un'email.** Klaviyo accetta i nostri eventi anche se nessun flow li sta ascoltando, quindi il cliente non riceve nulla finché il flow per quella metrica non è attivo.

Quando un'email passa da Klaviyo, **Impostazioni > Notifiche** mostra accanto **Inviata tramite Klaviyo**, e il suo modello lì non è quello che riceve il cliente. Modifica invece il messaggio in Klaviyo.

### Mantieni le nostre email e invia anche tutti gli eventi

Attiva **Invia a Klaviyo anche gli eventi che non affidiamo**. Continuiamo a inviare noi quelle email, e ognuna arriva anche in Klaviyo come evento, così puoi aggiungere tag ai clienti, creare segmenti o fare un follow up lì. Il cliente riceve la nostra email e quello che invia il tuo flow. Quelle email mostrano **Inviata anche a Klaviyo** in **Impostazioni > Notifiche**.

Un'email ai clienti ha un solo mittente. Se Omnisend invia già un'email, Klaviyo non può inviarla anch'esso, e la pagina ti indica quali. Il mirroring non ne risente: entrambi possono ricevere gli eventi.

## Buono a sapersi

- Ogni email ai clienti ha un solo mittente, noi o Klaviyo. Con **Invia a Klaviyo anche gli eventi che non affidiamo** attivo, un flow che crei su quegli eventi può inviare anche un suo messaggio.
- Le notifiche allo staff e gli interruttori **Inviami una copia via email** continuano comunque ad arrivare da noi.
- Una notifica disattivata in **Impostazioni > Notifiche** è disattivata ovunque, Klaviyo compreso. Attivala prima lì. Vedi [Notifiche](https://supr-bundles-and-subscriptions.crisp.help/it/article/notifications-1ij4sgj/).
- Se Klaviyo rifiuta un evento, per esempio perché la chiave è stata eliminata, inviamo a quel cliente la nostra email, così nessuno resta senza messaggio. La pagina Klaviyo mostra allora **Klaviyo ha rifiutato l'ultimo evento** con un pulsante **Ricontrolla la chiave**.
- Gli eventi che inviamo entrano a far parte del tuo account Klaviyo, che controlli tu. Se un cliente ti chiede di cancellare i suoi dati, rimuovilo in Klaviyo oltre che in Shopify. Cancellarlo in Shopify non lo rimuove da Klaviyo.

## Scollega

Fai clic su **Scollega** nella pagina Klaviyo. Eliminiamo la tua chiave e torniamo a inviare noi le email ai tuoi clienti. Gli eventuali flow di Klaviyo basati su questi eventi smettono di riceverli.