Avvio rapido — Prima azione attiva in 5 minuti
🚀 Sei alle prime armi con le azioni? Inizia da qui.
Per avere un agente funzionante rapidamente, segui questi passaggi:
Apri il tuo agente → clicca la scheda Configure → scorri fino ad Azioni → clicca Aggiungi Azione
Seleziona Dati di Contatto — raccoglie il nome e il numero di telefono del chiamante
Scrivi una domanda naturale per ogni campo (es. "Può dirmi il suo nome?")
Clicca Salva
Vai alla scheda Panoramica e avvia una chiamata di prova
Fatto. Il tuo agente può ora acquisire lead. Torna qui per aggiungere altre azioni quando sei pronto.
Cosa sono le Azioni — e perché sono importanti?
Come punto di partenza, il tuo agente Romulus sa solo conversare — accoglie i chiamanti, risponde alle domande e segue il prompt. Ma non riesce a fare nulla di concreto con quello che apprende. Si limita a parlare.
Le azioni cambiano tutto. Danno all'agente la capacità di compiere azioni reali durante la chiamata:
Raccogliere i dati di contatto del chiamante per poterlo ricontattare
Porre domande strutturate e memorizzare le risposte
Trasferire il chiamante a un operatore umano quando necessario
Prenotare un appuntamento reale su un calendario reale — senza alcun intervento umano
In sintesi: il prompt è la personalità e il copione dell'agente. Le azioni sono le sue mani.
Come funziona una chiamata reale con le Azioni
Esempio con una clinica che gestisce prenotazioni:
La chiamata inizia → L'agente saluta → Dati di Contatto acquisisce nome e telefono → Estrai Dati chiede il tipo di servizio → Prenota Appuntamento prenota direttamente sul calendario → Trasferimento di Chiamata trasferisce se urgente
Ogni azione si attiva nel momento giusto della conversazione. È il prompt a indicare all'agente quando eseguire ciascuna azione.
Quando usare ogni Azione
Non è necessario usare tutte le azioni su ogni agente. Usa questa guida per scegliere quelle di cui il tuo agente ha davvero bisogno:
Dati di Contatto — Usala quando vuoi raccogliere nome, email o numero di telefono del chiamante. Esempio: una clinica dentistica raccoglie nome e telefono del paziente ad ogni chiamata.
Estrai Dati — Usala quando hai bisogno di informazioni specifiche per il tuo settore. Esempio: un'azienda di coperture chiede "Che tipo di tetto ha?" e "Quanto è urgente la richiesta?"
Trasferimento di chiamata — Usala quando il chiamante deve parlare con un operatore umano. Esempio: un agente per le chiamate fuori orario trasferisce le emergenze al tecnico reperibile.
Prenota Appuntamento — Usala quando vuoi che l'agente prenoti direttamente su un calendario. Esempio: una clinica wellness permette all'agente di prenotare appuntamenti senza intervento umano.
💡 La maggior parte degli agenti inizia con Dati Contatto + Estrai Dati. Questo copre l'acquisizione e la qualificazione dei lead. Aggiungi Prenota Appuntamento o Trasferisci Chiamata una volta che queste funzionano.
Dove trovare la sezione Azioni
Apri l'agente che vuoi configurare.
Clicca sulla scheda Configura nella navigazione in alto.
Scorri fino alla sezione Azioni.
Clicca Aggiungi Azione per aprire il selettore del tipo di azione.
Apparirà una finestra con quattro tipi di azione. Configurane uno alla volta e testa dopo ogni aggiunta.
Azione 1 — Dati di Contatto
Cosa fa
Raccoglie tre campi di contatto standard — nome, email e numero di telefono. I dati vengono salvati nel record di contatto e sono visibili nel registro chiamate.
Quando usarla
Su quasi ogni agente — se parli con i chiamanti, vuoi sapere chi sono.
Prima di iniziare
Nessun prerequisito. Funziona su qualsiasi agente senza configurazioni aggiuntive.
Come configurarla
Clicca Aggiungi Azione → seleziona Dati di Contatto.
Per ogni campo (Nome, Email, Numero di telefono), scrivi la domanda che l'agente farà. Usa un tono naturale — es. "Può dirmi il suo nome completo?" o "Qual è il numero migliore per contattarla?"
Imposta la Strategia di Risposta: Sostituisci (chiede sempre, anche se i dati esistono) o Imposta se mancante (chiede solo se il campo è vuoto).
Per il campo Nome, aggiungi un Esempio di Risposta (es. "Mario Rossi") per guidare l'agente.
Clicca Salva le modifiche.
Dopo il salvataggio, l'azione Dati di Contatto appare come scheda nella sezione Actions.
💡 Sostituisci o Imposta se mancante? Usa Sostituisci per acquisire nuovi lead. Usa Imposta se mancante per i chiamanti già presenti nel sistema.
⚠️ Errore comune: Scrivere domande robotiche come "Si prega di indicare il proprio nome." Scrivi come l'agente parlerebbe naturalmente — quella domanda viene detta ad alta voce durante la chiamata.
Azione 2 — Estrai dati
Cosa fa
Raccoglie qualsiasi informazione personalizzata tu definisca — oltre a nome, email e telefono. Crei le tue variabili, scrivi le domande e scegli come acquisire le risposte.
Quando usarla
Quando hai bisogno di informazioni specifiche per il settore: tipo di servizio, urgenza, data preferita, come hanno conosciuto l'azienda.
Prima di iniziare
Pensa a quali informazioni il tuo team ha bisogno per qualificare o servire un chiamante. Inizia con 2–3 variabili. Puoi aggiungerne altre in seguito.
Come configurarla
Clicca Aggiungi azione → seleziona Estrai dati.
Assegna un Nome chiaro all'azione (es. "Qualifica Lead", "Raccolta Dettagli Servizio").
Aggiungi una Descrizione che spieghi all'agente lo scopo dell'azione. Questo determinerà come verrà eseguita.
Clicca Aggiungere un elemento di dati per creare la prima variabile.
Imposta il Nome della variabile — etichetta interna, senza spazi (es. "tipo_servizio", "urgenza").
Scrivi Cosa chiedere? — la domanda esatta che l'agente dirà al chiamante.
Scegli il Tipo di risposta adatto alla risposta attesa.
Ripeti i passaggi 4–7 per ogni variabile aggiuntiva.
Clicca Salva le modifiche.
Tipi di risposta
Risposta Libera
Scelta Singola — il chiamante sceglie tra opzioni predefinite
Si o No — risposta binaria
Email — valida come indirizzo email
Numero di Telefono
Data e ora — acquisisce una data e un orario specifici
💡 Esempio reale — azienda di manutenzione condizionatori:
"Si tratta di un problema di riscaldamento o raffreddamento?" → Scelta singola
"Approssimativamente, quanti anni ha il suo impianto?" → Risposta libera
"In questo momento non ha riscaldamento o aria condizionata in casa?" → Si o No
⚠️ Errore comune: Creare troppe variabili in una volta sola. Inizia con 2–3. Troppe domande in una chiamata fanno riagganciare gli interlocutori.
Azione 3 — Trasferimento di chiamata
Cosa fa
Trasferisce il chiamante a un numero di telefono specifico — solitamente un operatore umano, un responsabile o una linea di reparto.
Quando usarla
Escalation di emergenza, passaggio a un commerciale, reclami, o quando il chiamante chiede di parlare con una persona specifica.
Prima di iniziare
Tieni pronto il numero di telefono di destinazione con il prefisso internazionale.
Come configurarla
Clicca + Aggiungi azione → seleziona Trasferimento di chiamata.
Assegna un Nome descrittivo (es. "Trasferimento Emergenza", "Passaggio a Vendite").
Nel campo Descrizione, spiega all'agente esattamente quando eseguire il trasferimento. Questo determinerà come verrà eseguita l'azione.
In Inoltrare a, seleziona Numero di telefono dal menu.
Inserisci il numero di telefono di destinazione con il prefisso internazionale.
Se necessario, inserisci un Interno (facoltativo) (es. 101).
Clicca Salva le modifiche.
💡 La descrizione è fondamentale. Buon esempio: "Trasferisci quando il chiamante menziona una perdita di gas, un'alluvione o un incendio, o chiede esplicitamente di parlare con un operatore." Troppo vago: "Trasferisci quando necessario."
⚠️ Errore comune: Se l'agente non trasferisce al momento giusto, torna al prompt e aggiungi un'istruzione esplicita: "Quando il chiamante chiede di parlare con qualcuno, esegui immediatamente l'azione [Nome Azione Trasferimento]."
Azione 4 — Prenota un appuntamento
Cosa fa
Prenota direttamente su un calendario connesso durante la chiamata — senza alcun intervento umano.
Quando usarla
Qualsiasi azienda che gestisce prenotazioni: cliniche, saloni, professionisti, ristoranti.
Prima di iniziare
✅ Devi connettere un'integrazione calendario prima di configurare questa azione. Calendari supportati: Google Calendar, Calendly, GoHighLevel, Castrum. Vai alla scheda Integrations per connetterne uno prima di procedere.
Come configurarla
Clicca + Aggiungi azione → seleziona Prenota un appuntamento.
Assegna un Nome azione appuntamento chiaro (es. "Prenota Consulenza", "Fissa Intervento").
In Selezionare l'account, scegli l'account calendario connesso.
In Selezionare il calendario, scegli il calendario specifico — nel menu appaiono tutti i calendari di quell'account.
In Elementi dati da estrarre, clicca Aggiungere un elemento di dati per ogni informazione da raccogliere prima della prenotazione (es. data/ora preferita, tipo di appuntamento).
In Dati dell'evento, imposta il Titolo dell'evento. Usa Selezionare la variabile per inserire valori dinamici come {{ Nome }}.
Imposta la Durata dell'appuntamento tramite il cursore.
Aggiungi un Partecipante se necessario — digita {{ per ottenere un elenco delle variabili disponibili.
In Programma di disponibilità, definisci i giorni e gli orari in cui l'agente può prenotare (lunedì, martedì, mercoledì, giovedì, venerdì).
Clicca Salva le modifiche.
💡 Il menu dei calendari mostra TUTTI i calendari dell'account connesso. Se un account GoHighLevel ha cinque calendari, li mostra tutti — scegli quello specifico su cui l'agente deve prenotare. La disponibilità è gestita dal calendario stesso.
⚠️ Errori comuni:
Selezionare il calendario sbagliato — verifica che sia quello che il tuo team controlla.
Dimenticare di connettere un'integrazione prima — vai alla scheda Integrations prima di questo passaggio.
Gestione delle Azioni
Tutte le azioni appaiono come schede nella sezione Azioni. La maggior parte degli agenti ha 2–4 azioni.
Modifica: menu a tre punti → Modifica
Elimina: menu a tre punti → Cancella (permanente)
💡 Dopo aver configurato le azioni, torna al prompt e indica all'agente quando usare ciascuna. Esempio: "Dopo aver raccolto nome e telefono con Dati di Contatto, chiedi il tipo di servizio con l'azione Qualifica Lead. Se il chiamante menziona un'emergenza, esegui immediatamente l'azione Trasferimento Emergenza." Il prompt è dove orchestri tutto in un flusso completo.
Problemi comuni
L'agente non raccoglie informazioni anche se ho configurato l'azione
Il prompt non dice all'agente quando usarla. Vai al prompt e fai riferimento esplicito all'azione per nome.
L'agente chiede le stesse informazioni due volte
Potresti avere campi duplicati in Dati di Contatto e Estrazione Dati. Rimuovi il duplicato. Verifica anche la Strategia di Risposta — Sostituisci vs Imposta se mancante.
Il trasferimento non avviene al momento giusto
La descrizione dell'azione Call Transfer è troppo vaga. Rendila più specifica e rinforza l'istruzione nel prompt.
L'azione di prenotazione non crea appuntamenti
Verifica che l'integrazione calendario sia connessa nella scheda Integrazioni. Controlla che ci sia almeno una variabile Data e Ora nei data items. Avvia una chiamata di prova dalla scheda Panoramica.
Non vedo il mio calendario nel menu Seleziona Calendar
Il menu mostra solo i calendari dell'account connesso. Vai a Integrazioni e verifica che l'account corretto sia connesso e autorizzato.
Passo successivo
Torna al prompt (Configura → Prompt → Modifica) e aggiungi le istruzioni su quando attivare ogni azione.
Avvia una chiamata di prova dalla scheda Panoramica.
Controlla la scheda Chiamate per verificare che i dati siano stati acquisiti correttamente.
Se qualcosa non funziona, consulta la sezione Problemi comuni qui sopra.
Articoli correlati
Come configurare il comportamento del tuo Agente AI tramite il Prompt
Come connettere integrazioni di terze parti
Come creare una Knowledge Base e aggiungere contenuti
Come leggere i registri chiamate e visualizzare i dettagli
Panoramica della scheda Overview e pannello Test del tuo Agente