Agente: Crea il tuo agente WhatsApp

Come creare un agente WhatsApp dal builder, cosa contengono i cinque tab e come pubblicarlo.

Scritto da Product

Ultimo aggiornamento Circa 3 ore fa

Parte 2 — Creare un agente WhatsApp

Un agente WhatsApp è l'assistente AR che risponde in chat, segue i tuoi flussi e può eseguire azioni (prenotare, assegnare a un operatore, taggare il contatto…).

Un agente = un canale. Un agente WhatsApp gestisce solo WhatsApp. Per coprire più canali (es. voce + WhatsApp) crei più agenti e li orchestri, non un unico agente multicanale.

Dove: Dashboard → Agent Builder → si apre la scelta del canale → scegli la card "WhatsApp" → entri nel builder (/dashboard/agent-builder/whatsapp/new).

La struttura del builder: 5 tab

Il builder è a tab. In alto trovi il nome agente (modificabile), l'eventuale badge "Attivo", i pulsanti "Salva" e "Go live". A destra un riquadro riepilogo con pallino 🔴/🟢 per ogni sezione: rosso = manca qualcosa di obbligatorio, verde = completa.

1. Identità

  • Nome agente (obbligatorio per andare live) — es. "Supporto Clienti WA".

  • Descrizione (opzionale, nota interna).

  • Lingue: Lingua principale (obbligatoria) + eventuali Lingue aggiuntive.

  • Stile di conversazione: lunghezza risposte (Breve/Bilanciata/Dettagliata), uso emoji (Nessuna/Leggero/Molte), formattazione (Testo semplice/Strutturato), "una domanda alla volta".

2. Istruzioni

Qui definisci come pensa e parla l'agente. Due modalità:

  • Guidata (default): sezioni compilabili — Identità e ruolo, Contesto, Obiettivo, Casi limite, Guardrail, Comportamento thread (leggere i messaggi recenti, riassumere thread lunghi, evitare domande ripetute, attendere messaggi raggruppati).

  • Avanzata: editor di prompt libero (scrivi/incolli il testo).

  • Parti da un template (opzionale): modelli pronti (Qualificazione lead, Supporto clienti, Prenotazione appuntamento, FAQ) che pre-compilano le sezioni.

  • Base di conoscenza: carichi documenti/URL/FAQ da cui l'agente attinge per rispondere.

3. Azioni

Strumenti che l'agente può usare durante la chat:

  • Prenota appuntamento (integrazione calendario).

  • Strumenti personalizzati (chiamate a tue API REST).

  • Memoria conversazioni (storico del contatto tra voce e WhatsApp).

  • Azioni predefinite (CRM): Assegna a operatore, Aggiungi tag, Chiudi conversazione, Aggiorna contatto — ognuna con la propria configurazione (quando scatta, cosa dire al cliente…).

  • Raccolta dati (opzionale): campi che l'agente deve raccogliere.

4. Flusso

Il flusso è il percorso di conversazione, su una tela a nodi (canvas visuale).

  • Puoi avere più flussi per agente; uno è impostato come predefinito.

  • Aggiungi un flusso da zero o parti da un modello (Prenotazione, Qualificazione lead, Supporto/FAQ, Follow-up).

  • Tipi di nodo principali: Entry (avvio), Opener (messaggio template di apertura per flussi in uscita), Step (messaggi), Branch (condizioni "se l'utente risponde X → vai a…"), Terminali (Handoff / Fine conversazione).

  • Per ogni step: testo del messaggio (supporta {{variabile}}), fino a 3 risposte rapide (pulsanti, max ~20 caratteri l'uno) e azioni collaterali (tag, chiamata a strumento, salto a step, handoff).

  • Il pannello problemi segnala flussi non validi (step irraggiungibili, template mancanti/non approvati) e ti porta direttamente al nodo da correggere.

5. Operatività

  • Buffer di risposta: quanto attende l'agente prima di rispondere (raggruppa i messaggi).

  • Presenza: indicatore "sta scrivendo…" e conferme di lettura.

  • Orari operatore: fasce di disponibilità umana; fuori da quelle risponde l'AI.

  • Fuori dagli orari operatore: silenzio, oppure invio di un template o di un messaggio di testo.

Pubblicare l'agente (Go live)

  1. Completa almeno: Nome, Lingua principale, Istruzioni e seleziona un numero WhatsApp. (Se manca qualcosa, il pulsante lo segnala: es. "Seleziona un numero WhatsApp per andare live".)

  2. Clicca "Go live" in alto a destra. L'agente viene salvato, compilato e attivato: lo stato passa da "Bozza" a "Attivo" e vieni portato alla pagina di dettaglio dell'agente.

  3. Da lì puoi testarlo, vedere le conversazioni e le analitiche. Per modificarlo, rientri nel builder: le modifiche salvate aggiornano l'agente live.

Se esci con modifiche non salvate, l'app te lo chiede: Annulla / Esci senza salvare / Salva ed esci.

Articoli correlati

  • Integrazione: Collega il tuo numero WhatsApp

  • Campagna: Lancia una campagna WhatsApp