Documentazione

Webflow

Aggiungi il tuo agente a un sito Webflow usando Custom Code in Project Settings.

Aggiungi il tuo agente AI a qualsiasi sito Webflow incollando il codice di embed in Project Settings → Custom Code. Lo snippet si carica automaticamente su ogni pagina.

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

Quick Setup

  1. Apri il tuo progetto nel Webflow Designer.
  2. Clicca sull'icona a forma di ingranaggio (Project Settings) nella barra laterale sinistra.
  3. Vai alla scheda Custom Code.
  4. Scorri fino a Footer Code (il campo etichettato Before </body> tag).
  5. Incolla il codice di embed.
  6. Clicca su Save Changes.
  7. Clicca su Publish in alto a destra per pubblicare il sito live.

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

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

Lo script del widget è pensato per caricarsi dopo che la pagina è diventata interattiva. Incollarlo in Footer Code evita di bloccare il rendering iniziale ed è coerente con il comportamento dell'attributo async.

Plan Requirements

La disponibilità di Custom Code dipende dal livello del tuo Site plan. Webflow ha storicamente limitato il codice personalizzato a livello di sito sul piano gratuito Starter, e la disponibilità è cambiata tra le varie revisioni dei piani.

Consulta il confronto dei piani di Webflow su https://webflow.com/pricing per le regole attuali. Se la scheda Custom Code mostra un'icona di lucchetto o il campo Footer Code è disabilitato, esegui l'upgrade del Site plan.

Page-Specific Install

Per caricare il widget solo su alcune pagine:

  1. Apri la pagina nel Designer.
  2. Clicca sull'icona a forma di ingranaggio Page Settings su quella pagina.
  3. Scorri fino a Custom Code → Before </body> tag.
  4. Incolla lì il codice di embed, invece che nel campo a livello di progetto.

Il codice a livello di pagina si aggiunge e ha priorità su quello a livello di progetto per quella pagina specifica.

After Publishing

Il codice personalizzato viene eseguito solo sul sito pubblicato, non nell'anteprima del Designer. Dopo aver salvato, clicca su Publish e scegli i tuoi domini:

  • *.webflow.io — il dominio di staging
  • Il tuo dominio personalizzato connesso (se presente)

Pubblica sul dominio su cui vuoi effettivamente fare il test.

Troubleshooting

Il widget non appare nell'anteprima del Designer.

  • Previsto. Custom Code viene eseguito solo sul sito pubblicato. Apri l'URL live.

Il widget non appare nemmeno sul sito live.

  • Verifica di aver cliccato su Save Changes e su Publish.
  • Verifica che il tuo dominio sia autorizzato in Chatbot > Publish > Security.
  • Esegui un hard refresh (⌘+Shift+R) per ignorare la cache CDN.

Il campo Custom Code è disabilitato.

  • Il tuo Site plan non include Custom Code. Esegui l'upgrade su https://webflow.com/pricing.

Testing

  1. Apri il sito pubblicato in una finestra in incognito.
  2. Cerca la bolla della chat.
  3. Clicca per aprirla e invia un messaggio di prova.

Next Steps