import { Steps } from '@astrojs/starlight/components';
import Figure from '@/components/Figure.astro';

**Per chi è:** qualsiasi attività che vuole trasformare i visitatori del proprio sito o i contatti
WhatsApp in opportunità di vendita, senza dipendere dal fatto che qualcuno sia collegato in quel momento.
L'esempio di questa pagina è un'agenzia immobiliare, il mercato iniziale di Nuntius, ma il
meccanismo è lo stesso per qualsiasi settore.

## Cosa vede il cliente finale

Un visitatore apre il widget del tuo sito (o ti scrive su WhatsApp) e conversa con il tuo assistente.
L'intestazione del widget mostra sempre il sottotitolo **"Assistente con IA · risponde all'istante"**, e
ogni messaggio generato dall'IA porta l'etichetta **"IA"** accanto al nome dell'assistente — l'avviso che
si sta parlando con un'intelligenza artificiale (Regolamento IA, Art. 50) è obbligatorio, non
disattivabile, e compare su tutti i canali e le lingue. Se il visitatore chiede direttamente "sei una
persona?", l'assistente lo conferma senza giri di parole.

L'assistente risponde con le informazioni del tuo stesso catalogo (unità disponibili, prezzi,
condizioni…), propone orari reali di visita e li fissa da solo, e sa quando passarti la conversazione —
tutto nello stesso filo, senza che il visitatore debba ripetere nulla.

## Passaggi nel prodotto

<Steps>

1. **Collega il tuo primo canale.** Il tuo account nasce già con un widget web; copia il suo snippet da
   **Canali → Widget web** e incollalo nella tua pagina. Per WhatsApp, premi **Collega** sulla scheda
   corrispondente — è un flusso ospitato da Meta, esci dalla Piattaforma e torni già collegato. Vedi
   **[Canali](/it/guides/canales/)**.

   <Figure
     src="/captures/inbox-conversacion.png"
     alt="Conversazione aperta ancora gestita dalla IA: etichette Non classificato e Nessuna analisi nell'intestazione, pulsante Prendi il controllo, avviso che la IA sta gestendo la conversazione, e il composer disabilitato, con la scheda del contatto a destra"
     caption="Finché la conversazione la gestisce la IA, il campo di scrittura resta disabilitato per il tuo team — prendi il controllo solo se serve davvero intervenire."
   />

2. **Assegna l'agente che gestirà quell'istanza.** Nella scheda del canale, scegli l'agente nel menu a
   tendina **Agente assegnato** — puoi usarne uno diverso per canale o istanza (per esempio un tono più
   commerciale su WhatsApp). Vedi **[Agenti IA](/it/guides/agentes-ia/)**.
3. **Carica la tua base di conoscenza.** Carica i tuoi documenti (condizioni, domande frequenti,
   brochure) in **Base di conoscenza**; l'agente usa solo ciò che gli hai dato, non inventa mai
   informazioni sulla tua attività. Vedi **[Conoscenza e documenti](/it/guides/conocimiento-documentos/)**.
4. **Collega il tuo catalogo reale tramite un server MCP ed etichettalo.** Se il tuo catalogo (le unità in
   vendita o affitto, nel caso di un'immobiliare) vive in un sistema esterno, collegalo come server MCP da
   **Impostazioni → Server MCP** — scegli un modello dal catalogo a livelli (livello A con chiave API,
   livello B con OAuth) oppure porta il tuo server. Assegna un'**etichetta di risorse** (per esempio
   «Vendite») al server MCP, e la stessa etichetta all'agente che deve usarlo, nella sua sezione
   **Risorse** — l'agente vede il catalogo solo se condivide un'etichetta con esso; senza nessuna etichetta
   in comune, non lo vede affatto. Vedi **[Server MCP](/it/integrations/servidores-mcp/)** e **[Risorse ed
   etichette: cosa vede ogni agente](/it/guides/agentes-ia/)**.
5. **Definisci il tuo orario lavorativo.** In **Impostazioni → Orario lavorativo**, attiva o disattiva
   ogni giorno della settimana, regola la fascia oraria e scrivi il messaggio che vedrà chi ti scrive fuori
   orario. Questo stesso orario alimenta il motore di disponibilità dell'Agenda — la IA non offre mai un
   appuntamento fuori dal tuo orario lavorativo. Vedi
   **[Impostazioni e integrazioni](/it/guides/ajustes-integraciones/)**.
6. **Regola quando l'agente passa la conversazione a una persona.** Nell'editor dell'agente, sezione
   **Regole di escalation**: aggiungi parole chiave («parlare con una persona»), una soglia di turni non
   risolti, oppure attiva l'escalation automatica su richiesta esplicita del cliente. Vedi **[Agenti
   IA](/it/guides/agentes-ia/)**.

   <Figure
     src="/captures/agentes-reglas-escalacion.png"
     alt="Editor dell'agente Captador de Leads che mostra il system prompt, il messaggio di fallback e, sotto, la sezione Regole di escalation con la Regola 1: chip di parola chiave «parlare con una persona», campo «Scrivi e premi Invio» con pulsante Aggiungi, Turni non risolti (soglia) su «Nessuna soglia», Azione su «Passa a un umano», l'interruttore «Richiesta esplicita di parlare con un umano» attivato in arancione, e il pulsante + Aggiungi regola sotto"
     caption="Ogni regola combina una o più condizioni — parola chiave, turni non risolti, richiesta esplicita — con l'azione che innesca."
   />

7. **Il visitatore conversa e l'agente cattura il lead da solo.** Mentre la conversazione avanza,
   l'assistente annota il tipo di interesse rilevato (per esempio, acquisto o affitto, nel caso di
   un'immobiliare), consulta il catalogo reale collegato al passo 4 per rispondere con dati concreti, e il
   lead compare nel tuo funnel senza che nessuno lo abbia inserito a mano.

   <Figure
     src="/captures/leads-kanban-tablero.png"
     alt="Bacheca kanban dei Lead con l'intestazione Funnel di conversione (Nuovo, Qualificato, Contattato, Visita fissata, In negoziazione, ciascuno con contatore e percentuale) e le colonne del funnel con le loro schede lead"
     caption="Il lead catturato dalla IA compare nella prima fase del funnel, con il suo canale di origine (WhatsApp, Telegram o Web) visibile sulla scheda."
   />

8. **Se il cliente chiede un appuntamento, la IA lo fissa da sola.** L'agente usa lo stesso motore di
   disponibilità che vede il tuo team: consulta l'orario lavorativo del passo 5, i parametri dell'agenda,
   la disponibilità personale di ogni dipendente e il suo Google Calendar se collegato, e offre solo orari
   davvero liberi. Se il cliente ne conferma uno, l'appuntamento viene fissato all'istante, con origine
   **IA** e stato **Fissato**, senza che nessuno del tuo team intervenga — la IA non rivela mai il resto
   della tua agenda, negozia solo orari liberi. Vedi
   **[Appuntamenti e agenda](/it/use-cases/citas-agenda/)**.
9. **Rivedi la scheda del lead.** Aprila dalla bacheca per vedere interesse, qualità (Caldo, Tiepido,
   Freddo), canale di origine e la conversazione collegata. Aggiungi note interne o assegna un
   responsabile. Vedi **[Lead](/it/guides/leads/)**.
10. **Se il lead è arrivato in un altro modo, inseriscilo a mano.** Una telefonata, un portale, una visita
    di persona — un lead inserito a mano condivide lo stesso funnel e lo stesso follow-up di quelli
    catturati dalla IA. Vedi **[Lead](/it/guides/leads/)**.
11. **Segui il lead fino alla chiusura.** Sposta la sua fase, crea un appuntamento o un ticket direttamente
    dalla sua scheda, senza uscirne.

</Steps>

## Cosa configurare

- **Canale**: almeno un widget web o un numero WhatsApp collegato.
- **Agente**: assegnato a quell'istanza, con istruzioni e tono adeguati.
- **Base di conoscenza**: i documenti con cui l'agente risponde e qualifica.
- **Catalogo tramite MCP** (facoltativo ma consigliato se il tuo inventario vive fuori da Nuntius):
  il server collegato ed etichettato, con la stessa etichetta sull'agente che deve vederlo.
- **Orario lavorativo**: alimenta l'avviso fuori orario del widget e il motore di disponibilità
  dell'Agenda.
- **Regole di escalation**: almeno una, perché la IA sappia quando passarti la conversazione.
- **Fasi del funnel**: personalizzabili dalla schermata Lead, perché rispecchino il tuo processo di
  vendita.

## Limiti e onestà

- L'agente **non inventa mai** dati sulla tua attività: usa solo ciò che hai caricato nella base di
  conoscenza o ciò che vede tramite il catalogo MCP a cui gli hai dato accesso.
- Senza nessuna etichetta in comune tra l'agente e il server MCP, l'agente **non vede** quel catalogo —
  non c'è accesso «per impostazione predefinita» a tutto ciò che è collegato al tuo account.
- La IA **non rivela mai** il contenuto completo della tua agenda mentre negozia un appuntamento — non
  dice quali altri appuntamenti ci sono né con chi, offre solo orari davvero liberi.
- Telegram e Messenger/Instagram Direct funzionano con lo stesso meccanismo di cattura; la Voce
  telefonica è in sviluppo e non si può ancora attivare.
- Fuori dall'orario lavorativo che configuri, il widget mostra l'avviso di chiusura che imposti — l'IA
  continua a rispondere 24/7, l'orario cambia solo il messaggio e quali orari di appuntamento vengono
  offerti, non la disponibilità dell'agente a conversare.

## Vedi anche

- **[Canali](/it/guides/canales/)** — collegare WhatsApp, Telegram e il widget web.
- **[Server MCP](/it/integrations/servidores-mcp/)** — il catalogo a livelli e come collegare il tuo.
- **[Lead](/it/guides/leads/)** — la bacheca, la scheda e l'inserimento manuale.
- **[Appuntamenti e agenda](/it/use-cases/citas-agenda/)** — il motore di disponibilità completo, con e
  senza IA.
- **[Conoscenza e documenti](/it/guides/conocimiento-documentos/)** — cosa usa l'agente per rispondere.
- **[Assistenza clienti con base di conoscenza](/it/use-cases/atencion-cliente-conocimiento/)** — il
  passo successivo, quando una conversazione deve passare a una persona.