How-to

Crea il tuo primo agente AI

Ultimo aggiornamento: 24 ottobre 2026

Un agente in GodSetter è un template riutilizzabile: un system prompt, una voce, un profilo di comportamento — tipicamente uno per nicchia — condiviso da tutti i clienti che serve. Crearne uno richiede pochi minuti e la piattaforma collega il motore vocale al posto tuo: il webhook degli eventi di chiamata e gli strumenti in chiamata (prenotazione appuntamenti, gestione appuntamenti, richiamate) vengono registrati automaticamente alla creazione. Non c'è nulla da configurare lato Retell.

Prima di iniziare

  • Retell è connesso in Connessioni — l'agente viene creato sull'account Retell della tua agenzia. Vedi Connetti Retell.
  • Facoltativo: il tuo CRM è connesso e i sub-account sono importati, se vuoi inserire variabili CRM nel prompt (passo 5). Il form funziona anche senza.

Passo 1 — Apri il form del nuovo agente

Vai su Agenti e clicca Nuovo agente.

Passo 2 — Dai un nome all'agente e scegli la nicchia

Assegna all'agente un Nome riconoscibile (per esempio "Agente fisioterapia Milano") e scrivi la Nicchia che serve. Le nicchie le definisci tu — testo libero fino a 60 caratteri — e il menu a tendina si limita a suggerire quelle che usi già su altri agenti o clienti. È un'etichetta libera per la tua organizzazione: non decide alcun instradamento.

Passo 2b — Scegli la direzione

Lascia In uscita (chiama) per l'agente con cui i workflow del tuo CRM avviano i cicli di chiamate; scegli In entrata (risponde) solo per l'agente che risponde alle richiamate. Di quali richiamate si occupa lo dichiari esplicitamente dopo, nel tab Identità e routing dell'agente (Risponde alle richiamate di): non serve né un numero né una nicchia uguale. Vedi Crea gli agenti in uscita e in entrata.

Passo 2c — Scegli un calendario predefinito (facoltativo)

Nel blocco Calendario predefinito scegli un sub-account di riferimento e uno dei suoi calendari. GodSetter salva il nome del calendario, non il suo id: al momento della chiamata l'agente prenota sul calendario con quel nome nel sub-account del lead. In uno snapshot ogni sub-account ha un calendario con lo stesso nome (spesso un custom value, come il nome del professionista) e un id diverso, quindi una scelta sola copre tutti i clienti — i clienti importati arrivano attivi e senza un calendario proprio. Un calendario impostato su un cliente specifico vince sempre sul predefinito. Puoi cambiarlo o azzerarlo in seguito nel tab Identità e routing; se il nome manca nel sub-account di un cliente, il lead mostra Saltato: nessun calendario invece di essere chiamato.

Passo 2d — Imposta l'apertura della chiamata

La sezione Apertura della chiamata decide due cose: chi parla per primo quando il contatto risponde e cosa dice l'agente per aprire.

Chi parla per primo. L'agente parla appena il contatto risponde — tipico delle chiamate in entrata. Con Il contatto, invece, l'agente aspetta il «Pronto?»; se il contatto resta in silenzio, parla comunque l'agente. Finché non scegli tu, il form segue la direzione impostata sopra: un agente in uscita lascia parlare prima il contatto, uno in entrata apre lui la chiamata. Gli agenti creati prima di questa sezione continuano a comportarsi esattamente come prima, finché non la cambi qui.

Quanto aspettare. Quando parla prima il contatto, il campo Se il contatto resta in silenzio, l'agente parla dopo vuole secondi con i decimali — virgola o punto — da 0,5 a 20 (due secondi di default).

Prima frase dell'agente. O Generata dall'AI dal prompt — l'agente improvvisa l'apertura seguendo il tuo copione — oppure Frase fissa, fino a 1000 caratteri, detta parola per parola. La frase fissa accetta le variabili: clicca nel campo e poi su una chip del pannello variabili (passo 5). Una variabile senza valore viene saltata, mai letta ad alta voce. Se parla prima l'agente, la dice appena il contatto risponde; se parla prima il contatto, la dice solo quando questi resta in silenzio per il tempo impostato — se invece parla, l'agente gli risponde seguendo il prompt. Tornando all'apertura generata, la frase fissa che avevi scritto resta conservata: puoi fare avanti e indietro.

Tutto questo si cambia anche dopo: nell'editor dell'agente la card Apertura della chiamata sta in cima al tab Prompt, con un suo pulsante Salva apertura — salvare l'apertura non crea una nuova versione del prompt. E se cambi la direzione in Identità e routing, il nuovo default viene applicato solo a un'apertura che non hai mai personalizzato; una personalizzata resta come l'hai impostata.

Avviso di registrazione. La stessa card, solo nell'editor, ha Avviso di registrazione (facoltativo): fino a 300 caratteri che l'agente legge subito dopo essersi presentato, tramite {{recording_disclaimer}}. È spento di default — se lo lasci vuoto l'agente non parla mai di registrazione, qualunque cosa dica l'interruttore Recording attivo del cliente (che si limita ad archiviare le registrazioni). Scrivilo nella lingua dell'agente: viene letto così come l'hai scritto, mai tradotto. Lo legge anche il test web, così lo senti prima di andare live.

Passo 3 — Parti da un modello

Sopra il prompt, Parti da un modello riempie l'editor con un copione già pronto: Setter generico, Studio medico o dentistico, Agenzia immobiliare o Palestra o centro benessere. Ognuno apre già la chiamata, fa due o tre domande di qualifica per quella nicchia, risponde alle obiezioni più comuni e dice all'agente quando usare get_free_slots, book_appointment, mark_not_interested e request_callback. I modelli seguono la lingua dell'interfaccia — italiano con l'interfaccia in italiano, inglese negli altri casi — e i placeholder che contengono vengono risolti al momento della chiamata. Modifica tutto quello che vuoi: un modello è un punto di partenza, non una regola. Se l'editor non è vuoto ti viene chiesta conferma prima di sostituire il testo.

Passo 4 — Scrivi il system prompt

Il System prompt è il copione e il regolamento dell'agente: chi è, cosa qualifica, come prenota. I placeholder vengono risolti a ogni chiamata e sono elencati nel pannello variabili sotto Variabili di sistema: {{client_name}}, {{recording_disclaimer}} (l'avviso di registrazione dell'agente, vuoto se spento), più il gruppo di contesto della chiamata — {{current_datetime_local}} (l'ora nel fuso del lead), {{is_recall}}, {{previous_call_summary}}, {{callback_requested}} e {{callback_note}}. I dati del contatto — nome, email, telefono — hanno un gruppo tutto loro, poco sotto (passo 5).

Non devi spiegare come gestire un richiamo, in quale fuso orario parlare o come leggere gli slot del calendario: la piattaforma aggiunge il proprio blocco di contesto al prompt su Retell (aggiornato a ogni chiamata, nella lingua dell'agente) e gli strumenti restituiscono etichette già pronte da leggere. Scrivi la persona, l'obiettivo, le domande di qualifica e le obiezioni.

Crea con AI. Non vuoi partire dalla pagina bianca? Premi Crea con AI sopra l'editor: un breve form in ordine logico — chi chiama chi, lingua, chi sono i contatti, la tua azienda e l'offerta, l'obiettivo, nome e tono dell'assistente, obiezioni e quando riagganciare — e GPT-5.6 Sol scrive tutto il prompt dalle tue risposte, strumenti compresi, senza inventare nulla che tu non abbia scritto. Un agente in entrata può indicare l'agente in uscita di cui risponde alle richiamate: riprende allora i fatti e la voce di quell'agente. Vedi l'anteprima, la ritocchi, e Usa questo prompt lo mette nell'editor.

Rifinisci con AI. L'agente ha degli strumenti in chiamata (cercare gli slot liberi, prenotare, registrare un rifiuto, programmare un ricontatto, riagganciare) e li usa in modo molto più affidabile se il prompt li nomina nei punti giusti. Non devi conoscerne i nomi: collega la tua chiave OpenAI in Connessioni → OpenAI, scrivi il prompt con parole tue e premi Rifinisci con AI sopra l'editor. L'AI restituisce lo stesso prompt con gli strumenti inseriti e la regola dei tre esiti applicata (ogni chiamata finisce con una prenotazione, un rifiuto esplicito o un ricontatto programmato); tu rivedi le righe cambiate e scegli Applica o Scarta. Non viene salvato nulla finché non premi Salva. Le rifiniture girano sul tuo account OpenAI (GPT-5.6 Sol), pochi centesimi l'una. Modifica con AI funziona allo stesso modo per una richiesta precisa: scrivi cosa vuoi cambiare ("accorcia l'apertura", "aggiungi l'obiezione …"), l'AI cambia solo quello e ti mostra le righe toccate.

Passo 5 — Inserisci le variabili CRM (facoltativo)

Il pannello delle variabili — Variabili di sistema in alto, Variabili GHL sotto — ti permette di portare dati reali dentro il copione. Su desktop sta in una colonna accanto al prompt e resta in vista mentre scorri, così non devi più risalire in cima per inserirne una; su telefono sta sopra il prompt.

In cima alla card GHL trovi sempre i Campi standard del contatto — nessun sub-account da scegliere, niente da cercare: Nome, Cognome, Nome completo, Email e Telefono inseriscono {{lead_first_name}}, {{lead_last_name}}, {{lead_full_name}}, {{lead_email}} e {{lead_phone}}. Li compila GodSetter a ogni chiamata con i dati del contatto — in uscita, in entrata e nel test dal browser — e un valore che non ha diventa una stringa vuota, mai testo grezzo. Il nome completo del lead viene diviso per te: la prima parola è il nome, il resto è il cognome.

Tutto il resto sta in un sub-account. Scegli un Sub-account di riferimento (il campo di ricerca filtra per nome — gli account che provengono dallo stesso snapshot condividono le stesse variabili), poi scrivi nel campo di ricerca delle variabili (nome o chiave) e clicca una chip corrispondente per inserire una variabile {{cv_*}} nel punto in cui si trova il cursore. Non viene elencato nulla finché non cerchi, e i risultati arrivano in due gruppi: Custom values (le costanti del sub-account) e Campi personalizzati del contatto (per singolo lead, popolati dal workflow che fa scattare la chiamata).

La chip finisce nel campo in cui hai cliccato per ultimo — il prompt oppure la frase fissa di apertura del passo 2d — e in cima al pannello c'è scritto quale: Le variabili vanno in: …. Al momento della chiamata ogni variabile viene risolta sul sub-account a cui il lead appartiene davvero. Approfondimento in Usa i custom values del CRM nei prompt.

Passo 6 — Scegli la voce e il modello LLM

L'elenco delle voci viene caricato dal vivo dal tuo account Retell — comprese le voci ElevenLabs se lì usi la tua chiave. Filtra l'elenco, usa Anteprima voce per ascoltare, poi scegli il Modello LLM e la Lingua (default: Inglese US).

Ogni modello dell'elenco porta con sé il $/min di Retell, e una riga sotto il selettore stima il costo al minuto e la latenza attesa per la voce e il modello che hai appena scelto — prima ancora di creare qualcosa. Le sezioni Retell più fini (comportamento, ambiente audio, timing, trascrizione, privacy, avanzate) sono chiuse per default: aprine una solo quando vuoi cambiare qualcosa; un badge "N personalizzati" sull'intestazione ti dice cosa è già personalizzato. Tutto quanto sta qui è modificabile in seguito — vedi Impostazioni di voce, lingua e comportamento.

Passo 7 — Crea l'agente

Clicca Crea agente. GodSetter crea l'agente vocale sul tuo account Retell e registra automaticamente il suo webhook degli eventi di chiamata e i suoi strumenti in chiamata. Atterri direttamente nell'editor del nuovo agente, con un banner che propone le due mosse successive: Assegna un numero e Provalo ora.

L'intestazione dell'editor porta anche l'interruttore Attivo: mettilo in pausa da lì quando vuoi che smetta di chiamare e rispondere senza toccare numeri o prompt; lo riattivi allo stesso modo. Le chiamate in coda aspettano mentre è in pausa.

Dopo la creazione

Un agente appena creato non può ancora chiamare: non ha nessun numero assegnato, e l'assegnazione dei numeri è fail-closed per scelta. Restano due configurazioni brevi:

  1. Assegna numeri di telefono a un agente — senza questo passaggio l'agente non chiama mai.
  2. Collega il workflow del CRM all'agente — così i nuovi lead attivano le chiamate.

Poi apri l'agente e leggi la striscia Pre-flight in cima all'editor: dice in una riga se l'agente è pronto a chiamare, funziona con limiti oppure le chiamate falliranno — connessione Retell e CRM, tool calendario registrati, numeri assegnati e registrati su Retell, clienti con calendario (il proprio o il calendario predefinito dell'agente), fascia oraria, agente attivo. Il controllo del calendario conta solo i clienti serviti da questo agente — quelli collegati a lui nella pagina del cliente o già chiamati da lui, chiamate in entrata comprese; finché non ne serve nessuno conta tutti i clienti dell'agenzia, e lo dice. Assegnare un numero non basta: un numero che Retell non conosce non può né chiamare né ricevere.

Puoi però già ascoltare l'agente, senza alcuna configurazione: testalo dal browser.