Troubleshooting & FAQ
Il widget Audin non appare, problemi di iframe/CSP, eventi non ricevuti — diagnosi passo-passo e risposte alle domande frequenti.
Versione Markdown di questa pagina
Scarica o copia il contenuto di questa pagina in formato .md — utile per fornirlo a un agente AI che integra questa specifica feature.
Questa pagina raccoglie le situazioni più comuni nell'integrazione del widget e come risolverle, più una FAQ finale.
Il widget non appare
È il caso più frequente. Controlla nell'ordine:
Lo snippet è prima di </body>?
Lo snippet va incollato prima della chiusura del tag </body>, su ogni pagina
in cui vuoi il widget. Se è in un punto in cui non viene eseguito (o non è presente
nel template effettivo della pagina), il widget non si carica.
Il data-widget-id è corretto?
Verifica che il data-widget-id nello snippet corrisponda esattamente a quello
del widget nel dashboard (app.audin.ai), senza il placeholder IL-TUO-WIDGET-ID
lasciato per errore. Se manca, in console vedrai un errore come
[AudinChat] Missing data-widget-id (o [AudinEmbed] ...).
init() viene davvero chiamato?
Il widget si attiva solo quando chiami init(). Nello snippet standard ciò avviene
nell'handler onload del loader (w.AudinChat.init() o w.AudinEmbed.init()). Se
hai modificato lo snippet, assicurati che init() sia effettivamente invocato dopo
il caricamento dello script.
(Embedded) il container data-target esiste?
In modalità embedded il <div> puntato da data-target deve esistere nel DOM al
momento dell'inizializzazione. Se manca, in console compare
[AudinEmbed] Target container not found: <selettore>. Verifica che il selettore di
data-target corrisponda all'id del container e che il <div> abbia dimensioni
(altezza/larghezza) non nulle.
Problemi di iframe / CSP
Il widget è caricato dentro un iframe servito da https://widget.audin.ai. Se il
tuo sito ha una Content Security Policy restrittiva, lo script o l'iframe possono
essere bloccati: in console vedrai errori di CSP che citano script-src, frame-src
(o child-src) o connect-src.
Per risolvere, consenti https://widget.audin.ai nelle direttive pertinenti (vedi la
nota su iframe/CSP).
Se non usi alcuna CSP, di norma non serve alcuna configurazione.
Gli eventi non vengono ricevuti
Se le tue callback su on(...) non scattano:
- Iscriviti all'evento giusto per la modalità. L'embedded (
AudinEmbed) emette solomessage:open/closenon vengono mai emessi inline. Solo il popup (AudinChat) emetteopen/close. Vedi la tabella in API & eventi. - Usa l'oggetto giusto. Iscriviti su
AudinChatper il popup e suAudinEmbedper l'embedded; non sono intercambiabili. - Controlla il nome dell'evento. I nomi sono
message,open,close(tutto minuscolo). Un nome diverso non genera errori ma non riceve mai callback. - Iscriviti dopo che lo script è caricato. L'oggetto
window.AudinChat/window.AudinEmbedesiste solo dopo che il loader ha caricato lo script: registra i listener nello stesso punto in cui chiamiinit()(es. nell'onload).