Collega il tuo account Klaviyo a Goodweek per gestire profili, liste, segmenti, campagne, flussi ed eventi direttamente dal tuo spazio di lavoro AI.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Klaviyo, garantendo l'allineamento con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare a seconda delle autorizzazioni specifiche e dell'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che qualsiasi utente possa vedere e connettere l'integrazione Klaviyo, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione Klaviyo utilizza una chiave API. Non è richiesto alcun flusso OAuth né approvazione a livello di amministratore all'interno di Klaviyo. L'utente che si connette deve generare una chiave API privata dal proprio account Klaviyo.
⚠️ Solo gli utenti con accesso alle chiavi API possono connettersi
In Klaviyo, solo gli utenti con ruolo Owner, Admin o Manager possono creare chiavi API private. Gli utenti standard (Analyst, Viewer o ruoli personalizzati senza accesso API) non possono generare una chiave e non potranno connettersi.
Se un utente standard deve connettersi, chiedi a un Owner o Admin del tuo account Klaviyo di generare una chiave API privata per suo conto e di condividerla in modo sicuro.
Generare una chiave API privata Klaviyo
Prima di connetterti in Goodweek, devi generare una chiave API privata dal tuo account Klaviyo:
Accedi a Klaviyo.
Vai su Impostazioni → Account → Chiavi API.
Scorri fino a Chiavi API private e fai clic su Crea chiave API privata.
Assegna alla chiave un nome descrittivo (ad es. Goodweek).
Seleziona Chiave personalizzata e concedi come minimo l'Accesso completo agli ambiti pertinenti al tuo caso d'uso (Profili, Liste, Segmenti, Campagne, Eventi, Flussi).
Fai clic su Crea e copia subito la chiave: Klaviyo la mostra una sola volta.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova Klaviyo e fai clic su Connetti.
Incolla la tua chiave API privata Klaviyo nel campo previsto.
Fai clic su Connetti per completare la configurazione.
Note importanti
Ogni utente deve connettersi utilizzando la propria chiave API.
La chiave API eredita le autorizzazioni dell'utente che l'ha creata.
Se la chiave API viene revocata o eliminata in Klaviyo, l'integrazione smetterà di funzionare. Genera una nuova chiave e riconnettiti.
Puoi revocare l'accesso di Goodweek in qualsiasi momento eliminando la chiave API da Klaviyo → Impostazioni → Account → Chiavi API → Chiavi API private.
Strumenti disponibili
Strumento | Descrizione | Tipo |
Recupera profili | Recupera un elenco paginato dei profili nell'account Klaviyo. | Lettura |
Recupera profilo | Recupera un profilo Klaviyo specifico tramite il suo ID. | Lettura |
Crea profilo | Crea un nuovo profilo nell'account Klaviyo. | Scrittura |
Aggiorna profilo | Aggiorna gli attributi di un profilo Klaviyo esistente. | Scrittura |
Recupera liste | Recupera tutte le liste nell'account Klaviyo. | Lettura |
Recupera lista | Recupera i dettagli di una lista Klaviyo specifica. | Lettura |
Crea lista | Crea una nuova lista nell'account Klaviyo. | Scrittura |
Aggiungi profili alla lista | Aggiunge profili a una lista Klaviyo tramite ID profilo o indirizzi email. | Scrittura |
Recupera profili della lista | Recupera tutti i profili membri di una lista Klaviyo specifica. | Lettura |
Recupera segmenti | Recupera tutti i segmenti nell'account Klaviyo. | Lettura |
Recupera segmento | Recupera i dettagli di un segmento Klaviyo specifico. | Lettura |
Recupera profili del segmento | Recupera i profili appartenenti a un segmento Klaviyo specifico. | Lettura |
Recupera campagne | Recupera un elenco delle campagne nell'account Klaviyo. | Lettura |
Recupera campagna | Recupera i dettagli di una campagna Klaviyo specifica. | Lettura |
Crea campagna | Crea una nuova campagna in Klaviyo per email o SMS. | Scrittura |
Assegna modello di messaggio campagna | Crea una versione non riutilizzabile di un modello e la assegna a un messaggio di campagna. | Scrittura |
Recupera flussi | Recupera tutti i flussi configurati nell'account Klaviyo. | Lettura |
Recupera flusso | Recupera i dettagli di un flusso Klaviyo specifico. | Lettura |
Recupera azioni del flusso | Recupera le azioni all'interno di un flusso Klaviyo specifico. | Lettura |
Recupera metriche | Recupera tutte le metriche disponibili nell'account Klaviyo. | Lettura |
Recupera metrica | Recupera i dettagli di una metrica Klaviyo specifica. | Lettura |
Crea eventi cliente in blocco | Traccia l'attività dei profili creando più eventi. | Scrittura |
Recupera modelli | Recupera tutti i modelli email nell'account Klaviyo. | Lettura |
Recupera modello | Recupera un modello email specifico. | Lettura |
Crea modello | Crea un nuovo modello email nell'account Klaviyo. | Scrittura |
Elimina lista | Elimina definitivamente una lista Klaviyo. | ⚠️ Distruttivo |
Elimina campagna | Elimina definitivamente una campagna Klaviyo. | ⚠️ Distruttivo |
Elimina modello | Elimina definitivamente un modello email Klaviyo. | ⚠️ Distruttivo |
Casi d'uso
Rivedi e aggiorna i profili su richiesta. Recupera profili specifici tramite email o ID, controlla i loro attributi e appartenenze alle liste e aggiorna i loro dati da Goodweek.
Controlla l'appartenenza a liste e segmenti. Recupera i profili di una lista o segmento specifico da Goodweek per verificare la composizione del pubblico prima di lanciare una campagna.
Rivedi lo stato di campagne e flussi. Estrai i dettagli di una campagna o controlla quali flussi sono attivi nel tuo account da una conversazione Goodweek.
Traccia eventi e monitora le metriche. Accedi alle metriche Klaviyo per verificare quali eventi vengono tracciati e usa questi dati per orientare le decisioni di segmentazione o campagna.
Risoluzione dei problemi
Non riesco a generare una chiave API in Klaviyo
Solo gli utenti Klaviyo con ruoli Owner, Admin o Manager possono creare chiavi API private. Se non hai uno di questi ruoli, chiedi a un Owner o Admin di generare una chiave per tuo conto.
L'integrazione smette di funzionare dopo la connessione
La chiave API potrebbe essere stata eliminata o revocata in Klaviyo. Vai su Klaviyo → Impostazioni → Account → Chiavi API e verifica che la chiave sia ancora attiva. In caso contrario, generane una nuova e riconnettiti in Goodweek.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Klaviyo dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.