> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whappy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Funnel

> Costruisci la conversazione che il tuo assistente segue, passo dopo passo

Il **Funnel** è la conversazione che il tuo assistente segue, passo dopo passo: il primo messaggio, le domande, le diramazioni e come finisce. Lo costruisci su una tela, come step uniti da collegamenti.

Una [campagna per clienti esistenti](https://docs.whappy.ai/it/campaign/client-campaigns.md) non ha la pagina Funnel: le sue conversazioni vengono generate dalle tue offerte.

## L'editor

* **Aggiungi nodo** (in alto a sinistra) apre gli step, raggruppati in **Conversazione**, **Media**, **Logica**, **Azioni** e **Fine**. Un nuovo step compare al centro della tela, ancora scollegato.
* **Collega** gli step trascinando dal fondo di uno step alla cima del successivo. Una Condizione ha un'uscita **Vero** e una **Falso**; un test A/B ha un'uscita **A** e una **B**.
* **Clicca un collegamento** per eliminarlo.
* **Clicca uno step** per aprirne le impostazioni di lato. **Elimina passaggio** lo rimuove al prossimo salvataggio. Eliminare una Condizione elimina anche gli step del suo ramo Falso.
* **Chiudi ogni percorso** con uno step Chiudi.

La barra in fondo ha **Salva modifiche**, un'etichetta con ciò che manca ancora alla campagna (per esempio *2 cose da sistemare*) e **Genera dal contesto**.

### Genera dal contesto

**Genera dal contesto** progetta un flusso intero dal tuo [Contesto aziendale](https://docs.whappy.ai/it/campaign/context.md). Se sulla tela c'è già un flusso, o ci sono modifiche non salvate, chiede prima **Sostituire il flusso sulla tela?** Il flusso generato è un'anteprima: controllalo, poi premi **Salva modifiche** per tenerlo o **Scarta** per tornare indietro. L'anteprima avvisa se alcuni rami non terminano ancora con uno step Chiudi.

### Problemi del funnel

Quando manca qualcosa, un badge **Problemi del funnel** sulla tela lo elenca: uno step non configurato o non salvato, oppure uno step di chiusura mancante. Uno step a cui manca ancora qualcosa è segnalato sulla tela.

## Gli step

### Template WhatsApp (inizio)

Ogni funnel parte da qui. Su WhatsApp è il primo messaggio a un nuovo lead.

* **Account WhatsApp Business**: il numero da cui parte il primo messaggio.
* **Template**: uno dei template approvati di quel numero, con l'anteprima. WhatsApp ammette solo un template approvato come primo messaggio. I template si gestiscono in [Integrazioni → WhatsApp](https://docs.whappy.ai/it/integrations/whatsapp.md).
* **Primo messaggio per le conversazioni di prova**: ciò che le conversazioni di prova mostrano come primo messaggio. I lead reali ricevono il template.

In una campagna che parla solo su Instagram lo step si chiama **Inizia su Instagram**: chi ti scrive parte da qui e non c'è un primo messaggio. In una campagna che parla su entrambi i canali, il template arriva solo ai lead che aggiungi o importi, su WhatsApp; chi scrive su Instagram lo salta. Vedi [Canale](https://docs.whappy.ai/it/campaign/channel.md).

### Chiedi informazioni

Chiede al lead uno dei tuoi campi [Info](https://docs.whappy.ai/it/campaign/info.md). Scegli il campo; l'assistente lo chiede con parole sue. Un campo obbligatorio viene richiesto finché non c'è risposta; uno facoltativo viene chiesto una volta.

### Conversa

Dice qualcosa al lead. Scrivi le **Istruzioni**: l'assistente le usa come linea guida, non come copione. Spunta **Attendi la risposta del lead** per aspettare una risposta prima di proseguire.

### Agente di supporto

Risponde alle domande del lead, in base alle tue istruzioni e al tuo [Contesto](https://docs.whappy.ai/it/campaign/context.md).

* **Istruzioni**: come l'assistente deve aiutare.
* **Condizione di uscita (opzionale)**: una domanda sì/no. Lo step termina quando l'assistente ritiene che la risposta sia sì.

### Invia documento

Invia PDF o immagini dalle tue [Risorse](https://docs.whappy.ai/it/campaign/assets.md).

* **File da inviare**: fino a 5 per step, inviati nell'ordine mostrato. PDF fino a 16 MB, JPEG e PNG fino a 5 MB.
* **Messaggio (facoltativo)**: inviato solo con il primo file.
* **Attendi la risposta del lead prima di continuare**.

Il lead li riceve come file su WhatsApp e come link su Instagram.

### Invia nota vocale

Invia un messaggio vocale pre-registrato dalle tue [Risorse](https://docs.whappy.ai/it/campaign/assets.md).

* **Registrazione da inviare**: una registrazione. Fino a 5 minuti; i file audio fino a 16 MB vengono convertiti automaticamente.
* **Cosa dire prima (facoltativo)**: indica di cosa parla la nota, non le parole. L'assistente invia una riga breve prima, nella lingua del lead.
* **Attendi la risposta del lead prima di continuare**.

Arriva come nota vocale su WhatsApp e come link su Instagram.

### Condizione

Controlla una risposta raccolta e manda il lead sul percorso **Vero** o **Falso**.

* **Verifica se**: il campo Info da controllare. Servono campi Info prima di poter creare condizioni.
* **Operatore** e **Valore da confrontare**, secondo il tipo del campo:

| Tipo di campo | Operatori |
| - | - |
| **Testo** | Uguale, Contiene, È vuoto, Non è vuoto, **Domanda** (una domanda sì o no a cui l'assistente risponde sulla risposta del lead) |
| **Numero** | Uguale, Maggiore di, Minore di, Maggiore o uguale a, Minore o uguale a, È vuoto, Non è vuoto |
| **Scelta multipla** | Spunta una o più opzioni in **Seleziona opzioni**: vero quando la risposta è una di queste |

* **Se sconosciuto**: se prendere il percorso Vero o Falso quando la risposta non è nota.

### Test A/B

Divide i nuovi lead in parti uguali tra il ramo **A** e il ramo **B**. Ogni lead resta nel suo ramo, così puoi confrontare come convertono i due percorsi. Un funnel può avere un solo test A/B alla volta.

* **Vince chi ha più**: **Risposte**, **Arrivi alla fine**, **Appuntamenti prenotati** o **Lead vinti**.
* **Risultati**: quanti lead sono entrati in ogni ramo e un verdetto. Nessun vincitore viene indicato finché ogni ramo non ha abbastanza lead; poi dice quale ramo è in vantaggio (confidenza del 95%) o che non c'è ancora una differenza chiara.
* **Tieni A** / **Tieni B**: chiude il test. Tutti i nuovi lead seguono il ramo che tieni e gli step usati solo dall'altro ramo vengono rimossi. I lead già nel test finiscono sul percorso attuale.

Se modifichi un ramo dopo l'inizio del test, i suoi risultati mescolano due versioni, e lo step lo segnala. Durante il test, [Coach](https://docs.whappy.ai/it/autopilot/coach.md) aspetta prima di provare nuove formulazioni su questa campagna.

### Prenota un appuntamento

Prenota un appuntamento su un calendario collegato in Integrazioni: Calendly, Cal.com o GoHighLevel. L'assistente legge la disponibilità e prenota l'incontro.

* **Tipo di riunione**: uno dei tipi di evento attivi del calendario.
* **Descrizione dell'evento**: di che incontro si tratta.
* **Esempio di messaggio di richiesta**: come l'assistente lo propone.

> [!WARNING]
>
> Anche le conversazioni di prova prenotano riunioni reali su questo calendario.

### Invia dati

Invia tutto ciò che è stato raccolto finora a un altro sistema, senza chiudere la conversazione. **Tipo di connessione**:

* **WhatsApp**: avvisa un numero a tua scelta con un template di notifica. Premi **Crea template di notifica** e Whappy lo crea nel tuo account Meta Business; lo step mostra quando Meta lo ha approvato. Richiede un numero WhatsApp collegato.
* **Webhook**: invia un payload JSON con la conversazione e le informazioni del lead al tuo **URL endpoint**, con il **Metodo HTTP** e le **Intestazioni** che scegli. Vedi [Webhook](https://docs.whappy.ai/it/integrations/webhook.md).
* **Zapier o Make**: attiva un trigger **Invia dati** che hai creato nell'app Whappy su [Zapier](https://docs.whappy.ai/it/integrations/zapier.md) o [Make](https://docs.whappy.ai/it/integrations/make.md).

Spunta **Salta test (non inviare durante il test)** perché le conversazioni di prova non avvisino il tuo team e non arrivino al tuo CRM.

**Testa invio dati** (solo Webhook e Zapier o Make) invia i dati dello step da una conversazione reale di questa campagna che scegli tu, e mostra la risposta e il payload inviato. Usa la versione salvata dello step, quindi salva prima. Fino a 10 test al minuto.

### Chiudi

Termina la conversazione. Ogni percorso deve finire con uno step Chiudi.

Attiva **Continua in un'altra campagna** per spostare il lead in un'altra campagna quando questa conversazione si chiude:

* **Campagna in cui spostare il lead**. Una campagna in pausa non riceve nessuno finché resta in pausa. Una campagna che non parla su uno dei canali di questa non riceve i lead di quel canale, e lo step lo segnala.
* **Quando il lead arriva**:
  * **Invia il primo messaggio della nuova campagna**: la nuova campagna apre con il suo primo messaggio (solo WhatsApp).
  * **Aspetta che sia il lead a scrivere**: il lead viene spostato in silenzio e la nuova campagna risponde quando scrive di nuovo.
  * **Continua senza il template**: la nuova campagna riparte dallo step successivo al suo primo messaggio, così il lead non riceve una seconda apertura.
* **Porta con te le informazioni raccolte**: la nuova conversazione parte sapendo ciò che questa ha raccolto, con la data in cui è stato raccolto.

Lo spostamento avviene circa due minuti dopo la chiusura della conversazione. Vedi [Chat](https://docs.whappy.ai/it/leads/conversation-history.md).

## Provare il funnel

**Test** (in alto a destra sulla tela) apre una conversazione di prova. Richiede un funnel salvato con almeno uno step dopo l'inizio, e nessuno step incompleto.

Scegli un lead di test, oppure **Aggiungi un lead di test**, e premi **Avvia**. Fai tu il lead in una finestra di chat e vedi le informazioni raccolte. In una campagna che parla su entrambi i canali, **Prova come** ti fa scegliere WhatsApp o Instagram; su Instagram scrivi tu per primo, come farebbe il cliente.

Una conversazione di prova non invia mai un messaggio a un telefono reale. Per il resto però è reale: uno step **Prenota un appuntamento** prenota sul calendario collegato, e gli step **Invia dati** inviano i dati a meno che **Salta test** sia attivo.

Per un controllo più ampio, la [Prova](https://docs.whappy.ai/it/autopilot/rehearsal.md) fa passare clienti inventati nella campagna. Attivala in [Opzioni → Sezioni](https://docs.whappy.ai/it/campaign/options.md).

## Schemi comuni

```
Qualifica e prenota
Template WhatsApp → Chiedi informazioni (Budget) → Condizione (Budget > 5000)
    Vero  → Prenota un appuntamento → Chiudi
    Falso → Conversa (spiega l'offerta d'ingresso) → Chiudi
```

```
Rispondi, poi passa la mano
Template WhatsApp → Agente di supporto (uscita: "Il lead è pronto ad acquistare?") → Invia dati (avviso WhatsApp alle vendite) → Chiudi
```

> [!TIP]
>
> Parti con un flusso breve e lineare, provalo, poi aggiungi le diramazioni.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.