Documentazione

Squarespace

Aggiungi il tuo agente a un sito Squarespace usando Code Injection.

Aggiungi il tuo agente AI a un sito Squarespace tramite Code Injection — il sistema nativo di Squarespace per inserire script in tutto il sito. Richiede circa un minuto.

Per prima cosa, ottieni il codice di embed da Chatbot > Publish nella dashboard.

Quick Setup

  1. Apri la Dashboard del tuo sito Squarespace.
  2. Vai su Settings → Website Tools → Code Injection. (Sui siti meno recenti potresti trovarla in Settings → Advanced → Code Injection.)
  3. Incolla il codice di embed nel campo Footer (non nel campo Header — il widget deve caricarsi dopo il rendering della pagina).
  4. Clicca su Save.
  5. Apri il tuo sito live — il widget appare entro pochi secondi.

Formato di esempio (usa i valori reali da Chatbot > Publish):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>

Plan Requirements

Code Injection è una funzionalità a pagamento:

  • Disponibile sui piani Core, Plus e Advanced. Anche i piani legacy Business (e le versioni precedenti nel frattempo rinominate) la includono.
  • Il piano Basic (in precedenza Personal) non supporta Code Injection. Il pannello resta disabilitato finché non passi a un piano superiore.

Passa a un piano superiore da Billing → Plans nella dashboard di Squarespace.

Page-Specific Install

Code Injection si applica a tutto il sito. Per caricare il widget su una sola pagina, usa invece un Code Block in quella pagina:

  1. Modifica la pagina.
  2. Aggiungi un nuovo blocco Code.
  3. Incolla il codice di embed.
  4. Salva.

Il widget si caricherà solo su quella pagina.

Checkout Pages

Squarespace non esegue Code Injection sulle pagine di checkout native. Il widget non apparirà durante il checkout. Se ti serve assistenza durante il checkout, aggiungi un link nell'email di conferma dell'ordine oppure usa un Code Block sulle pagine che precedono il checkout.

After Saving

Le modifiche a Code Injection hanno effetto immediato sul sito live. Non è previsto un passaggio di pubblicazione separato.

Troubleshooting

Il widget non appare su nessuna pagina.

  • Verifica che lo snippet sia nel campo Footer, non in Header.
  • Verifica di aver cliccato su Save dopo aver incollato il codice.
  • Verifica che il tuo dominio sia autorizzato in Chatbot > Publish > Security.
  • Esegui un hard refresh (⌘+Shift+R) per ignorare la cache del browser.

Il widget non appare al checkout.

  • Previsto — Squarespace non esegue Code Injection nei flussi di checkout.

Il pannello Code Injection è disabilitato.

  • Sei sul piano Basic (in precedenza Personal). Passa a Core, Plus o Advanced.

Il piano è passato a un livello inferiore — ora lo snippet è ancora salvato ma non viene eseguito.

  • Squarespace mantiene visibili gli snippet salvati dopo un downgrade, ma smette di eseguirli. Passa di nuovo a un piano superiore, oppure aggiungi nuovamente il widget tramite un Code Block sulle pagine dove ti serve.

Testing

  1. Apri l'URL del tuo sito in una finestra in incognito.
  2. Cerca la bolla della chat.
  3. Clicca per aprirla e invia un messaggio di prova.

Next Steps