Concetti Fondamentali

Comprendere questi elementi costitutivi renderà ogni altra funzionalità di FRENZY.BOT più facile da usare. Questa pagina spiega come funziona il sistema in parole semplici.

Come funziona FRENZY.BOT

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│ I tuoi Dati │ ──→ │ Indicizzazione│ ──→ │   Qdrant    │
│ File, URL   │     │ (Embeddings) │     │ (Vector DB) │
│    FAQ      │     └──────────────┘     └──────┬──────┘
└─────────────┘                                 │
                                                │ recupero
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Domanda    │ ──→ │  FRENZY.BOT  │ ──→ │ Modello AI  │
│ dell'utente │     │ (Motore RAG) │ ←── │(via OpenRouter)│
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │  Risposta   │
                    │ + Dati Lead │
                    │ + Analytics │
                    └─────────────┘

Carichi i tuoi dati — file, URL di siti web e coppie di FAQ vengono inseriti nella Knowledge Base.
Il sistema li indicizza — il contenuto viene convertito in embedding numerici e memorizzato in Qdrant (database vettoriale) in modo da poter essere cercato per significato, non solo per parole chiave.
Un utente pone una domanda — tramite il widget, WhatsApp, Telegram o qualsiasi canale collegato.
FRENZY.BOT recupera i contenuti pertinenti — il sistema trova i frammenti più rilevanti della tua knowledge base utilizzando la ricerca semantica.
Il modello AI genera una risposta — il contenuto recuperato + la domanda dell'utente vengono inviati al modello AI (Claude, GPT, Gemini, ecc.) tramite OpenRouter.
Tutto viene tracciato — la conversazione, i tempi di risposta, l'utilizzo dei token e tutti i dati dei lead acquisiti vengono memorizzati per la reportistica.

Bot

Il tuo bot è l'assistente AI che stai costruendo. Ogni bot ha i propri:

Knowledge base — I documenti, gli URL e le FAQ da cui impara.
Impostazioni — Modello AI, system prompt, temperatura, branding, configurazione del widget.
Conversazioni — Cronologia delle chat con gli utenti.
Lead — Contatti acquisiti durante le conversazioni.
Analytics — Metriche di utilizzo e dati del funnel.
Widget — Il proprio codice di incorporamento con un data-bot-id univoco.

In una configurazione multi-bot, puoi gestire più bot da una singola installazione, ognuno completamente isolato dagli altri.

Dove gestire: Impostazioni, Knowledge Base, Embed e il menu a discesa dell'area di lavoro nell'intestazione.

Knowledge Base

La knowledge base è la libreria che il tuo bot consulta prima di rispondere a qualsiasi domanda. È ciò che rende il tuo bot specifico per la tua attività invece di una AI generica.

Tre fonti di dati:

Fonte	Ideale per	Velocità di indicizzazione
File (PDF, DOCX, TXT, CSV, ecc.)	Documenti interni, policy, specifiche di prodotto	Minuti
URL (qualsiasi pagina pubblica)	Contenuti del sito web, articoli di aiuto, post del blog	Minuti
FAQ (coppie D&R manuali)	Risposte critiche che vuoi controllare esattamente	Istantanea

Principio chiave: Se un argomento non è nella knowledge base, il bot potrebbe rispondere in modo generico o rifiutarsi di rispondere. Più contenuti pertinenti aggiungi, migliori saranno le prestazioni del bot.

Per la guida completa, consulta Knowledge Base.

Canali

I Canali sono i luoghi in cui i tuoi utenti interagiscono con il bot.

Canale	Tipo	Configurazione
Widget sito web	Primario	Script di incorporamento sul tuo sito
WhatsApp	Messaggistica	WAHA Docker + accoppiamento QR code
Telegram	Messaggistica	Token del bot da @BotFather
Discord	Community	Token del bot dal Developer Portal
Instagram	Social	Page Access Token
Messenger	Social	Integrazione Pagina Facebook
Slack	Workplace	App token
Webhook	Personalizzato	Qualsiasi endpoint HTTP

Ogni canale può avere il proprio stile di risposta — l'AI adatta il tono e la lunghezza della risposta per corrispondere alla piattaforma (es. più breve su WhatsApp, più dettagliata sul widget del sito).

Per i dettagli, consulta Canali.

Sessioni e conversazioni

Una sessione è una conversazione completa tra un utente e il tuo bot. Ogni sessione traccia:

Messaggi — Ogni domanda e risposta nella conversazione.
Token — Quanti token AI sono stati consumati (influisce sui costi).
Durata — Quanto è durata la conversazione.
Sorgente — Da quale canale proviene la conversazione.
Dati Lead — Qualsiasi informazione di contatto acquisita durante la chat.

Le sessioni sono la base per l'analisi, la revisione della qualità e l'acquisizione di lead. Review review in Conversazioni.

Lead e integrazioni

Un lead è un contatto acquisito durante una chat — nome, email, telefono, azienda e qualsiasi campo personalizzato configurato.

I lead fluiscono attraverso una pipeline:

Nuovo → Contattato → Qualificato → Convertito (o Perso)

Le integrazioni instradano automaticamente i lead verso i tuoi strumenti esterni:

Email — Notifiche SMTP al tuo team.
Webhook — Payload JSON verso i tuoi endpoint.
Google Sheets — Aggiunta di righe per un CRM leggero.
MailChimp — Aggiunta di contatti alle liste di email marketing.

Per i dettagli, consulta Gestione Lead e Integrazioni.

Moduli

I Moduli sono funzionalità opzionali che puoi abilitare o disabilitare senza influenzare il sistema principale:

Modulo	Cosa fa
Live Web Access (Tavily)	Consente al bot di cercare sul web in tempo reale quando i dati interni non bastano
Passaggio a operatore umano	Trasferisce le conversazioni ad agenti umani
Sintesi Vocale (Text-to-Speech)	Converte le risposte dell'AI in riproduzione audio
Prenotazione Appuntamenti	Programmazione in-chat tramite Calendly
Modulo Lead	Acquisisce informazioni di contatto a metà conversazione
WhatsApp	Messaggistica automatizzata tramite WAHA

Sfoglia e gestisci i moduli in Moduli.

Controllo rapido

Usa questa checklist per verificare che il tuo bot sia pienamente operativo:

[ ] Knowledge base popolata — Almeno un file, URL o FAQ aggiunto e con stato Live.
[ ] OpenRouter connesso — Il motore AI mostra un fornitore collegato e un modello selezionato.
[ ] Widget distribuito — Lo script di incorporamento è sul tuo sito e la bolla della chat appare.
[ ] Integrazioni abilitate — I lead vengono instradati verso il tuo CRM, email o webhook.

Se tutti e quattro i punti sono soddisfatti, il tuo sistema è pienamente funzionale e pronto per il traffico di produzione.