Documentazione e guida al chatbot AI
Come preparare la conoscenza, pubblicare il progetto e installare il widget sul sito.
Questa guida spiega il percorso operativo consigliato per configurare il chatbot QRCodeGenerate. Le funzioni disponibili possono variare in base al piano, allo stato del progetto e alla configurazione attiva.
Prima di iniziare
Il chatbot risponde meglio quando le fonti sono ordinate, coerenti e aggiornate. Prima prepara la conoscenza, poi pubblica, poi installa il widget.
Non conviene installare il chatbot su un sito prima di aver verificato argomenti, domande importanti, risposte attese e limiti del progetto.
Percorso consigliato Dalla creazione del progetto alla pubblicazione
1. Crea il progetto
Apri l'area chatbot, crea un progetto e definisci nome, dominio e impostazioni principali.
2. Aggiungi fonti
Usa pagine del sito, fonti manuali, FAQ o documenti supportati per costruire la knowledge base.
3. Organizza argomenti
Collega fonti e topic, separa domande prodotto, requisiti, documenti, costi, contatti e CTA.
4. Controlla qualità
Escludi fonti rumorose, pagine generiche, duplicati e testi che possono far rispondere male il chatbot.
5. Pubblica
Pubblica solo una versione verificata della conoscenza. Il runtime deve leggere la versione pubblicata.
6. Installa e testa
Installa il widget, prova domande reali e usa il report per migliorare fonti e risposte.
Fonti di conoscenza
Le fonti sono il materiale da cui il chatbot può ricavare le risposte. Possono includere pagine del sito, note manuali, FAQ e documenti caricati, quando supportati dal piano.
- Usa fonti specifiche e coerenti con un argomento.
- Evita pagine troppo generiche o con troppe sezioni mischiate.
- Preferisci testi chiari, aggiornati e verificabili.
- Non pubblicare fonti che contengono dati vecchi, ambigui o non controllati.
Argomenti e domande importanti
Gli argomenti aiutano il chatbot a capire quale parte della conoscenza usare. Le domande importanti servono a verificare se il progetto risponde davvero ai bisogni degli utenti.
- Definisci pochi argomenti chiari invece di molti topic confusi.
- Collega ogni argomento alle fonti più adatte.
- Prepara domande reali: cosa è, requisiti, costi, documenti, tempi, contatti.
- Controlla che il chatbot non risponda usando sezioni sbagliate.
Installazione widget
Dopo la pubblicazione puoi installare il widget sul sito. Lo script deve collegare il progetto, la chiave widget e l'endpoint API configurato per il dominio autorizzato.
Esempio indicativo di integrazione:
<script
src="https://www.qrcodegenerate.it/js/chatbot-embed.js"
data-project-id="ID_PROGETTO"
data-widget-key="CHIAVE_WIDGET"
data-api-base="https://www.qrcodegenerate.it/chatbot"
data-mode="marketing"
data-page-type="product"
data-assistant-name="Assistente"
defer></script>I valori reali devono essere quelli generati o configurati nel progetto. Dominio, origine e pubblicazione devono essere coerenti, altrimenti il widget può non avviarsi.
Controlli prima della messa online
- Verifica che esista una versione pubblicata valida.
- Controlla che dominio e origine siano autorizzati.
- Prova domande semplici, follow-up e domande fuori contesto.
- Verifica CTA, raccolta contatti e messaggi di fallback se configurati.
- Controlla da mobile che widget, input e chiusura chat siano usabili.
Errori comuni
- Installare il widget prima di pubblicare la conoscenza.
- Usare fonti rumorose o pagine con contenuti non coerenti.
- Non distinguere domande su prodotto, requisiti, documenti e prezzi.
- Lasciare CTA o messaggi non configurati.
- Aspettarsi risposte corrette senza test reali e manutenzione della knowledge base.
Manutenzione e miglioramento
Dopo la pubblicazione, controlla conversazioni, fallback e domande non coperte. Quando emergono gap, aggiorna le fonti o aggiungi contenuti mirati, poi ripubblica e ritesta.
La manutenzione è parte del prodotto: il sito cambia, le offerte cambiano e anche il chatbot deve restare allineato.
Checklist minima prima del publish
Fonti pulite, argomenti collegati, domande testate, CTA controllate e widget installato sul dominio corretto. Meglio pubblicare meno conoscenza ma più affidabile.