Inviare alla tua agenzia web

Se un'agenzia, un freelance o il tuo team IT gestisce il tuo sito, invia loro il codice di incorporamento con questo messaggio già pronto.

Non serve che sia tu a installare il widget. Se qualcun altro gestisce il tuo sito, invia il codice di incorporamento a chi se ne occupa: aggiungerlo richiede pochi minuti. Questa pagina contiene un messaggio da copiare e i dettagli tecnici che potrebbero chiederti.

Passaggio 1: Copia il codice di incorporamento

In botts.ai apri Agenti, scegli il tuo agente, passa alla scheda Implementa e apri il deployment Sito Web. La sezione Installazione in fondo all'editor mostra il codice con un pulsante per copiarlo. Non hai ancora un deployment sito web? Vedi Deployment.

Il codice di incorporamento è fatto così, con la chiave del tuo deployment al posto di YOUR_API_KEY:

<script async src="https://api.botts.ai/widget/chat-widget.js?key=YOUR_API_KEY"></script>

Passaggio 2: Invia questo messaggio

Copia il messaggio, sostituisci la riga segnaposto con il tuo codice di incorporamento e invialo a chi gestisce il tuo sito.

Oggetto: Aggiungere il widget di chat botts.ai al sito

Buongiorno,

vi chiediamo di aggiungere il nostro widget di chat botts.ai al sito.
È un singolo tag script da caricare su ogni pagina, idealmente subito
prima del tag di chiusura body (funziona anche nell'head della pagina):

[incolla qui il codice di incorporamento]

Alcune note:
- Incollate il codice senza modificarlo. La chiave appartiene al
  nostro chatbot.
- Lo script si carica in modo asincrono e non blocca il rendering
  della pagina.
- Se il sito usa uno strumento di consenso, una cache o un
  ottimizzatore di script, assicuratevi che non blocchi o ritardi
  lo script.
- Dettagli tecnici: https://botts.ai/docs/it/install-web-agency

Grazie!

Passaggio 3: Controlla il widget quando è online

Quando ti confermano l'installazione, apri il tuo sito pubblico in una finestra privata e ricarica la pagina. Il pulsante della chat compare in basso a destra, o dove l'hai posizionato nell'editor del widget. Aprilo e invia una domanda di prova.

Se il widget non compare, controlla che il deployment sia attivo nella scheda Implementa e prova senza ad blocker. Se ancora non compare, chiedi alla tua agenzia di controllare i punti indicati nel messaggio.

Colori, testi e tutte le altre impostazioni del widget si modificano poi in botts.ai, senza coinvolgere di nuovo la tua agenzia. Il codice sul sito va sostituito solo se cambia la chiave del deployment.

Dettagli tecnici per sviluppatori

• Cos'è: un unico script esterno, https://api.botts.ai/widget/chat-widget.js, identificato dal parametro key. La chiave è pubblica e vale solo per questo deployment sito web: può stare nel codice sorgente della pagina.
• Dove: su ogni pagina in cui deve comparire il widget, idealmente subito prima del tag di chiusura </body>. Lo script attende DOMContentLoaded, carica le impostazioni del widget e poi aggiunge il widget al body, quindi funziona anche nell'head. Caricalo una sola volta per pagina.
• Come si presenta: lo script aggiunge al body un elemento, div#bottsai-widget-root. Nel suo shadow root mostra il launcher (position: fixed, z-index: 9999) e un iframe che carica la finestra della chat da https://api.botts.ai.
• Memoria del browser: il widget salva poche piccole voci nel localStorage del sito: lo stato aperto/chiuso (bottsai_window_state, bottsai_has_interacted), l'ID della conversazione in corso (botts_conv__ più l'ID del deployment) e se il launcher a scheda è stato ridotto (bottsai_launcher_dismissed__ più l'ID del deployment). La conversazione è salvata da botts.ai. Lo script non imposta cookie sul sito.
• Content Security Policy: se il sito invia un header CSP, consenti https://api.botts.ai in script-src, connect-src e frame-src, e 'unsafe-inline' in style-src. Lo script scrive i propri stili nello shadow root del widget e non supporta i nonce. Senza questa regola il launcher perde lo stile e la finestra della chat compare in fondo al contenuto della pagina. Se il launcher mostra un logo caricato, consenti anche https://s3.pub2.infomaniak.cloud in img-src. Con require-trusted-types-for 'script' il widget non viene mostrato.
• Voce: se la Voce IA è attiva per il widget, l'iframe della chat usa il microfono (è incorporato con allow="microphone"). Se il sito invia un header Permissions-Policy con microphone=(), cambialo in microphone=(self "https://api.botts.ai"). Altrimenti la voce non funziona, mentre la chat testuale sì.
• Se non compare nulla: controlla le richieste di rete negli strumenti per sviluppatori del browser. Un 404 per chat-widget.js significa che la chiave non corrisponde a nessun deployment sito web attivo: è stata modificata durante l'incollaggio, oppure il deployment è disattivato con il suo interruttore nella scheda Implementa di botts.ai.
• Guide per piattaforma: WordPress, Wix, Squarespace, Shopify, Webflow, Jimdo, TYPO3, Google Tag Manager.
• Rimozione: cancella il tag script. Sul sito non viene installato nient'altro.

Ultimo aggiornamento: 4 ottobre 2026