Configurare Sondaggi CSAT su un Agente

In questo tutorial preparerai un agente per chiedere soddisfazione alla fine di ogni conversazione e leggere gli aggregati la settimana successiva.

Prerequisiti

Ti serve:

• Un agente WhatsApp o email già attivo (con almeno una conversazione di prova).
• Permessi di modifica sull'agente (ruolo admin o owner).
• ~10 minuti.

Passo 1 — Creare il question set

1. Agenti IA → WhatsApp (o Email) → aprire l'agente.
2. Scheda Impostazioni → CSAT → Nuovo question set.
3. Intro: "Ci aiuti con 2 domande rapide? Anonimo, meno di 1 minuto."
4. Domanda 1:
   • key: satisfaction
   • type: scale_1_5
   • prompt_to_ai: "Chiedi quanto è soddisfatto del servizio (scala 1-5)"
   • required: true
5. Domanda 2:
   • key: would_recommend
   • type: yes_no
   • prompt_to_ai: "Chiedi se ci raccomanderebbe a un collega"
6. Thank-you: "Grazie! Il tuo feedback ci aiuta a migliorare."
7. Salvare → versione 1.

Passo 2 — Attivare csat_enabled

1. Nella stessa scheda Impostazioni, attivare Abilita CSAT.
2. Salvare.

Da ora in poi, ogni conversazione inattiva per il session_timeout_minutes dell'agente (default 30 min) fa partire il sondaggio.

Passo 3 — Testare il flusso

1. Aprire una conversazione di prova con l'agente.
2. Inviare "ciao" e lasciare la conversazione inattiva per più di 30 minuti.
3. L'agente invia intro + domanda 1. Rispondere "4".
4. L'agente formula la domanda 2. Rispondere "sì".
5. L'agente chiude con il thank-you.

La risposta arriva in _csat_responses — la vedi nel dettaglio dell'agente, nella scheda Risposte CSAT.

Passo 4 — Leggere gli aggregati dopo una settimana

Lasciare correre l'agente ~1 settimana per raccogliere 20-50 risposte.

1. Dashboard Analytics → CSAT → filtrare per agente + canale.
2. Controllare:
   • Tasso di risposta: se sotto il 20%, l'intro è probabilmente troppo lunga o le domande troppe.
   • Punteggio medio della domanda 1 (satisfaction).
   • Distribuzione yes/no della domanda 2 — % di utenti che ti raccomanderebbero.

Passo 5 — Iterare

Se il tasso di risposta è basso o le domande non catturano quello che ti serve:

1. Modificare il question set → il sistema crea la versione 2, archivia la v1.
2. Le nuove risposte puntano alla v2; le risposte precedenti rimangono legate alla v1, intatte.
3. Nella dashboard, gli aggregati si separano per versione — confronti evoluzioni senza mescolare dati.

Limiti da ricordare

• Parte solo al timeout di inattività, non al "grazie, ciao" dell'utente. Se le tue conversazioni sono brevi e chiuse, i 30 min di default vanno bene.
• Massimo 10 domande. Oltre, il tasso di risposta crolla.
• Per canale. Se lo stesso team gestisce WhatsApp + email, il question set è per canale — creane uno per ogni canale se vuoi domande diverse.

Vedi features/csat per il riferimento completo e i tipi di domanda disponibili.