Strumenti per i profili Customer Agent

Cosa imparerai

Cosa sono gli strumenti per i profili di Customer Agent, cosa fa ciascuno e come utilizzarli nelle competenze. Questi strumenti consentono al tuo agente di leggere e scrivere sul profilo Klaviyo di un acquirente durante una conversazione, in modo da poter personalizzare le risposte, rispondere alle domande "qual è il mio…" e acquisire nuovi dati nel profilo.

I 5 strumenti del profilo

Questi 5 strumenti integrati leggono o scrivono dati nel profilo dell’acquirente autenticato. Puoi aggiungerli alle competenze personalizzate. Alcuni strumenti richiedono di selezionare gli input quando li aggiungi, ad esempio il tipo di evento o la Proprietà del profilo.

Tutti e 5 risolvono automaticamente l’identità dell’acquirente dal contesto della conversazione (il suo e-mail, telefono o ID del profilo). Funzionano solo per acquirenti identificati.

Per visualizzare questi strumenti, vai a Customer Agent > Connettori, quindi seleziona Klaviyo. Puoi aggiungerli a un'abilità personalizzata dall'editor delle abilità.

Quando usarli tutti

Ottieni il profilo

Usalo quando l’agente deve sapere con chi sta parlando: proprietà come nome, preferenze e-mail, l’indirizzo salvato sul suo profilo o qualsiasi proprietà personalizzata che memorizzi.

Esempio: “Ciao Sarah! Vedo che l’indirizzo sul tuo profilo termina con 1234. Lo usiamo di nuovo?”

Get Profile restituisce anche dove si trova l’acquirente: il paese rilevato da Customer Agent per la conversazione e la posizione nel suo profilo. Usalo per gestire la stessa richiesta in modo diverso in base al paese.

Esempio: "Chiama Get Profile per controllare il paese dell’acquirente." "Se il paese è il Canada, spiega che gli ordini vengono spediti dal nostro magazzino di Toronto."

Per limitare un’intera skill o un contenuto a determinati paesi, usa invece le regioni. Consulta Come configurare Customer Agent per più paesi e regioni.

Ottieni gli eventi del profilo

Utilizzare quando l'agente deve sapere cosa ha fatto l'acquirente. Ordini, aperture di e-mail, invii di moduli, visualizzazioni di pagine, iscrizioni: qualsiasi cosa tracciata come evento sul profilo.

Esempi:

• Un acquirente chiede "Quando è stato il mio ultimo ordine?" L'abilità allega Get Profile Events con Tipo di evento = Placed Order e risponde con la data.
• Un acquirente chiede "Che cosa ho aggiunto di recente al carrello?" La skill collega Get Profile Events con Tipo di evento = Added to Cart ed elenca gli articoli.

Quando colleghi lo strumento, scegli il tipo di evento e le altre impostazioni nella barra laterale dello strumento: vedi Configurazione di uno strumento quando lo colleghi qui sotto.

Ottieni elenchi e segmenti dei profili

Usa quando il comportamento dell'agente deve dipendere dal pubblico in cui si trova l'acquirente. Cliente VIP? Sei già nell'elenco dei prodotti nuovamente disponibili? Escluso dalle e-mail promozionali?

Esempio: se l'acquirente si trova nel segmento VIP, l'agente offre un upgrade gratuito su un reso.

Ottieni il riepilogo predittivo del tuo profilo

Usa quando l’acquirente o la competenza ha bisogno degli approfondimenti predittivi di Klaviyo — valore del ciclo di vita del cliente (CLV), rischio di churn (tasso di abbandono) o previsione del prossimo acquisto.

Esempio: un'abilità di fidelizzazione controlla il rischio di abbandono prima di offrire uno sconto: gli acquirenti ad alto rischio ricevono un'offerta più forte.

Le previsioni non sono disponibili per ogni profilo. Indica alla skill cosa fare quando i dati predittivi non sono disponibili, ad esempio continuare senza un’offerta basata sulle previsioni.

Aggiorna la proprietà del profilo

Utilizza il termine che indica quando l'agente deve riscrivere qualcosa sul profilo dell'acquirente durante una conversazione: risposte a quiz, preferenze, feedback, qualsiasi cosa tu abbia acquisito in un modulo.

Esempi:

• Un acquirente risponde a un quiz: “Preferisco profumi terrosi.” → L’agente scrive scent_preference: earthy.
• Un acquirente fornisce un feedback durante un reso: "Non andava bene, vestiva piccolo". → L'agente salva last_return_reason: sizing.

Una volta che una proprietà è sul profilo, ogni altra parte di Klaviyo può usarla: flussi, segmenti, campagne, future conversazioni Customer Agent.

Come utilizzare questi strumenti in un'abilità

Per Aggiorna proprietà del profilo, crea la proprietà personalizzata in Klaviyo prima di aggiungere lo strumento a un’abilità. Ad esempio, impostala su un profilo di test, in modo che sia disponibile nel selettore Proprietà del profilo.

1. Vai a Customer Agent > Competenze e apri una competenza personalizzata, oppure fai clic su Crea competenza. Per una nuova competenza, inserisci il nome e completa Quando usare questa competenza.
2. In Come rispondere, digita / e seleziona uno strumento del profilo dal menu Strumenti.
3. Se si apre la barra laterale di configurazione dello strumento, seleziona gli input richiesti ed eventuali impostazioni facoltative, quindi fai clic su Salva. Consulta Configurare uno strumento quando lo alleghi di seguito. Per modificare queste impostazioni in un secondo momento, fai clic sullo strumento inserito nell’editor. Ripeti i passaggi 2–3 per ogni strumento di cui hai bisogno.
4. Nella sezione Come rispondere, comunica all'abilità quando e come utilizzare ogni strumento. Sii specifico:
   • Quando l'agente deve chiamare lo strumento
   • Cosa dovrebbe fare con il risultato
   • Per Aggiorna proprietà profilo: quale proprietà scrivere, in quale formato deve essere il valore e quando non scrivere
5. Se stai creando una nuova skill, fai clic su Salva come bozza per salvarla e aprirne i dettagli.
6. Rivedi le istruzioni, quindi fai clic su Pubblica per una skill in bozza o su Aggiorna per una skill attiva. In questo modo le modifiche saranno disponibili nelle conversazioni attive.

Configurazione di uno strumento quando lo alleghi

Alcuni strumenti del profilo hanno campi che puoi precompilare per ogni strumento che inserisci. La precompilazione blocca il valore per ogni chiamata a quell’istanza dello strumento, dandoti un controllo più preciso e risparmiando all’agente di doverlo determinare in fase di esecuzione.

L'esempio principale è "Ottieni gli eventi delprofilo". Quando lo associ a una competenza, puoi configurare:

• Tipo di evento (obbligatorio) — quale metrica recuperare (ad esempio Placed Order, Checkout Started, Added to Cart, Opened Email, Viewed Product).
• Limite — il numero massimo di eventi da restituire. Scegli 1, 5, 10, 25 o 50. Il valore predefinito è 10. Per recuperare l’evento più recente, seleziona 1 evento e Più recenti per primi.
• Ordine di ordinamento — Più recenti prima (impostazione predefinita) o Più vecchie prima.
• Finestra diriepilogo: quanto indietro per la ricerca. Impostazione predefinita: 90 giorni.

Ad esempio, una competenza che deve esaminare il carrello più recente dell'acquirente potrebbe allegare Ottieni eventi del profilo con Tipo di evento = Checkout Started, Limite = 1 event, Ordinamento = Newest first, Intervallo di lookback = 30 days. In questo modo, l'agente non deve pensare a queste scelte: sono integrate.

Aggiorna proprietà del profilo richiede di selezionare Proprietà del profilo. Scegli la proprietà personalizzata esistente che lo strumento deve aggiornare, poi fai clic su Salva. In Come rispondere, indica all’agente quali valori salvare e quando salvarli.

Ottieni elenchi e segmenti di profili ti consente di selezionare Tipo di iscrizione per restituire elenchi, segmenti o entrambi. Per impostazione predefinita restituisce entrambi.

Esempio di snippet "Come rispondere" (aggiorna la proprietà del profilo):

Quando chi acquista ti comunica la sua preferenza di profumo, chiama Aggiorna proprietà del profilo per salvarla nella proprietà scent_preference utilizzando uno tra: floral, earthy, citrus, fresh. Scrivi solo se l'acquirente lo conferma esplicitamente. Conferma all'acquirente il salvataggio in un'unica frase solo se lo strumento segnala un esito positivo. Se non riesce, spiega che la preferenza non è stata salvata.

Esempio di snippet "Come rispondere" (Ottieni profilo + Ottieni eventi profilo):

Quando l’acquirente chiede informazioni sui suoi ordini recenti, chiama Get Profile Events per recuperare la cronologia degli ordini. Riassumi le date e i dettagli dell’ordine disponibili registrati in quegli eventi. Se l’acquirente chiede chi è o quali dati sono presenti in archivio, usa Get Profile.

(Allega Recupera eventi del profilo con Tipo di evento = Placed Order, Limite = 5 events, Ordinamento = Dal più recente.)

Consigli

• Leggi prima di scrivere. Se stai personalizzando una risposta, prima allega Ottieni profilo o Ottieni eventi profilo. L'agente non può fare riferimento a dati che non ha estratto.
• La proprietà deve esistere prima e deve essere una proprietà personalizzata. Update Profile Property scrive solo nelle proprietà del profilo personalizzate che esistono già nei profili della tua azienda. I campi di sistema (e-mail, nome, numero di telefono, sottocampi della posizione) e i campi derivati (Created, First Active, $id) non sono modificabili in scrittura. Crea prima la proprietà personalizzata in Klaviyo, poi selezionala in Proprietà del profilo quando configuri lo strumento.
• Vincola il valore impostato durante la scrittura. Indica i valori consentiti nelle istruzioni per l'uso ("uno di: floreale, terroso, agrume, fresco"). Altrimenti l'agente scrive un messaggio di testo gratuito e i tuoi segmenti non corrispondono.
• Comunica all'agente quando non devi scrivere. "Scrivi solo se l'acquirente conferma esplicitamente" evita la sovrascrittura accidentale.
• Conferma la scrittura all’acquirente. Dopo che lo strumento segnala l’operazione riuscita, una breve "Perfetto, l’ho salvato come tua preferenza" chiude il cerchio.
• Fai coincidere lo strumento con la domanda. "Cosa ho acquistato?" → Eventi del profilo. "Sono un VIP?" → Elenchi e segmenti. "Quanto è probabile che io abbandoni?" → Riassunto predittivo.
• Usa Composer per collegare questi elementi. Descrivi quello che vuoi in un inglese semplice e Composer collegherà gli strumenti giusti e preparerà una bozza delle istruzioni della skill da rivedere e pubblicare. Ad esempio: "Voglio che la mia skill di consigli guardi cosa c’era nel carrello dell’acquirente per consigliare qualcosa di simile."
• Usa le aree geografiche prima di diramare in base al paese. Se un'intera skill si applica solo in alcuni Paesi, imposta le regioni nella skill. Usa Ottieni profilo quando una competenza ha bisogno di una piccola differenza in base al paese.

Cosa non fanno questi strumenti

• Non funzionano direttamente sulle conversazioni anonime. In web chat, se l’agente ha bisogno di uno di questi strumenti e il cliente non è identificato, viene chiesto al cliente di accedere prima. Una volta identificato, lo strumento viene eseguito.
• L'aggiornamento della proprietà del profilo non crea nuovi acquirenti. Il profilo deve esistere già.
• La proprietà Aggiorna profilo non scrive eventi. La scrittura di eventi sarà uno strumento separato, presto disponibile.
• Nessuno degli strumenti di lettura modifica i dati. Recuperano solo.

Domande frequenti

Posso scrivere su qualsiasi proprietà con Aggiorna proprietà profilo?

Solo le proprietà del profilo personalizzate (quelle che definisci nei profili, come scent_preference o isMom). I campi di sistema — Email, First Name, $phone_number, i sottocampi della posizione come $locale_country e i campi list-patch come Viewed Items — oggi non sono scrivibili. I campi derivati che il sistema calcola per te (Created, First Active, $id) sono di sola lettura in modo permanente.

Cosa succede se la proprietà non esiste ancora?

La proprietà deve già esistere nel tuo account per comparire nel selettore Proprietà del profilo. Creala prima in Klaviyo (ad esempio impostandola su un profilo di test o tramite un flusso), poi selezionala quando configuri lo strumento. Non è necessario che sia già impostata sul profilo di ogni acquirente.

Un'abilità può chiamare più strumenti del profilo in un solo turno?

Sì. Un'abilità può chiamare qualsiasi combinazione di strumenti del profilo in un'unica risposta: ad esempio, Ottieni profilo e Ottieni eventi profilo insieme per creare un quadro più completo prima di rispondere.

Cosa succede agli acquirenti anonimi?

Nella web chat, se l’agente ha bisogno di uno di questi strumenti e l’acquirente non è identificato, viene richiesto all’acquirente di accedere. Una volta identificato, lo strumento viene eseguito e la conversazione continua.

Questi strumenti sono soggetti alle stesse regole sul consenso applicate al resto di Klaviyo?

Sì. I dati passano attraverso il modello standard di profilo e consenso di Klaviyo. Salvare una preferenza personalizzata con Aggiorna Proprietà del profilo non iscrive chi acquista al marketing.

I prossimi passaggi

• Informazioni sugli strumenti di Customer Agent
• Comprendere le competenze
• Come creare un'abilità completamente personalizzata

Articoli correlati