Sviluppatori

Installa il tuo widget di chat IA

Un solo tag script aggiunge una bolla di chat al tuo sito. I visitatori la cliccano, fanno una domanda e ricevono una risposta dal tuo agente — basata sulla tua base di conoscenza. Niente da ospitare, niente da mantenere.

Cos'è il widget

Una piccola bolla di chat fluttuante che appare sul tuo sito. Quando un visitatore la clicca, parla con il tuo agente Engadi AI — lo stesso agente che il nostro team ha configurato e addestrato sui tuoi documenti, con le stesse regole di sicurezza e di escalation verso un umano. Nessun server da eseguire, nessun codice da mantenere da parte tua.

Ottieni il tuo snippet

Il tuo referente Engadi o la pagina I miei agenti del tuo portale ti fornisce uno snippet già pronto con il tuo token reale già inserito. Ha questo aspetto, ma con un token reale al posto del segnaposto qui sotto:

<script src="https://www.engadi.com/widget.js" data-agent="wgt_XXXX" async></script>

Questo token identifica il tuo agente — non è una password segreta, ma trattalo come tuo e incollalo solo nel tuo sito.

Installazione per piattaforma

WordPress (senza plugin)

Aspetto → Editor dei file del tema, oppure installa un piccolo plugin per script header/footer (ad esempio "WPCode"), poi incolla lo snippet subito prima del tag di chiusura </body>.

Preferisci un'installazione con un clic? Usa il nostro plugin WordPress Engadi AI Agent dedicato: caricalo da Plugin → Aggiungi nuovo → Carica plugin, poi incolla il tuo token in Impostazioni → Engadi AI Agent.

Scarica il plugin WordPress (.zip)

Wix

Impostazioni → Codice personalizzato → Aggiungi codice → incolla lo snippet, applicalo a "Tutte le pagine", posizione "Body – end".

Squarespace

Impostazioni → Avanzate → Iniezione di codice → incolla lo snippet nel campo Footer.

Webflow

Impostazioni del progetto → Codice personalizzato → Footer Code (per tutto il sito), oppure l'impostazione "Before </body> tag" di una singola pagina.

HTML puro / altro

Incolla lo snippet subito prima del tag di chiusura </body> del tuo modello di pagina.

<script src="https://www.engadi.com/widget.js" data-agent="wgt_XXXX" async></script>

Imposta la lingua (opzionale)

Per impostazione predefinita il widget segue la lingua del browser del visitatore. Per forzare una lingua specifica, aggiungi un attributo data-locale impostato su uno tra en, es, fr, it o pt.

<script src="https://www.engadi.com/widget.js" data-agent="wgt_XXXX" data-locale="es" async></script>

Se il tuo sito usa una Content-Security-Policy

La maggior parte dei siti di piccole imprese e organizzazioni non profit non ha una CSP personalizzata e può saltare questa sezione. Se il tuo sito ce l'ha, aggiungi engadi.com a queste due direttive:

script-src  ... https://www.engadi.com ;
frame-src   ... https://www.engadi.com ;

Senza questo, una CSP rigida blocca silenziosamente il widget — nessun errore viene mostrato ai tuoi visitatori, la bolla di chat semplicemente non compare mai.

Privacy e consenso (GDPR)

Nel momento in cui un visitatore condivide un nome o un'email nella chat, si tratta di dati personali. Due cose da fare: menziona l'assistente di chat IA nella tua informativa sulla privacy, e non raccogliere dati personali prima che il visitatore scelga di interagire con la chat.

Scopri come trattiamo i dati nella nostra Informativa sulla privacy

Risoluzione dei problemi

La bolla di chat non compare

Verifica che lo snippet sia posizionato prima del tag di chiusura </body>, che nessun ad-blocker sul tuo browser di test lo stia nascondendo, e che la Content-Security-Policy del tuo sito (se presente) consenta engadi.com — vedi la sezione CSP sopra.

Il widget è nella lingua sbagliata

Aggiungi o correggi l'attributo data-locale sul tag script — accetta en, es, fr, it o pt.

Compare "Chat unavailable" o l'agente ha raggiunto la capacità massima

Il tuo agente potrebbe essere temporaneamente in pausa, oppure ha raggiunto il limite di conversazioni del suo piano per il mese. Contattaci e risolveremo la cosa.

Hai bisogno di una mano per l'installazione?

Rispondi alla tua email di benvenuto, oppure prenota una chiamata — saremo felici di aiutare te o il tuo sviluppatore web.

Prenota una chiamata