botts.aiDocs

Casi d'uso

Sette cose concrete che puoi creare oggi con botts.ai, da un widget per il supporto clienti a un agente vocale collegato al CRM, da un assistente di ricerca limitato a fonti affidabili a un riepilogo del lunedì mattina che si scrive da solo, con le funzioni esatte da combinare.

botts.ai è una piattaforma di agenti IA polivalente. Gli stessi elementi di base, Agenti, Basi di conoscenza, Deployment, moduli, Integrazioni e Attività pianificate, si combinano in soluzioni molto diverse a seconda del canale e della configurazione che scegli.

Questa pagina presenta sette configurazioni concrete, ognuna costruita interamente con funzioni che il prodotto offre già oggi.

Caso d'usoCanaleFunzioni principali da combinare
Widget per il supporto clientiSito webBase di conoscenza, personalizzazione del widget, modello di backup, modulo Ticket di supporto, voce IA (opzionale)
Assistente interno per le conoscenze aziendaliChat (Interna)Base di conoscenza, controllo degli accessi, navigazione avanzata della Knowledge Base, allegati in chat
Raccolta di lead con i moduliQualsiasi canaleModulo / Cattura Lead, notifiche e-mail, esportazione CSV
Agente telefonicoTelefonoModello vocale, numero di telefono, impostazioni della chiamata, controllo degli accessi
Agente vocale collegato al CRMTelefonoConnessioni, segreti, modello vocale, modulo Richiesta di prenotazione
Assistente di ricerca su fonti affidabiliChat (Interna)Ricerca web limitata a determinati domini, base di conoscenza
Riepilogo del lunedì mattinaPianificateAttività pianificata, un agente, invio via e-mail

Nota

I deployment Sito Web e Telefono richiedono il piano Business o superiore; il piano Personal include solo la chat interna. Per creare deployment, basi di conoscenza, segreti e strumenti serve il ruolo Admin o Proprietario, mentre i Builder possono creare e modificare agenti. Vedi Team e fatturazione.

Widget per il supporto clienti

Un widget di chat sul tuo sito web che risponde a domande su prodotti, fatturazione e procedure basandosi sulla tua documentazione: 24 ore su 24, 7 giorni su 7, con la grafica del tuo marchio.

Funzioni da combinare

  • Base di conoscenza: scansiona la pagina delle FAQ, il centro assistenza e la documentazione del prodotto. Imposta una pianificazione della scansione (giornaliera, settimanale o mensile), così l'agente resta allineato con la tua documentazione. Vedi Base di conoscenza.
  • Agente con un prompt di sistema orientato al supporto: definisci il tono, la lunghezza delle risposte e le regole per l'escalation. Vedi Agenti.
  • Deployment sito web: incorpora il widget con un solo tag script; funziona su qualsiasi sito. Nell'editor del widget personalizza il messaggio di benvenuto, fino a 5 messaggi suggeriti, il launcher (bolla, bolla con messaggio o scheda), i colori, il logo e l'interruttore per il feedback (pollice in su o in giù). Vedi Deployment.
  • Voce IA (opzionale): nell'editor del widget, nella sezione Voce IA, attiva Attiva la voce IA, così chi visita il sito può parlare con l'agente invece di scrivere, nella stessa conversazione. Scegli una Voce, un Messaggio di benvenuto da pronunciare e la Modalità di apertura predefinita. La voce funziona con GPT Live 1 su Microsoft Azure in Svezia (elaborazione globale), quindi non resta in Svizzera, ed è fatturata al minuto. Vedi Voce IA.
  • Modello di backup: configura un modello di backup, idealmente di un altro provider, così il widget continua a rispondere anche quando il modello principale è fuori servizio. Vedi Deployment.
  • Modulo Ticket di supporto (opzionale): attiva il modello di modulo integrato Ticket di supporto, così l'agente può registrare una richiesta di escalation (oggetto, descrizione, email, priorità) quando non riesce a risolvere il problema. Vedi Raccolta di lead con i moduli più sotto.
  • Strumenti HTTP (opzionale): collega la tua API (per esempio un endpoint per lo stato degli ordini), così l'agente può rispondere a domande specifiche sull'account. Per creare strumenti serve il ruolo Admin o Proprietario. Vedi Integrazioni.

Come configurarlo

  1. Apri Conoscenza nella barra laterale, crea una base di conoscenza con Nuova Knowledge Base e aggiungi l'URL del tuo centro assistenza come fonte sito web. Avvia la prima scansione e imposta una pianificazione periodica.
  2. Crea un agente in Agenti, scrivi il prompt di sistema e collega la base di conoscenza.
  3. Nella scheda Implementa dell'agente aggiungi un deployment Sito Web, scegli un modello (e un modello di backup) e personalizza il widget nell'editor con l'anteprima dal vivo.
  4. Copia il codice di incorporamento e incollalo nel tuo sito web.
  5. Rivedi le conversazioni reali in Conversazioni e colma le lacune della base di conoscenza che emergono dalle trascrizioni. Salva come test le risposte che contano con Salva come test nella scheda Chat dell'agente e premi Esegui tutti nella sua scheda Test prima che una modifica vada online. Vedi Conversazioni e Test.

Esempio di prompt di sistema

You are a support assistant for CloudTech Solutions.
Answer questions about our products, billing, and technical setup
based on the knowledge base.

Rules:
- Be concise. Most answers should be 2-3 sentences.
- If a question requires account-specific information,
  ask the customer to contact support@cloudtech.com.
- If you cannot solve the issue, offer to file a support ticket
  and collect the details with the support_ticket form.
- Never share internal processes or pricing breakdowns.

Assistente interno per le conoscenze aziendali

Un assistente privato con cui il tuo team chatta direttamente nella dashboard di botts.ai, istruito con il manuale del personale, le guide IT e le direttive interne. Niente viene incorporato in un sito web pubblico.

Funzioni da combinare

  • Base di conoscenza con documenti caricati: carica i tuoi documenti interni come file PDF, DOC, DOCX, TXT o MD (fino a 100 MB per file). Puoi anche scansionare un sito raggiungibile pubblicamente, per esempio il tuo portale di documentazione. Vedi Base di conoscenza.
  • Deployment Chat (Interna): distribuisce l'agente nella pagina Chat della dashboard, dove i membri del tuo team possono parlarci. Un solo deployment Chat (Interna) per agente. Vedi Deployment.
  • Controllo Accesso: scegli chi può usare l'assistente: Organizzazione (tutti i membri), Basato sul ruolo (ruolo minimo Builder o Admin) o Solo su invito (un elenco di membri specifici). I membri con il ruolo Membro, che possono solo chattare, vedono soltanto gli agenti la cui modalità di accesso lo consente. Per i ruoli vedi Team e fatturazione.
  • Navigazione avanzata della Knowledge Base (opzionale): un interruttore in Strumenti integrati nell'editor dell'agente che gli permette di elencare le fonti della base di conoscenza e di leggere documenti interi, invece di cercare solo dei frammenti. È utile quando per rispondere bisogna leggere un'intera direttiva.
  • Modello di backup: anche i deployment Chat (Interna) supportano un modello di backup per il failover, proprio come i deployment Sito Web.
  • Caricamento file (opzionale): un interruttore nel deployment che permette alle persone del team di allegare un documento, un'immagine o un foglio di calcolo alla conversazione e di fare domande al riguardo, senza aggiungerlo alla base di conoscenza condivisa. È la scelta giusta per un contratto o un rapporto occasionale che non serve a nessun altro. Vedi Allegare documenti.

Come configurarlo

  1. Crea una base di conoscenza e carica i tuoi documenti interni (trascinandoli puoi caricare più file alla volta).
  2. Crea un agente, collega la base di conoscenza e, se vuoi, attiva Navigazione avanzata della Knowledge Base in Strumenti integrati.
  3. Nella scheda Implementa aggiungi un deployment Chat (Interna). Scegli la modalità di accesso, aggiungi se vuoi una Descrizione (compare sotto il titolo all'inizio della chat), decidi se consentire il Caricamento file e, se vuoi, carica un'Immagine Chat.
  4. Invita il tuo team in Organizzazione → Membri. Chi ha il ruolo Membro arriva direttamente in Chat appena accede. Proprietari, admin e builder aprono Chat dalla barra laterale.

Nota

Tutti i contenuti delle basi di conoscenza vengono salvati e trasformati in embedding su infrastruttura svizzera, indipendentemente dal modello IA usato dal deployment.

Raccolta di lead con i moduli

L'agente raccoglie dati strutturati (nome, email, dettagli di una prenotazione, informazioni per un ticket) nel corso di una conversazione naturale, li convalida e li salva come invio di un modulo che puoi consultare ed esportare.

I moduli funzionano su tutti i canali: il widget per il sito web, la chat interna e le chiamate telefoniche.

Funzioni da combinare

  • Modulo / Cattura Lead: una sezione nell'editor dell'agente (scheda Configura) con un interruttore generale. Attivalo, poi scegli i modelli di modulo integrati o definisci moduli personalizzati.
  • Notifiche e-mail (opzionale): seleziona Invia notifica all'invio per far arrivare ogni invio via e-mail all'indirizzo di notifica della tua organizzazione (lo imposti nella pagina delle impostazioni dell'organizzazione).
  • Scheda Moduli: ogni invio compare nella scheda Moduli dell'agente, filtrabile per nome del modulo, con esportazione CSV ed eliminazione.
  • Dati di contatto: nome, email e telefono di un invio vengono aggiunti al profilo della persona (i valori già salvati restano invariati). Il numero di telefono diventa poi l'etichetta delle conversazioni di quella persona nella scheda Chat dell'agente e si può cercare in Conversazioni. L'invio completo resta nella scheda Moduli. Vedi Persone e memoria.

Modelli di modulo integrati

ModelloCampi (* = obbligatorio)
Modulo di contattonome*, email*, telefono, messaggio
Ticket di supportooggetto*, descrizione*, email*, priorità (bassa/media/alta)
Richiesta di prenotazionenome*, email*, data*, servizio

Moduli personalizzati

Se i modelli non fanno al caso tuo, crea un modulo tuo in Moduli personalizzati: inserisci il Nome modulo, poi aggiungi i campi, ognuno con un nome, un tipo (Testo, Numero o Sì/No) e l'opzione Obbligatorio. I nomi vengono salvati in minuscolo con i trattini bassi (da «Nome azienda» si ottiene nome_azienda), e l'agente chiede ogni campo in base al suo nome, quindi scegli nomi che dicano cosa ti serve.

Come funziona nella conversazione

  1. L'agente chiede i campi del modulo nel corso della conversazione: non mostra un modulo vero e proprio, ma raccoglie i valori in chat (o a voce durante una chiamata).
  2. I dati inviati vengono convalidati rispetto allo schema del modulo; se qualcosa manca o non è valido, l'agente chiede all'utente di correggerlo.
  3. Ogni modulo può essere inviato una sola volta per conversazione: gli invii doppi vengono rifiutati automaticamente.
  4. L'invio viene salvato e, se l'opzione è attiva, inviato via e-mail al tuo indirizzo di notifica.

Agente telefonico

Un agente vocale su un vero numero di telefono che risponde a ogni chiamata. Può fare, per esempio, da receptionist: comunica gli orari di apertura, risponde alle domande sui servizi attingendo alla base di conoscenza e raccoglie le richieste di prenotazione con un modulo.

Funzioni da combinare

  • Deployment telefonico: viene creato subito quando selezioni il canale Telefono nella scheda Implementa. I deployment telefonici funzionano con GPT Live 1; scegli una delle 8 voci (Gleam, Cedar, Marin, Meridian, Willow, Stone, Vesper, Ripple), che puoi ascoltare sulla pagina delle voci. Vedi Deployment.
  • Numero di telefono: acquista un numero locale svizzero o statunitense nel pool di numeri della tua organizzazione e assegnalo al deployment. Per acquistare e gestire i numeri serve il ruolo Admin o Proprietario, e ogni numero acquistato conta nella tua quota di numeri di telefono.
  • Messaggio di benvenuto: la prima cosa che l'agente dice quando risponde.
  • Base di conoscenza: la stessa base di conoscenza che l'agente usa in chat risponde anche alle domande durante le chiamate. Vedi Base di conoscenza.
  • Modulo Richiesta di prenotazione (opzionale): attiva il modello di modulo integrato Richiesta di prenotazione, così l'agente raccoglie a voce nome, email, data e servizio. Vedi Raccolta di lead con i moduli.
  • Prenotazione appuntamenti (opzionale): invece di raccogliere una richiesta, l'agente prenota direttamente in un calendario Cal.com, durante la chiamata stessa. Per ora è botts.ai a configurare lo strumento per te. Vedi Prenotazione appuntamenti.
  • Impostazioni Chiamata: la lingua prevista per la chiamata (Auto, English, Deutsch, Français, Italiano: il saluto e i primi scambi partono in questa lingua, e se chi chiama parla chiaramente un'altra lingua l'agente si adegua), la registrazione della chiamata (disattivata per impostazione predefinita) e una durata massima della chiamata (valore predefinito nella dashboard: 10 minuti).
  • Controllo Accesso (opzionale): Pubblico è l'impostazione predefinita per le linee rivolte alla clientela. Per una linea interna scegli Organizzazione, Basato sul ruolo o Solo su invito: il numero di chi chiama viene confrontato con i numeri di telefono nei profili dei tuoi membri, e chi non è autorizzato sente il messaggio vocale in inglese «Access denied». Per sapere dove i membri inseriscono questi numeri, vedi Le impostazioni del tuo account.

Come configurarlo

  1. Nella scheda Implementa dell'agente seleziona il canale Telefono: viene creato un deployment telefonico con le impostazioni predefinite, già aperto per la modifica.
  2. Acquista o assegna un numero di telefono dal pool della tua organizzazione.
  3. Imposta il messaggio di benvenuto, scegli una voce e regola le impostazioni della chiamata.
  4. Chiama il numero e fai una prova. Le trascrizioni (e le registrazioni, se attive) compaiono in Conversazioni. Vedi Conversazioni.

Attenzione

Le chiamate telefoniche consumano crediti. Quando la tua organizzazione ha esaurito i crediti, le chiamate in arrivo vengono rifiutate con un messaggio vocale. Tieni d'occhio il saldo in Team e fatturazione.

Esempio di prompt di sistema

You are the phone assistant for Dr. Müller's dental practice in Zurich.
Answer calls professionally and helpfully.

Rules:
- Provide information about our services, opening hours, and location.
- For appointment requests, collect the patient's details with the
  booking_request form and confirm we will call them back.
- For emergencies, give the emergency dental number: +41 44 200 33 88.
- Be calm, professional, and reassuring.

Agente vocale collegato al CRM

Un agente telefonico che non si limita a rispondere alle domande. Quando chiama un cliente, l'agente gli chiede il numero di telefono o il numero cliente, lo cerca nel tuo CRM, saluta per nome chi è già cliente e registra nel CRM l'esito della chiamata (oppure fissa un ricontatto), tutto durante la conversazione. È lo schema alla base di «agente vocale più i tuoi sistemi aziendali».

Funzioni da combinare

  • Deployment telefonico: un agente vocale su un vero numero. Vedi Deployment.
  • Una connessione al tuo CRM: il ponte verso il tuo sistema aziendale. Se il tuo CRM ha un server MCP, collegalo e importa gli strumenti che ti servono. Se pubblica una specifica OpenAPI, indica alla connessione l'URL della specifica e scegli gli endpoint. Altrimenti definisci gli endpoint a mano: un lookup_customer (una richiesta GET all'endpoint dei contatti del tuo CRM, filtrata per numero di telefono) e un log_interaction (una richiesta POST che aggiunge una nota o un'attività). Vedi Integrazioni.
  • Segreti: salva una volta sola la chiave API del tuo CRM e richiamala come $secret:crm_api_key nell'autenticazione dello strumento, così la chiave non compare mai in un prompt o nella definizione di uno strumento. Vedi Integrazioni.
  • Base di conoscenza (opzionale): per rispondere durante la chiamata alle domande su prodotti e servizi con i tuoi contenuti indicizzati.
  • Modulo Richiesta di prenotazione (opzionale): per raccogliere a voce una richiesta di richiamata o di appuntamento quando la questione non si può risolvere durante la chiamata.
  • Memoria cliente (opzionale): per ricordare le preferenze e le indicazioni permanenti di ogni persona che chiama, da una chiamata all'altra. Vedi Persone e memoria.

Come configurarlo

  1. In Integrazioni → Segreti aggiungi la chiave API del tuo CRM come segreto (per esempio crm_api_key).
  2. In Integrazioni → Strumenti aggiungi una connessione API HTTP per il tuo CRM con URL di base https://your-crm.example.com, tipo di autenticazione Bearer Token e token $secret:crm_api_key, poi definisci due endpoint: lookup_customer (GET /contacts?phone={phone}, con un parametro phone) e log_interaction (POST /contacts/{id}/notes, con i parametri id e note). Prova entrambi dalla finestra di dialogo prima di proseguire.
  3. Crea un agente, collega entrambi gli strumenti e, se vuoi, una base di conoscenza.
  4. Nella scheda Implementa aggiungi un deployment Telefono, assegna un numero e scegli una voce.
  5. Nel prompt di sistema spiega all'agente quando usare ciascuno strumento: chiedere all'inizio il numero di telefono o il numero cliente e cercare chi chiama, usarne il nome e registrare un riepilogo prima di riattaccare.

Suggerimento

Fai in modo che ogni strumento restituisca 200 con un body utile anche quando il risultato è «non trovato» (per esempio {"found": false}), così l'agente reagisce in modo appropriato: il body di una risposta 404 non arriva al modello. Per la gestione delle risposte vedi Integrazioni.

Esempio di prompt di sistema

You are the phone assistant for [Your Company].
At the start of every call, ask for the caller's phone number or
customer number and use the lookup_customer tool with it to check
whether they are an existing customer.

Rules:
- If the customer is found, greet them by name and reference their account.
- If not, ask how you can help and offer a callback with the booking_request form.
- Answer product and service questions from the knowledge base.
- Before ending the call, use log_interaction to save a one-line summary.
- Never read account IDs or internal notes aloud.

Assistente di ricerca su fonti affidabili

Un assistente interno che fa ricerche sul web in tempo reale, ma solo tra le fonti di cui ti fidi: la tua autorità di vigilanza, un ente di normazione, un'associazione di categoria, il tuo sito. Il punto non è che sappia cercare: è che non può uscire dal seminato.

Funzioni da combinare

  • Ricerca web con «Solo questi siti»: elenca fino a 10 domini da cui l'agente può attingere. Tutto il resto viene filtrato prima che l'agente lo veda. Vedi Ricerca web.
  • Base di conoscenza (opzionale): il tuo materiale, che l'agente privilegia perché lo consulta per primo.
  • Deployment Chat (Interna): il team fa le domande nella dashboard.
  • Allegati in chat: una persona del team può trascinare un PDF nella conversazione e chiedere come si concilia con le linee guida. Vedi Allegare documenti.

Come configurarlo

  1. Crea un agente e scrivi un prompt che indichi quali fonti fanno testo e che l'agente le deve citare.
  2. In Strumenti integrati attiva Ricerca web, scegli Solo questi siti e aggiungi i tuoi domini.
  3. Distribuiscilo come Chat (Interna), così il team può accedervi.

Suggerimento

Chiedi all'agente di indicare la data di tutto ciò che cita. La ricerca web segnala i dati che potrebbero non essere aggiornati, e un prompt che insiste sulla data rende evidenti nella risposta le indicazioni superate, invece di lasciarle nascoste.

Nota

Le ricerche web vengono gestite da un fornitore in Francia. Se la posizione del server impostata per la tua organizzazione richiede un'elaborazione esclusivamente in Svizzera, questo viene indicato nel pannello Valutazione dei dati del deployment, e conviene controllarlo prima di attivare la funzione. Vedi Residenza dei dati e trasparenza.

Riepilogo del lunedì mattina

Un breve riepilogo che arriva prima ancora che tu apra la dashboard: cosa è cambiato in un sistema che hai collegato, cosa hanno pubblicato le fonti che segui, oppure una sintesi ricavata dalla tua base di conoscenza. Nessuno deve ricordarsi di chiederlo.

Funzioni da combinare

  • Un'attività pianificata: l'istruzione, la cadenza e l'invio. Vedi Attività pianificate.
  • Un agente con le conoscenze, le connessioni o la ricerca web di cui il riepilogo ha bisogno. Un'attività può riferire solo su ciò che il suo agente riesce davvero a recuperare, quindi dagli lo strumento prima di dargli la pianificazione. L'agente deve avere un deployment Chat (Interna) che puoi usare: nella procedura guidata compaiono solo questi agenti.
  • Invio via e-mail: il risultato arriva nella tua casella di posta. La versione completa resta nella cronologia della chat.

Come configurarlo

  1. Apri Pianificate e descrivi l'attività in una frase, per esempio «ogni lunedì alle 8, controlla le pagine di stato dei nostri fornitori e riassumi tutto ciò che è cambiato».
  2. Conferma come la procedura guidata ha interpretato la pianificazione e in Con cosa deve funzionare? scegli l'agente che ha accesso al materiale giusto (deve essere distribuito come Chat (Interna)).
  3. Scegli l'invio E-mail.
  4. Usa Eseguila una volta adesso prima di attivarla. Così vedi il risultato reale e il costo reale.

Suggerimento

Indica con precisione la forma del risultato. «I cinque temi più frequenti, una frase ciascuno, poi tutto ciò che è insolito» produce qualcosa che le persone leggono davvero il lunedì. «Riassumi la settimana scorsa» produce qualcosa che si salta.

Le attività pianificate sono personali: quella che crei è tua, e chi nel team vuole lo stesso riepilogo se ne crea uno proprio. Chiedi il risultato più breve che sia ancora utile, perché un'attività giornaliera fa trenta esecuzioni al mese e ognuna costa crediti.

Creare il tuo caso d'uso

Queste configurazioni seguono uno schema comune:

  1. Definisci la missione: quale problema specifico deve risolvere l'agente?
  2. Raccogli le conoscenze: scansiona o carica le informazioni che gli servono in una base di conoscenza.
  3. Stabilisci le regole: scrivi un prompt di sistema che dica cosa l'agente deve fare e cosa non deve fare mai.
  4. Scegli il canale: il widget sul sito web per chi lo visita, Chat (Interna) per il tuo team, Telefono per chi chiama. Vedi Deployment.
  5. Migliora per gradi: rivedi le trascrizioni in Conversazioni, usa Salva come test nella scheda Chat dell'agente per le risposte che contano, colma le lacune della base di conoscenza, affina il prompt di sistema e premi Esegui tutti nella scheda Test dell'agente prima che ogni modifica vada online. Vedi Test.

Inizia con un caso d'uso, fallo funzionare bene e poi allarga il campo. Più agenti possono condividere la stessa base di conoscenza, così un widget di supporto e un assistente interno possono basarsi sugli stessi contenuti.

Ultimo aggiornamento: 4 ottobre 2026