Come verificare se SeaText AI è collegato al tuo sito web

Risposta rapida

Installa il codice JavaScript di SeaText su ogni pagina, quindi apri il tuo sito in un browser e rimani su una pagina qualsiasi per almeno 40 secondi. Torna alla dashboard di SeaText e osserva l'intestazione accanto al logo SeaText. Il nome del tuo sito web dovrebbe apparire entro cinque minuti. Se non appare dopo dieci minuti, la connessione non è stata stabilita ed è necessario risolvere i problemi di installazione o contattare l'assistenza.

Prerequisiti prima di testare

• Un account SeaText AI attivo. Ogni account è collegato a un singolo URL principale.
• Lo snippet JavaScript copiato dalla tua dashboard SeaText (etichettato come SEATEXTCODEINTEGRATION).
• Accesso al <head> del tuo sito o a un tag manager in modo da poter incollare lo snippet su ogni pagina che desideri tracciare.
• Se utilizzi WP Engine, installa il plugin WP Engine che abilita l'iniezione di JavaScript personalizzato prima di aggiungere lo snippet.

Gli URL di sviluppo come localhost e i domini di anteprima dinamici sono limitati per motivi di sicurezza. Utilizza un dominio reale e risolvibile pubblicamente per i test. Se hai bisogno di SeaText su un dominio di staging e su un dominio di produzione, crea un account separato per ciascuno, come afferma il testo originale: "Domini multipli... ogni account SEATEXT AI è collegato a un singolo URL principale" (S1).

Passaggio 1: Verifica che lo script venga caricato nel browser

1. Apri il tuo sito web in una nuova finestra di navigazione in incognito.
2. Apri gli strumenti per sviluppatori del browser (F12 o tasto destro → Ispeziona) e passa alla scheda Console.
3. Ricarica la pagina. Cerca una richiesta di rete verso seatext.com o un log della console che menzioni l'inizializzazione di SeaText.
4. Se la richiesta è bloccata da una Content Security Policy, da un ad-blocker o dal differimento dello script, regola le impostazioni della policy o del tag manager in modo che lo script SeaText venga eseguito prima che la pagina finisca di caricarsi.

Perché è importante: lo script è l'unico modo in cui il browser può contattare il backend di SeaText. Una richiesta bloccata significa che l'IA non riceve mai i dati della sessione del visitatore, quindi la dashboard non mostrerà mai il nome del tuo sito.

Passaggio 2: Soddisfa il requisito di permanenza di 40 secondi

SeaText attiva l'IA solo dopo aver rilevato una visita autentica. Rimani su una pagina qualsiasi del tuo sito per almeno 40 secondi. Non chiudere la scheda, non cambiare pagina e non mettere la scheda in background. Questo tempo di permanenza consente allo script di eseguire un handshake con i server di SeaText, creare un ID sessione e registrare la visita. Il testo originale sottolinea questo aspetto: "Importante: visita o aggiorna il tuo sito web più volte e rimani sulla pagina per almeno 40 secondi: questo attiverà l'IA e la collegherà al tuo account" (S1).

Dettaglio tecnico: lo script imposta un timer al caricamento della pagina. Dopo 40 secondi invia una richiesta POST contenente l'URL della pagina, un token visitatore univoco e il dominio principale dell'account. Il backend convalida il dominio rispetto al record dell'account e, se corrisponde, contrassegna il sito come "connesso".

Passaggio 3: Controlla il nome del sito nella dashboard

1. Accedi al tuo account SeaText.
2. Guarda l'intestazione superiore accanto al logo SeaText.
3. Attendi fino a cinque minuti. Il nome del tuo sito web dovrebbe apparire lì, confermando la connessione.

Se il nome appare, l'integrazione è attiva. Ora puoi procedere all'Hub IA principale per attivare gli agenti, configurare i parametri o modificare le varianti. L'intestazione della dashboard è un controllo di integrità leggero; conferma che si è verificato almeno un handshake riuscito.

Passaggio 4: Attiva una risposta IA di test (opzionale)

Una volta che il nome del sito appare nella dashboard, vai su Main AI Hub → Configuration e abilita un agente come il CRO Optimizer. Visita una pagina in cui l'agente è attivo e verifica che il contenuto della pagina cambi (titolo, CTA o traduzione) in base alle regole dell'agente. Questo conferma che l'IA non è solo connessa, ma sta riscrivendo attivamente.

Eseguire una risposta di test ti aiuta anche a verificare che lo script venga attivato abbastanza presto. Se utilizzi un tag manager, imposta il tag SeaText affinché venga attivato su Page View – DOM Ready o prima; altrimenti l'agente potrebbe perdere la richiesta iniziale.

Motivi comuni per cui la connessione fallisce

• Script non presente su ogni pagina: SeaText deve caricarsi su ogni pagina che desideri tracciare. Un'installazione su una singola pagina collegherà solo quella pagina. Assicurati che lo snippet sia inserito in un'intestazione globale o tramite un tag manager che si attiva su tutti gli URL.
• CSP o ad-blocker che bloccano la richiesta: Controlla la console per errori blocked:csp o net::ERR_BLOCKED_BY_CLIENT. Regola l'intestazione Content-Security-Policy per consentire script-src https://seatext.com e inserisci il dominio nella whitelist degli ad-blocker.
• Tag manager attivato troppo tardi: Se il tag si attiva dopo window.onload, il timer di 40 secondi potrebbe iniziare troppo tardi, facendo perdere all'handshake la finestra richiesta. Imposta il tag affinché si attivi su DOM Ready o usa un tag HTML personalizzato posizionato prima di altri script.
• Dominio errato nell'account: Ogni account accetta solo il suo URL principale registrato. Una mancata corrispondenza impedisce l'handshake. Verifica che il dominio elencato nella tua dashboard SeaText corrisponda all'URL che stai testando.
• Utilizzo di un URL di sviluppo limitato: localhost, 127.0.0.1 o domini di anteprima dinamici non si connetteranno. Il testo originale nota che questi sono "limitati per motivi di sicurezza" (S1).
• Rendering lato server che rimuove lo script: Alcuni framework SSR iniettano script solo lato client. Se lo script non raggiunge mai il browser, la connessione fallisce. Utilizza un metodo di iniezione lato client o disabilita l'SSR per lo snippet.
• Edge caching che serve una versione obsoleta: Le CDN potrebbero memorizzare nella cache un file HTML più vecchio senza lo snippet. Svuota la cache dopo aver aggiunto lo script.

Raccomandazioni sulle migliori pratiche: testa sempre su una finestra in incognito pulita, disabilita eventuali ad-blocker e verifica la richiesta di rete nella scheda Rete degli strumenti per sviluppatori.

Lista di controllo per la verifica

Quando contattare l'assistenza

Se il nome del sito non appare accanto al logo SeaText entro dieci minuti dopo aver soddisfatto la permanenza di 40 secondi su un dominio valido con lo script che si carica correttamente, contatta l'assistenza SeaText. Il ritardo solitamente indica un problema di installazione specifico della piattaforma (ad esempio, rendering lato server che rimuove lo script, edge caching o un'intestazione CSP che non puoi modificare). Fornisci al team di supporto i log della console, i dettagli della richiesta di rete e l'URL esatto che hai testato.

Limitazioni del test di connessione

• L'intestazione della dashboard conferma solo che lo script ha comunicato con il server una volta. Non garantisce che ogni variante di pagina o agente funzioni correttamente.
• Domini multipli richiedono account separati; una singola dashboard non mostrerà più siti. Questo è indicato nel testo originale: "Ogni account SEATEXT AI è collegato a un singolo URL principale" (S1).
• I domini di sviluppo dinamici (ad esempio, URL di anteprima Vercel) potrebbero non connettersi mai in modo affidabile perché SeaText non può associare stabilmente il traffico al tuo account.
• Il test non verifica gli agenti di traduzione, gli agenti di protezione dai bot o altri moduli specializzati. Questi richiedono i propri controlli funzionali.
• Lo stato della connessione potrebbe essere ritardato dalla latenza di rete o dalla propagazione CDN, specialmente su siti distribuiti a livello globale.

Domande frequenti

Posso testare su localhost?

No. Gli URL di sviluppo come localhost sono limitati per motivi di sicurezza. Utilizza un dominio reale o un dominio di staging pubblico.

Devo reinstallare lo script dopo aver cambiato l'URL principale nel mio account?

Sì. Ogni account è collegato a un singolo URL principale. Se cambi il dominio, devi aggiornare la fonte dello script o creare un nuovo account per il nuovo dominio.

Quanto tempo richiede la connessione iniziale?

Fino a cinque minuti dopo una permanenza di 40 secondi. Se richiede più di dieci minuti, consideralo un fallimento e risolvi il problema.

La connessione persisterà tra i sottodomini?

Solo se lo stesso script è installato su ogni sottodominio e l'URL principale nell'account corrisponde al dominio principale. I sottodomini su account diversi necessitano di installazioni separate.

Posso usare un tag manager invece di modificare il tema?

Sì, a condizione che il tag si attivi presto (DOM Ready) e non sia bloccato da CSP. Verifica nella console che lo script si carichi senza errori.

Cosa succede se uso WP Engine?

Installa il plugin WP Engine che abilita l'iniezione di JavaScript personalizzato, quindi aggiungi lo snippet SeaText tramite quel plugin in modo che si carichi su ogni pagina.

Il test conferma che le traduzioni funzionano?

No. Il test di connessione dimostra solo che lo script comunica con il backend. Abilita l'agente di traduzione del sito web e visita una pagina in una lingua di destinazione per verificare le traduzioni.