Istruisci il tuo bot (Conoscenza degli agenti)

Il tuo bot risponde solo in base a ciò che gli insegni. Le chiamiamo le sue conoscenze: brevi testi sulla tua attività, pagine del tuo sito web e prodotti del tuo negozio online. Se qualcosa non è nelle conoscenze, il bot non lo sa.

Vai in Automazione → Agenti IA → Conoscenza degli agenti. La pagina si intitola Info aziendali ed elenca tutto ciò che hai aggiunto. Usa Cerca documenti per trovare una voce, e il filtro Canale se hai più di un numero.

Modi per aggiungere conoscenze

Modo	Adatto per	Dove trovarlo
Aggiungi info	Tutto ciò che scrivi tu: orari di apertura, prezzi, consegne, condizioni, domande frequenti	Il pulsante principale della pagina
Aggiungi tramite sito web	Una pagina del tuo sito web	Altri modi per aggiungere
Aggiungi tramite sitemap	Molte pagine del tuo sito web in una volta	Altri modi per aggiungere
Sincronizzazione dei prodotti	I prodotti del tuo negozio Shopify o Wix	Impostazioni → Integrazioni
Aggiungi tramite workflow	Conoscenze aggiunte da uno dei tuoi workflow manuali	Altri modi per aggiungere

Scrivere le informazioni con Aggiungi info dà le risposte più affidabili, perché decidi tu esattamente cosa legge il bot.

Scrivi il testo con Aggiungi info

Fai clic su Aggiungi info. Si apre il modulo Aggiungi info.
Compila i campi qui sotto e fai clic su Invia.
Quando vedi Creato, il bot può usare subito la voce.

Campo	Cosa inserire
Titolo	Un nome breve per l’argomento, per ritrovarlo nell’elenco. Ad esempio Zone e costi di consegna.
Categoria	Altro. Vedi Quale categoria scegliere.
Canale	Il numero a cui appartiene la voce. Serve solo per ordinare: vedi Il Canale di una voce.
Descrizione	Le conoscenze vere e proprie. È il testo che il bot legge, quindi scrivilo per intero. Vedi Scrivi informazioni che il bot può usare.
Allegati	Facoltativi. File o pulsanti che il bot può inviare con la risposta. Vedi Allegati.

Aggiungi una pagina del tuo sito web

Fai clic su Altri modi per aggiungere → Aggiungi tramite sito web.
In Inserisci l’URL del tuo sito web, incolla l’indirizzo completo di una pagina, ad esempio https://www.example.com/delivery.
Scegli Altro come Categoria, scegli il Canale e fai clic su Invia.

Buono a sapersi:

Wabot legge solo quella pagina. Non segue i link verso le altre pagine del tuo sito. Aggiungi ogni pagina che ti serve, oppure usa una sitemap.
La lettura di una pagina richiede un po’ di tempo. L’elenco si ricarica una volta dopo circa 10 secondi. Se la pagina non c’è ancora, aggiorna la pagina un minuto dopo.
Se dopo qualche minuto la pagina non è ancora nell’elenco, Wabot non è riuscito a leggerla. In questo caso copiane il testo in Aggiungi info.
Aggiungere una pagina che è già nelle tue conoscenze non ha alcun effetto.
Alcuni siti web inseriscono il testo con degli script dopo l’apertura della pagina, e Wabot potrebbe non vedere quel testo. Se il bot non sa rispondere a una domanda trattata nella pagina, copia il testo in Aggiungi info.

Aggiungi molte pagine con una sitemap

Una sitemap è un file del tuo sito web che ne elenca le pagine. Spesso si trova a un indirizzo come https://www.example.com/sitemap.xml.

Fai clic su Altri modi per aggiungere → Aggiungi tramite sitemap.
In Inserisci l’URL della tua sitemap, incolla l’indirizzo della sitemap. Scegli Altro come Categoria, scegli il Canale e fai clic su Invia.
Una finestra intitolata URL della sitemap elenca le pagine trovate. Spunta le pagine da cui il bot deve imparare, poi fai clic su OK.

Buono a sapersi:

Scegli le pagine su cui i clienti fanno domande, come prezzi, servizi, consegne, domande frequenti e contatti. Lascia fuori pagine come vecchie offerte o articoli del blog: possono dare al bot informazioni superate o fuori tema.
La finestra mostra 100 pagine alla volta. Seleziona tutto spunta solo le pagine che vedi, quindi vai alla pagina successiva dell’elenco per spuntarne altre.
Ogni pagina diventa una voce a sé e viene letta come una pagina aggiunta con Aggiungi tramite sito web.
Usa una sitemap che elenca pagine. Molti siti web hanno una sitemap principale che elenca solo altre sitemap, spesso chiamata sitemap_index.xml. Aprila nel browser: se elenca altri indirizzi .xml invece di pagine, usa quella delle tue pagine.
Se Wabot non trova pagine nella sitemap, vedrai Inserisci un URL di sitemap valido.

Importa i prodotti dal tuo negozio online

Se vendi tramite Shopify o Wix, Wabot può copiare i tuoi prodotti nelle conoscenze. Il bot può così rispondere a domande come “Avete questo vestito nella taglia M?” e mostrare il prodotto.

Collega il tuo negozio in Impostazioni → Integrazioni. Vedi Shopify o Wix.
Apri l’integrazione del negozio e vai nella scheda Automazione.
Scegli il tuo account in Seleziona l’account WhatsApp Business.
Nella scheda Sincronizzazione dei prodotti, fai clic sull’icona di sincronizzazione (Fai clic per sincronizzare i prodotti).
Attendi qualche minuto. Se Conoscenza degli agenti è aperta, mostra Documenti indicizzati quando la sincronizzazione è terminata. Poi chiedi informazioni su un prodotto in Prova bot per verificare.

Buono a sapersi:

Il bot propone solo prodotti disponibili in magazzino.
I prodotti WooCommerce non possono essere sincronizzati in questo modo.
Se vedi Aggiungi tramite negozio online in Altri modi per aggiungere, usa invece Sincronizzazione dei prodotti.

Aggiungi tramite workflow

Aggiungi tramite workflow esegue una volta uno dei tuoi workflow manuali. Aggiunge conoscenze solo se quel workflow è costruito per farlo. Alla maggior parte delle attività non serve.

Fai clic su Altri modi per aggiungere → Aggiungi tramite workflow.
In Seleziona un workflow, scegli il workflow. Puoi scegliere solo workflow manuali attivi.
In Impostazioni di automazione, scegli il numero in Seleziona un’impostazione.
Fai clic su Trigger. Vedrai Elaborazione in corso, attendi…

Quale categoria scegliere

Ogni voce ha una Categoria: Prodotto o Altro. La categoria decide quali domande possono trovare la voce:

Quando un cliente chiede di un prodotto, il bot guarda solo i prodotti sincronizzati dal tuo negozio e disponibili in magazzino.
Per tutte le altre domande, come orari di apertura, consegne, servizi, prezzi o condizioni, il bot guarda solo le voci in Altro.

Quindi scegli Altro per tutto ciò che aggiungi tu, anche per la descrizione di un prodotto o un listino prezzi. Una voce che aggiungi tu con Prodotto non viene quasi mai trovata.

Se non sincronizzi i prodotti da un negozio, il bot potrebbe non riuscire a rispondere alle domande che considera domande sui prodotti, come “Avete pane senza glutine?”. In quel caso invia il tuo messaggio di fallback.

Il Canale di una voce

Il Canale decide nell’elenco di quale numero compare una voce e quali voci vedi quando scegli i documenti per un bot. Non limita la voce a quel numero: tutti i bot del tuo account possono usare tutte le voci.

Per limitare un bot a certe voci, selezionale nella Configurazione dei dati del bot. Ad esempio, un’attività con un numero per la panetteria e uno per il catering può selezionare solo le voci della panetteria per il bot della panetteria, così non comunica i prezzi del catering.

Allegati: file e pulsanti che il bot può inviare

Quando aggiungi conoscenze con Aggiungi info, puoi allegare elementi che il bot invia con la sua risposta: la foto di una torta, un listino prezzi in PDF o un pulsante che apre la tua pagina di prenotazione.

Nel modulo Aggiungi info, fai clic su Aggiungi allegato.
Scegli il Tipo di allegato e compila i suoi dettagli (vedi la tabella qui sotto).
Compila Quando inviare questo allegato, ad esempio Quando il cliente chiede il listino prezzi o il menu.

Tipo	Cosa riceve il cliente
Immagine	L’immagine, con la risposta del bot come didascalia.
Video o Documento	Il file, con la risposta del bot come didascalia.
Call to action	La risposta con un pulsante che apre un link. Compila il Testo visualizzato del pulsante e l’URL.
Risposta rapida	La risposta con un massimo di 3 pulsanti (Pulsante 1, Pulsante 2…). Quando il cliente ne tocca uno, il bot riceve il testo del pulsante come suo messaggio.
Carosello	Uno dei tuoi modelli a carosello. Scegli il Modello, poi modifica ogni scheda in Configura le schede del carosello.

Per immagini, video e documenti, fai clic su Carica per scegliere il file dalla tua Libreria media.

Buono a sapersi:

Compila sempre Quando inviare questo allegato. Senza, il bot non invia mai l’allegato.
Il bot invia solo un allegato che appartiene a una voce usata per la risposta.
Il bot non legge gli allegati. Un listino prezzi in PDF viene inviato al cliente, ma il bot non può rispondere in base a quel file. Scrivi le informazioni anche nella Descrizione.
Dai a ogni allegato un Quando inviare questo allegato chiaro e diverso, così viene inviato quello giusto. Quando più allegati sono adatti, il bot può inviarne solo uno.
L’elenco mostra anche Modulo e Catalogo. Il bot non li invia: il cliente riceve solo la risposta di testo.

Scrivi informazioni che il bot può usare

Quando un cliente chiede qualcosa, il bot cerca le voci il cui significato è più vicino alla domanda e risponde in base a quelle. Le voci chiare e precise vengono trovate e danno buone risposte. Quelle vaghe no.

Un argomento per voce. Crea voci separate per consegne, resi e orari di apertura. Una voce lunga che parla di tutto è più difficile da abbinare.
Scrivi come in una FAQ. Comincia con la domanda che fanno i clienti, poi rispondi.
Scrivi tutti i dettagli. Prezzi con la valuta, giorni e orari, zone, condizioni ed eccezioni. Il bot non colma i vuoti al posto tuo.
Usa le parole dei tuoi clienti. Se dicono “consegna a domicilio” e “spedizione”, usale entrambe.
Fai in modo che ogni voce stia in piedi da sola. Evita “vedi sopra” o “come già detto”: il bot può leggere una voce senza le altre.
Tieni una sola versione di ogni informazione. Quando un prezzo cambia, modifica la voce. Due voci con prezzi diversi confondono il bot.
Aggiungi i tuoi contatti (telefono, email, indirizzo e orari di apertura) in una voce, così il bot può dire ai clienti come raggiungerti.

Esempi:

Voce debole	Voce migliore
Consegna disponibile. Costi applicabili.	Fate consegne? Sì. Consegniamo torte e pane entro 8 km dal nostro negozio, dal martedì alla domenica, dalle 10 alle 19. La consegna costa ₹60 ed è gratuita per ordini superiori a ₹1.000. Ordina entro le 18 del giorno prima.
Facciamo torte di ogni tipo.	Che torte potete fare? Torte di compleanno, nuziali e con foto, al cioccolato, alla vaniglia, red velvet e al caramello. Tutte le nostre torte sono senza uova. Le torte personalizzate richiedono 2 giorni di preavviso e partono da ₹900 al kg.
Orari della clinica come da calendario.	Quando è aperta la clinica? Dal lunedì al venerdì dalle 9 alle 19, e il sabato dalle 9 alle 13. Siamo chiusi la domenica e nei giorni festivi. Per un’emergenza dentistica fuori da questi orari, chiama il nostro numero di emergenza 020 7946 0000.
Resi: vedi la pagina delle condizioni.	Posso restituire o cambiare un articolo? Sì, entro 30 giorni dalla consegna, se non è stato indossato e ha ancora le etichette. I cambi taglia sono gratuiti. I rimborsi tornano sul metodo di pagamento originale entro 7 giorni lavorativi. Gli articoli in saldo si possono cambiare ma non rimborsare.

Imposta l’identità dell’agente

Ogni numero ha un’identità dell’agente: chi è il bot e per quale attività parla. Compare in alto in Conoscenza degli agenti, con i pulsanti Modifica identità e Cancella identità. Se hai più di un numero, scegli prima il numero nel filtro Canale. Se non vedi l’identità, chiedi l’autorizzazione all’amministratore del tuo account.

Fai clic su Modifica identità. Si apre il modulo Impostazioni di conoscenza dell’agente.

Campo	Cosa cambia	Esempio
Canale	Il numero a cui appartiene questa identità.	Il numero WhatsApp del tuo negozio
Nome dell’azienda	L’attività per cui parla il bot. Viene usato su questo numero, anche quando risponde un bot IA.	Sweet Crumb Bakery
Comportamento	Il tono, quando per il numero non è configurato nessun bot IA. Scegli Cordiale, Professionale, Informale, Formale, Empatico, Assertivo, Informativo, Neutro, Risolutore di problemi o Allegro.	Cordiale
Ruolo	Il lavoro che fa il bot, quando non è configurato nessun bot IA.	Assistenza clienti per gli ordini di torte
Nome dell’agente IA	Il nome con cui si presenta il bot, quando non è configurato nessun bot IA.	Maya
Altri dettagli	Brevi informazioni sulla tua attività. Vengono usate su questo numero, anche quando risponde un bot IA.	Panetteria di famiglia a Pune dal 2009. Tutte le nostre torte sono senza uova.

Fai clic su Salva impostazioni. Vedrai Identità dell’agente aggiornata.

Come viene usata l’identità:

Nome dell’azienda e Altri dettagli vengono usati su questo numero anche quando risponde un bot IA. Compilali anche se usi i bot IA.
Nome dell’agente IA, Ruolo e Comportamento vengono usati solo quando non risponde nessun bot IA: quando il numero non ha un bot IA predefinito, o quando un workflow passa la chat all’opzione che finisce con (predefinito). Quando risponde un bot IA, usa invece il proprio nome, Reparto e Comportamento.
L’identità non ha istruzioni, messaggio di fallback né scelta dei documenti. Per queste cose, crea un bot IA.
Tieni le informazioni che chiedono i clienti (prezzi, orari, condizioni) nelle voci di conoscenza, non in Altri dettagli. Il bot cerca le risposte nelle voci.

Cancella identità svuota nome, azienda, ruolo, comportamento e altri dettagli per quel numero.

Stato, modifiche e rimozione

Ogni voce dell’elenco è contrassegnata come Indexed (indicizzata). Indicizzare significa che Wabot ha preparato il testo in modo che il bot possa cercarci dentro. Le voci ancora in lettura, o che non è stato possibile leggere, non compaiono proprio nell’elenco. Le voci scritte a mano sono pronte subito; le pagine di siti web e sitemap possono richiedere un paio di minuti.

Ogni voce mostra anche da dove viene: Sito web, Sitemap, oppure User Input per le voci scritte con Aggiungi info.

Su una voce:

Modifica (voci scritte a mano) riapre il modulo, così puoi cambiare il testo.
Sincronizza (pagine di siti web e sitemap) rilegge la pagina.
Elimina rimuove la voce.

Se dopo aver modificato o sincronizzato una voce il bot usa ancora il vecchio testo, o se una voce resta nell’elenco dopo che l’hai eliminata e hai aggiornato la pagina, contatta l’assistenza.

Se un bot usa solo documenti selezionati, dopo aver modificato o sincronizzato una voce selezionala di nuovo nella Configurazione dei dati del bot.

Altri modi per aggiungere → Reimposta info rimuove tutte le voci del tuo account, per tutti i tuoi numeri. L’operazione non può essere annullata. Se dopo il bot usa ancora vecchie risposte, contatta l’assistenza.

Quanto costa l’indicizzazione

L’indicizzazione delle tue conoscenze usa l’IA, e lo stesso vale per la ricerca al loro interno ogni volta che il bot risponde. A meno che tu non usi una tua chiave OpenAI, questi costi possono essere addebitati sul tuo portafoglio. Sono elencati insieme agli altri addebiti IA nella pagina Portafoglio (Impostazioni → Prezzi → Portafoglio), in Cronologia del portafoglio → Utilizzo.

Con una tua chiave OpenAI in Provider IA, indicizzazione e ricerca usano la tua chiave. Una chiave Anthropic Claude o Azure OpenAI non copre l’indicizzazione, quindi quei costi vengono comunque addebitati sul tuo portafoglio.