Guida completa: cosa fa il tuo chatbot IA (e come usarlo al meglio)

Come funziona oggi AI Orchestrator Agency: chat contestualizzata sul sito, prenotazioni con slot reali da Google Calendar nel widget, snippet di incorporamento, profilo e buone pratiche — con istruzioni concrete per mettere il bot sul tuo sito.

Di AI OrchestratorGuida prodotto

Cosa fa il chatbot oggi, in sintesi? Analizza il tuo sito, genera un assistente coerente con brand e contenuti, risponde ai visitatori 24/7 in multilingua e — quando colleghi Google Calendar dal profilo — mostra slot liberi reali e permette di prenotare un appuntamento dal widget, con evento creato sul calendario. Non è un ecommerce bot: è pensato per servizi, consulenze, demo e prenotazioni.

Nota: in passato si enfatizzava molto il “lead detection” (email/telefono). Il flusso principale ora è prenotazione guidata + chat sul sito; i contatti restano utili dove serve, ma il percorso che vogliamo far provare in demo è il calendario integrato.

1. Analisi del sito e generazione del chatbot

Quando invii il modulo di richiesta (dopo accesso e, se richiesto, collegamento calendario), la piattaforma legge i contenuti del sito e costruisce un chatbot contestualizzato sul tuo business.

Cosa succede in questa fase:

  • Estrae e indicizza le pagine per la base di conoscenza (testo coerente con il sito, non risposte generiche inventate)
  • Applica le opzioni di stile (tema, titolo, messaggio di benvenuto, font, logo)
  • Crea un’istanza pronta da incorporare e lo snippet nel Profilo

Tempi tipici:

  • La maggior parte delle richieste completa in circa 10–60 secondi, in base a dimensione e complessità del sito.

2. Dove trovi lo snippet e cosa contiene

Dopo la generazione, lo snippet è nel Profilo. È un unico blocco <script …></script> con:

  • data-ai-orchestrator-id — ID del tuo chatbot
  • data-api-key — URL dell’API (es. https://aiorchestrator-vtihz.ondigitalocean.app)
  • Attributi tema, testi, data-primary-language="auto", data-show-booking-first="true", eventuale logo

Non serve un backend tuo per la configurazione base: il widget parla con la nostra API.

Installazione “fai da te” (panoramica)

L’obiettivo è caricare una sola volta lo script in modo che sia presente su tutte le pagine dove vuoi il bot (di solito tutto il sito).

  1. Apri il Profilo e copia lo snippet intero.
  2. Incollalo nel punto giusto del sito (vedi sotto per CMS comuni).
  3. Pubblica la modifica e apri il sito in una finestra anonima per verificare.
  4. Prova su mobile: il widget è in basso a destra; controlla che non copra il menu o il cookie banner.

Dove incollare lo snippet (dettaglio)

Regola generale: prima della chiusura </body> (footer globale), così la pagina è già caricata e il widget non rallenta il primo paint.

| Contesto | Dove incollare | |----------|-----------------| | Sito HTML statico | Nel file layout o index, prima di </body>. | | WordPress | Tema child: footer.php; oppure plugin “Insert Headers and Footers” / “Code Snippets” → solo footer; evita di metterlo nel contenuto di una singola pagina se vuoi il bot ovunque. | | Webflow | Project Settings → Custom Code → Footer Code. | | Wix | Settings → Custom Code → Body - end. | | Squarespace | Settings → Advanced → Code Injection → Footer. | | Shopify (tema classico) | Online Store → Themes → Edit code → theme.liquid prima di </body> (per store di servizi; per Shopify App Embed si usa il flusso app se applicabile). | | Google Tag Manager | Tag Custom HTML con lo snippet, trigger All Pages (o solo le URL che preferisci), poi pubblica il contenitore. |

Sicurezza e cookie: se usi un banner cookie, imposta lo script in modo che il widget si carichi dopo il consenso marketing/analytics se la tua policy lo richiede (GTM con trigger su consenso è la strada più comune).

Installazione premium (aziende serie)

Per clienti che non vogliono toccare codice, offriamo messa in opera sul sito come servizio: ci fornisci accesso temporaneo al CMS / GTM / repo o lavoriamo con il tuo webmaster e pubblichiamo noi lo snippet, con test su staging se disponibile.

3. Google Calendar e prenotazioni (flusso principale)

Collegamento: dal Profilo, OAuth Google Calendar (revocabile in qualsiasi momento dalla console Google).

Cosa vede il visitatore:

  • Slot reali calcolati sulle tue disponibilità e sulle regole che imposti (finestre orarie, giorni, ecc. dove supportato).
  • Selezione data/orario nel widget, con conferma.
  • Evento sul calendario con i dati utili al contatto (secondo configurazione e flusso di booking).

Dashboard: dal profilo puoi tenere traccia degli appuntamenti generati dal widget.

La chat resta il canale per domande su servizi, pagine e brand, sempre ancorata ai contenuti del sito.

4. Supporto visitatori in tempo reale (chat)

Il chatbot può:

  • Rispondere 24/7 sul sito
  • Usare i contenuti pubblicati (meno allucinazioni su fatti del business quando il crawl è aggiornato)
  • Conversare in più lingue (lingua principale auto nello snippet: rilevazione in base al messaggio)

Riduci tempi di risposta e copertura al primo contatto anche quando l’utente non prenota subito.

5. Il profilo come centro di controllo

Dal profilo gestisci:

  • Dati aziendali e di contatto
  • Piano attuale e utilizzo mensile
  • Copia dello snippet e anteprima stile
  • Connessione Google Calendar e disponibilità per le prenotazioni
  • Fatturazione (piani a pagamento)

Mantieni aggiornati sito, calendario e testi di benvenuto: il widget e il bot riflettono ciò che pubblichi.

6. Piani e utilizzo

  • Piano Free: limiti mensili sui messaggi; prenotazioni da calendario quando il calendario è collegato, nei limiti del piano.
  • Piano Pro: messaggi illimitati e più spazio per volumi alti.

Usa Free per validare, Pro per scalare.

7. Buone pratiche

  • Mantieni aggiornate le pagine servizio sul sito (prezzi, sedi, processi).
  • Scrivi un benvenuto chiaro su pubblico e prossimo passo (“Prenota una consulenza” / “Scegli uno slot”).
  • Aggiungi note nel modulo su tono, durata slot, tipi di appuntamento.
  • Controlla settimanalmente calendario e richieste.
  • Prova snippet su mobile e desktop dopo ogni modifica al tema.

8. Domande frequenti

Quanto velocemente posso andare live? Spesso in pochi minuti dopo la generazione: snippet, incolla nel footer, pubblica.

Non so incollare lo snippet. Usa la tabella sopra per il tuo CMS, oppure installazione premium con il nostro team.

Il bot sostituisce il modulo contatti? Può conviverci: molti utenti preferiscono prenotare subito invece di scrivere “mi richiamate”.

Posso aggiornare branding dopo? Sì: modifichi impostazioni e snippet dal profilo quando serve.

Sintesi

  1. Richiesta dal sito agency → chatbot generato sul tuo URL.
  2. Snippet dal Profilofooter / GTM (o installazione premium).
  3. Google Calendar collegato → slot e prenotazioni nel widget.
  4. Chat multilingua sul contenuto del sito.

Apri la sezione richiesta e avvia il flusso.