
# Onboarding guidato

Quando accedi per la prima volta, una procedura guidata di onboarding a schermo intero ti guida attraverso tutto ciò che serve per lanciare il tuo primo agente AI. La procedura si adatta alla tua attività: ha **fino a 13 passaggi**, ma mostra solo quelli pertinenti in base alle risposte fornite lungo il percorso.

Tutto ciò che inserisci viene salvato in **un unico agente AI**, che esiste dal momento in cui la procedura guidata legge il tuo sito web. Non viene creata alcuna campagna separata a tua insaputa: ciò che costruisci qui è l'agente che continuerai a modificare in seguito nella pagina [Agenti AI](../ai-agents/ai-agents.md).


---

## Come funziona la procedura guidata

La procedura guidata ti accompagna una schermata alla volta, con un indicatore di avanzamento in alto che mostra i tuoi progressi.

- **I passaggi si adattano alle tue scelte.** La visualizzazione dei passaggi per la prenotazione, il calendario o l'importazione dei contatti dipende interamente da ciò che scegli all'inizio del flusso; consulta i passaggi condizionali qui sotto.
- **Puoi tornare indietro.** Usa il pulsante Indietro per tornare a qualsiasi passaggio precedente e modificare le tue risposte.
- **I tuoi progressi vengono salvati.** Se chiudi la procedura guidata e torni più tardi, ti verrà offerto di riprendere esattamente da dove avevi interrotto, oppure puoi ricominciare da capo. Se avevi già avviato la procedura guidata prima dell'arrivo della versione incentrata sull'agente, riprendendo rimarrai nel flusso che avevi iniziato, senza modifiche; ricomincia da capo per ottenere quello più recente.
- **Completare i passaggi fa guadagnare crediti bonus.** Collegare un canale, collegare Google Calendar e alcuni altri passaggi fondamentali aggiungono silenziosamente crediti bonus al saldo del tuo account man mano che li completi, oltre a quanto già incluso nel tuo piano.

---

## I passaggi di onboarding

### In quale settore operi?

Scegli il settore che descrive meglio la tua attività:

- Servizi ad alto valore (Consulenza, Coaching, Servizi B2B)
- Immobiliare
- E-commerce
- Aziende SaaS
- Brand di Social Media
- Istituzioni educative
- Agenzie
- Altri settori

La piattaforma utilizza la tua selezione per adattare le istruzioni dell'agente AI e il resto della procedura guidata al tuo settore.

### Come iniziano solitamente le conversazioni?

Questo passaggio decide se il tuo agente AI debba attendere i messaggi o avviare la conversazione autonomamente:

- **Il mio cliente mi scrive per primo** — ti inviano un DM, un messaggio o compilano un modulo, e la tua AI risponde.
- **Io scrivo al mio cliente per primo** — hai già il loro numero e vuoi che l'AI li contatti.

La tua risposta qui filtra i casi d'uso disponibili nel passaggio successivo: ad esempio, se i clienti ti scrivono per primi, i casi d'uso che richiedono di contattarli per primi (come la riattivazione del database) non verranno proposti, e viceversa.

### Qual è la funzione principale che il tuo agente AI deve svolgere?

Scegli il tuo caso d'uso principale. Questo indica all'AI su cosa concentrarsi:

- **Riattivazione del database** — Coinvolgi nuovamente i clienti passati che non sono più attivi. (Richiede "Io scrivo al mio cliente per primo.")
- **Automazione delle recensioni** — Raccogli automaticamente le recensioni dei clienti. (Richiede "Io scrivo al mio cliente per primo.")
- **Follow-up dei lead** — Coltiva i lead provenienti dalla compilazione di moduli. (Richiede "Io scrivo al mio cliente per primo.")
- **Assistenza clienti** — Supporto automatizzato 24/7 per rispondere alle FAQ. (Richiede "Il mio cliente mi scrive per primo.")
- **Commento a DM** — Invia automaticamente un DM agli utenti che commentano i tuoi post sui social media. (Richiede "Il mio cliente mi scrive per primo.")

Puoi sempre espanderti ad altri casi d'uso in seguito, ma sceglierne uno per iniziare aiuta la piattaforma a impostare la configurazione migliore per te.

### L'AI deve prenotare riunioni per te?

Scegli come vuoi gestire gli appuntamenti:

- **Nessuna prenotazione** — L'IA non cercherà di programmare riunioni.
- **Link di prenotazione esterno** — L'IA condivide il tuo link esistente di Cal.com, Calendly o altro quando è pertinente. Incollerai il link direttamente in questo passaggio.
- **L'IA prenota per me** — L'IA offre slot reali dal tuo calendario e conferma automaticamente, senza alcun lavoro manuale da parte tua.

### Collega Google Calendar (condizionale)

Questo passaggio appare solo se hai scelto **L'IA prenota per me**. Collegare Google Calendar consente alla piattaforma di:

- Vedere i tuoi appuntamenti esistenti ed evitare sovrapposizioni.
- Aggiungere automaticamente nuove prenotazioni al tuo calendario.
- Mantenere tutto sincronizzato in entrambe le direzioni: le modifiche in Google Calendar si riflettono nell'app e viceversa.

Questo passaggio è facoltativo anche quando viene mostrato: puoi saltarlo e collegare Google Calendar in un secondo momento.

### Quando sei disponibile? (condizionale)

Questo passaggio appare solo insieme alla prenotazione tramite IA. Imposta i tuoi orari di lavoro e le finestre di disponibilità in modo che il bot sappia quando sei libero: quali giorni della settimana sei disponibile e i tuoi orari di inizio e fine per ogni giorno.

### Importa i tuoi contatti (condizionale)

Questo passaggio appare solo se hai scelto **Riattivazione database** come caso d'uso. Importa i tuoi contatti esistenti per poter iniziare subito a ricontattarli:

- **Importa da CSV** — Carica un foglio di calcolo di contatti con nomi e numeri di telefono.
- **Aggiungi manualmente** — Inserisci i contatti uno alla volta.

Puoi saltare questo passaggio e aggiungere i contatti in un secondo momento, se preferisci.

### Qual è il tuo sito web?

Inserisci l'URL del tuo sito web e lascia che l'AI faccia il lavoro pesante. **Questo è il passaggio che crea il tuo agente AI**: da qui in poi, tutto ciò che la procedura guidata ti chiede viene salvato su quell'agente. L'AI legge il tuo sito web e automaticamente:

- **Genera le istruzioni del tuo agente IA** su misura per la tua attività, i tuoi prodotti e i tuoi servizi.
- **Crea voci FAQ** basate sulle informazioni trovate sul tuo sito.

Le pagine trovate dal crawler ti vengono mostrate per prime, così puoi selezionare quelle da utilizzare e deselezionare le altre (il selettore contrassegna le pagine consigliate e quelle di cui suggerisce l'esclusione). Puoi anche caricare file qui. Qualsiasi cosa tu scelga diventa la conoscenza del tuo agente (le stesse pagine e file da cui risponderà in seguito), nonché il materiale da cui vengono scritte le istruzioni e le FAQ, e la barra di avanzamento che vedi indica la creazione del tuo agente.

**Hai già aggiunto il tuo sito web in precedenza?** Se il tuo account dispone già di pagine o file nella sua base di conoscenza — da un agente configurato in precedenza o dalla pagina Knowledge Base — questo passaggio offre l'opzione **Usa la mia base di conoscenza esistente** e viene avviato con tale opzione selezionata. Otterrai un elenco di tutto ciò che possiedi già, con tutti gli elementi selezionati; potrai cercarli e deselezionare tutto ciò che questo agente non dovrebbe utilizzare. Nulla viene importato una seconda volta, quindi non ti verrà addebitato alcun costo aggiuntivo e il tuo nuovo agente verrà creato proprio qui a partire da ciò che hai scelto. Se preferisci aggiungere qualcosa di nuovo, passa a **Aggiungi un nuovo sito web o file** e il passaggio funzionerà esattamente come descritto sopra.

Questo ti fa risparmiare molto tempo: invece di scrivere tutto da zero, ottieni un punto di partenza già pronto che puoi rivedere e perfezionare.

Questo passaggio richiede anche la **lingua principale** della tua IA. Inizia con la lingua che utilizzi nell'app, quindi nella maggior parte dei casi puoi lasciarla invariata. Impostala prima di fare clic su Importa: le istruzioni e le FAQ che l'IA scrive per te saranno redatte in questa lingua. Non è un blocco definitivo — il tuo bot risponderà comunque a ogni contatto nella lingua in cui scrive l'utente — e potrai modificarla in seguito nella scheda Istruzioni IA dell'agente.

### Dove ti inviano messaggi i tuoi clienti?

Collega almeno un canale di messaggistica per poter inviare e ricevere messaggi:

- **WhatsApp Business** — Scegli di collegare un numero WhatsApp che già possiedi, oppure ottienine uno nuovo direttamente dalla procedura guidata, quindi seleziona come deve essere collegato: gestito da noi, tramite la nostra app Meta o tramite la tua app Meta. Se hai acquistato un numero in precedenza ma non hai completato la sua registrazione a WhatsApp, il riquadro offre **Completa configurazione** per quello specifico numero invece di ricominciare da capo.
- **WhatsApp Web** — Scansiona un codice QR per collegare il tuo numero WhatsApp. Questa è l'opzione più veloce.
- **SMS** — Collega il tuo numero Twilio per l'invio di messaggi di testo.
- **Facebook e Instagram** — Collega i tuoi account aziendali per gestire i messaggi diretti di Messenger e Instagram.
- **Widget chat sito web** — Crea un widget chat incorporabile per il tuo sito.
- **Telegram, LINE ed Email** — Collega questi canali nello stesso modo in cui faresti in Impostazioni. Se ne hai già collegato uno prima di avviare la procedura guidata, apparirà qui come già collegato.

Scegli il canale utilizzato maggiormente dai tuoi clienti. Potrai aggiungere altri canali in qualsiasi momento: vai su **Impostazioni → Canali → Canali**.

### Incontra il tuo agente AI

Incontra l'agente creato per te nel passaggio precedente, redatto in base al tuo settore, al caso d'uso e al contenuto del sito web, in modo che il bot abbia già un solido punto di partenza per parlare con i tuoi clienti. In questo passaggio scegli anche la **velocità di risposta** dell'AI (quanto velocemente e quanti messaggi invia per turno).

Questo passaggio mostra anche l'impostazione **Informa i contatti che stanno chattando con un'IA**, attiva per impostazione predefinita: la primissima risposta dell'IA a ogni contatto menziona naturalmente che si tratta di un assistente IA, il che ti mantiene in regola con le leggi sulla trasparenza come l'EU AI Act. Quando è attiva, le istruzioni che dicono all'IA di presentarsi come un essere umano o un membro dello staff vengono ignorate. Puoi disattivarla da qui, dalla nota mostrata negli editor delle Istruzioni IA, o in seguito nella scheda Abilità IA — vedi [Trasparenza dell'IA](../ai-automation/ai-bot-setup.md#ai-transparency-telling-contacts-theyre-chatting-with-ai) per sapere cosa significa in termini di conformità.

Rivedi il nome e le istruzioni dell'agente. Il contenuto generato è completamente personalizzabile: modifica tutto ciò che desideri e potrai sempre perfezionarlo in seguito.

Un agente non ha un proprio messaggio di apertura: risponde a ciò che riceve. Quando vuoi iniziare la conversazione, inviando un messaggio a un elenco di contatti con un messaggio di apertura, si tratta di una [Trasmissione](../broadcasts/broadcasts.md), che creerai dopo l'onboarding e indirizzerai a questo stesso agente per le risposte.

### Come deve procedere l'AI con i follow-up?

Configura messaggi di follow-up automatici per i contatti che non rispondono. I follow-up sono uno dei modi più efficaci per ottenere risposte:

- Scegli quanto tempo attendere prima di inviare un follow-up.
- Personalizza il contenuto del messaggio di follow-up.
- Imposta quanti follow-up inviare prima di interrompere.

Questo passaggio è la scheda **Follow-up** del tuo agente, mostrata all'interno della procedura guidata, quindi ciò che imposti qui è esattamente ciò che vedrai (e potrai modificare) sull'agente in seguito. Vedi [Follow-up automatizzati](../ai-automation/follow-ups.md).

### Test e regolazione

È qui che la procedura guidata va oltre una semplice revisione statica. Invece di un riepilogo in sola lettura, questo passaggio inserisce l'editor dell'agente reale nella procedura guidata (le stesse schede che userai dalla pagina Agenti AI), così puoi parlare con il tuo nuovo agente AI prima che entri in contatto con un vero utente:

- **Prova** — chatta con l'agente esattamente come farebbe un contatto.
- **Istruzioni AI** — le istruzioni AI generate dal tuo sito web, modificabili sul posto.
- **FAQ e Conoscenza** — le voci delle FAQ e le pagine generate dal tuo sito web.

Chatta con lui, individua eventuali anomalie, correggile nella scheda pertinente e riprova: lo stesso ciclo di riproduzione trattato in [Chat Playground](../chats/playground.md), ma integrato nell'onboarding. Poiché si tratta delle schede dell'agente, nulla qui è una copia esclusiva della procedura guidata: ogni modifica apportata è una modifica all'agente.

### Tutto pronto

Il completamento della procedura guidata mette al lavoro il tuo agente, in questo ordine:

- Tutto ciò a cui hai risposto lungo il percorso viene salvato sull'agente.
- Ogni canale collegato durante la procedura guidata viene cablato come **Punto di ingresso** per l'agente, in modo che le nuove conversazioni che arrivano lì lo raggiungano. Un canale a cui risponde già un altro agente viene lasciato intatto anziché essere preso in carico: nulla di ciò che hai impostato in precedenza viene reindirizzato silenziosamente.
- Se il tuo caso d'uso è il commento-a-DM, le parole chiave che hai fornito diventano punti di ingresso per i commenti sui tuoi account social.
- Il tuo agente viene impostato come **Attivo** per ultimo, una volta che tutto quanto sopra è a posto, in modo che non vada mai online configurato a metà e tu non possa terminare l'onboarding con un account la cui AI non risponde a nulla.

La procedura guidata ti porta quindi nell'editor del tuo agente, dove puoi continuare a perfezionarlo. La tua [Dashboard](dashboard.md) è dove monitorerai l'attività di messaggistica e i risultati una volta che le conversazioni inizieranno ad arrivare. Vedi [Punti di ingresso](../ai-agents/entry-points.md) per sapere come funziona il routing da qui.

---

## Suggerimenti per un onboarding senza intoppi

- **Tieni a portata di mano l'URL del tuo sito web.** Il passaggio di analisi del sito web ti fa risparmiare più tempo generando automaticamente le istruzioni e le FAQ del tuo agente AI.
- **Stai creando un secondo agente? Riutilizza ciò che hai già.** Nel passaggio relativo al sito web, seleziona **Usa la mia base di conoscenza esistente** invece di aggiungere nuovamente il tuo sito: è istantaneo e non paghi per importare le stesse pagine due volte.
- **Inizia con un canale.** Scegli il canale utilizzato maggiormente dai tuoi clienti. Potrai sempre aggiungerne altri in seguito.
- **Rivedi i contenuti generati dall'AI in Test & Adjust.** Le istruzioni e le FAQ create dal tuo sito web sono un ottimo punto di partenza, ma chattare effettivamente con l'agente prima di terminare ti permette di individuare aspetti che una lettura silenziosa non rivelerebbe.
- **Non pensarci troppo.** Puoi modificare ogni impostazione dopo l'onboarding. L'obiettivo è essere operativi rapidamente, per poi perfezionare il tutto man mano.

---

## Dopo l'onboarding

Una volta completata la procedura guidata, il tuo agente sarà attivo e la tua Dashboard mostrerà le analisi dei messaggi. Da qui puoi:

- Perfezionare le istruzioni e le FAQ del tuo agente IA nella sua pagina sotto [AI Agents](../ai-agents/ai-agents.md).
- Aggiungere altri canali di messaggistica e indirizzarli a questo agente (o a un altro) da [Entry Points](../ai-agents/entry-points.md).
- Creare un secondo agente per un caso d'uso diverso e iniziare a inviare messaggi a elenchi di contatti come [Broadcasts](../broadcasts/broadcasts.md) — vedi [Campaigns Have Moved to Broadcasts & Agents](../moving-from-campaigns.md).
- Invitare i membri del team ad aiutare a gestire le conversazioni.

---

## Prossimi passi

- [Quick Start Guide](quick-start-guide.md) — Una panoramica concisa dell'intero processo di configurazione.
- [Campaigns Have Moved to Broadcasts & Agents](../moving-from-campaigns.md) — come si integrano Agenti, Broadcast e Entry Point.
- [Setting Up Your AI Bot](../ai-automation/ai-bot-setup.md) — Personalizza in dettaglio il comportamento del tuo agente.
- [Your Dashboard](dashboard.md) — Scopri come leggere le tue analisi una volta che sei operativo.
