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 cinque strumenti del profilo

Customer Agent offre cinque strumenti integrati per la lettura o la scrittura dei dati sul profilo dell'acquirente autenticato. Non li configuri tu: sono disponibili per sfruttare qualsiasi abilità.

Tutti e cinque risolvono automaticamente l'acquirente dal contesto della conversazione (e-mail, telefono o ID profilo). Funzionano solo per acquirenti identificati.

Puoi trovarli tutti e cinque nella pagina Strumenti di Customer Agent e associarli a qualsiasi competenza dell'editor delle abilità.

Nota: questi strumenti sono in versione beta. Sono disponibili per tutti i brand su Customer Agent (non è richiesta alcuna iscrizione separata), ma la funzionalità è ancora in fase di espansione e potrebbe cambiare.

Quando usarli tutti

Ottieni il profilo

Usa quando l'agente deve sapere a chi sta parlando, proprietà come nome, preferenze e-mail, ultimo indirizzo di spedizione o qualsiasi proprietà personalizzata che hai in negozio.

Esempio: "Ciao Sara! Vedo che il tuo ultimo ordine è stato spedito all'indirizzo che termina con 1234. Dovremmo usarlo di nuovo?"

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 c'era nel mio carrello?" L'abilità allega Get Profile Events con Tipo di evento = Added to Cart e restituisce l'elenco degli 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

Da utilizzare quando l'acquirente o la tua abilità ha bisogno degli approfondimenti predittivi di Klaviyo: valore del ciclo di vita del cliente (CLV), rischio di churn (tasso di abbandono), prossimo acquisto previsto o punteggio di salute del cliente.

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.

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à

1. Apri l'abilità che vuoi aggiornare (o creane una nuova).
2. Nell'editor delle abilità, collega gli strumenti del profilo di cui hai bisogno.
3. Se lo strumento dispone di input di configurazione, compilarli (vedere di seguito).
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

Configurazione di uno strumento quando lo alleghi

Alcuni strumenti per i profili hanno input che puoi precompilare a livello di abilità. Il pre-riempimento blocca il valore per ogni chiamata effettuata dall'abilità, il che ti offre un controllo più stretto e salva l'agente dall'obbligo di scoprirlo 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: numero di eventi recenti da restituire. Usa 1 se hai bisogno solo del più recente.
• Ordinamento: dal più recente al più vecchio.
• 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, Ordinamento = Newest first, Intervallo di lookback = 30 days. In questo modo, l'agente non deve pensare a queste scelte: sono integrate.

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

Quando l'acquirente ti comunica la sua preferenza di fragranza, chiama Aggiorna proprietà del profilo per salvarla nella proprietà scent_preference usando uno di questi: floral, earthy, citrus, fresh. Scrivi solo se l'acquirente conferma esplicitamente. Conferma il salvataggio all'acquirente in un'unica frase.

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

Quando l'acquirente chiede informazioni sui suoi ordini recenti, chiama Get Profile Events (Ottieni eventi profilo) per recuperare la cronologia degli ordini. Riassumi i risultati con la data, il conteggio degli articoli e lo stato attuale. Se l'acquirente chiede chi è o cosa c'è nel file, utilizza Ottieni profilo.

(Allega Get profilo Events con Tipo di evento = Placed Order, Limite = 3, Ordine di ordinamento.)

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 prima esistere e deve essere una proprietà personalizzata. Aggiorna la proprietà del profilo scrive solo le proprietà del profilo personalizzate già esistenti nei profili della tua azienda. I campi di sistema (e-mail, nome, numero di telefono, sottocampi della posizione) e i campi derivati (Creato, Primo attivo, $id) non sono scrivibili. Crea prima la proprietà personalizzata in Klaviyo, quindi punta l'abilità su di essa per nome esatto.
• 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 le comunicazioni scritte all'acquirente. Un breve "Ho capito, l'ho salvato come preferisci" 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 Agent Builder per collegarli. Descrivi ciò che desideri in inglese semplice e Agent Builder allegherà gli strumenti giusti e scriverà le istruzioni per le tue abilità. Ad esempio: "Voglio che la mia competenza in materia di consigli guardi cosa c'era nel carrello dell'acquirente e consigli qualcosa di simile".

Cosa non fanno questi strumenti

• Non lavorano direttamente su conversazioni anonime. Se l'agente vuole chiamare uno di questi strumenti e l'acquirente non viene identificato, all'acquirente viene richiesto di accedere per primo. Una volta identificati, 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?

Lo strumento legge e scrive solo le proprietà già esistenti sui profili. Crea prima la proprietà in Klaviyo (ad esempio, impostala su un profilo di prova o tramite un flusso), quindi indirizza l'abilità verso di essa per nome.

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?

Se l'agente tenta di utilizzare uno di questi strumenti e l'acquirente non viene identificato, all'acquirente viene richiesto di effettuare l'accesso. Una volta identificati, 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 scorrono attraverso il profilo standard e il modello di consenso di Klaviyo.

I prossimi passaggi

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

Articoli correlati