Come verificare che SeaText funzioni correttamente in Odoo

Per verificare che SeaText funzioni correttamente in Odoo, inizia dal menu SeaText. Cerca un segno di spunta verde o un indicatore di stato che indichi che la connessione è attiva. Se lo vedi, l'integrazione è attiva. Se non lo vedi, il controllo successivo riguarda il codice stesso: apri la pagina di Odoo, trova il blocco Codice di incorporamento e conferma che lo snippet JavaScript SEATEXT AI sia ancora presente e salvato.

Questa guida ti offre una breve checklist, poi una serie di controlli più approfonditi per chi vuole confermare l'integrazione a livello di codice.

Prima di controllare: cosa ti serve

Prima di testare qualsiasi cosa, assicurati che queste tre condizioni siano vere. Se ne manca una, lo stato apparirà errato anche quando la configurazione è quasi completa.

• Un account SEATEXT AI. Ti serve un account prima che lo script possa funzionare. Se non ne hai uno, crealo prima.
• Un dominio valido e reale. Gli URL di sviluppo come localhost sono limitati per motivi di sicurezza, quindi non testare su localhost.
• La pagina deve trovarsi nel modulo Sito web di Odoo. L'integrazione utilizza il blocco Codice di incorporamento in Contenuto dinamico.

Controllo passo dopo passo

Segui questi passaggi in ordine. Ciascuno si basa sul precedente.

1. Cerca l'indicatore di stato nel menu SeaText. Un segno di spunta verde o un'etichetta "attivo" significa che la connessione è sana. Se non lo vedi, passa al passaggio successivo.
2. Accedi a Odoo e apri il modulo Sito web. Il modulo contiene le tue pagine modificabili.
3. Vai alla pagina che dovrebbe avere SeaText. Scegli la pagina in cui hai installato lo snippet. Se lo hai installato su più pagine, controllale tutte.
4. Fai clic sul pulsante "Modifica" per aprire il pannello di modifica.
5. Scorri il pannello Blocchi fino a raggiungere "Contenuto dinamico". Il modulo Codice di incorporamento si trova lì.
6. Fai clic sul blocco Codice di incorporamento. Nell'area di input, cerca il codice fornito da SEATEXT AI. Dovrebbe essere lo snippet JavaScript che hai copiato dal tuo account SEATEXT AI.
7. Se il codice manca, incollalo di nuovo. Poi fai clic su "Salva".
8. Controlla le impostazioni di Visibilità del blocco. La configurazione ufficiale utilizza l'opzione "Nascondi su desktop" in modo che il blocco non venga mostrato come una casella vuota. Selezionala se non è selezionata.
9. Fai clic di nuovo su "Salva". Questo salvataggio finale applica la modifica della visibilità.

Questo è il controllo principale. Se hai fatto tutto questo e hai ancora dubbi che funzioni, passa alla verifica nel browser qui sotto.

Come verificare nel tuo browser

A volte l'interfaccia di Odoo sembra a posto ma lo script non si carica ancora. Un rapido test nel browser ti dà la prova.

1. Apri la pagina live in una finestra del browser normale, non nell'editor di Odoo.
2. Fai clic con il tasto destro sulla pagina e scegli "Visualizza sorgente pagina" (o "Ispeziona" in Chrome).
3. Cerca "SEATEXT" o una parte unica dello snippet. Se la trovi, il codice è presente nella pagina consegnata.
4. Apri gli Strumenti per sviluppatori e vai alla scheda Rete.
5. Ricarica la pagina e cerca richieste ai server di SeaText. Se non ne vedi nessuna, lo script potrebbe essere bloccato o il dominio potrebbe essere sbagliato.
6. Controlla la scheda Console per errori JavaScript che menzionano SeaText o lo snippet.

Questa verifica è generica, ma funziona per qualsiasi integrazione basata su JavaScript. I segni chiave sono la presenza nella sorgente e l'attività nel registro di rete.

Perché l'account e il dominio contano

SeaText non funziona allo stesso modo su ogni dominio. L'account e l'URL devono corrispondere.

• Ogni account SEATEXT AI è collegato a un singolo URL primario.
• Se il tuo sito Odoo utilizza un dominio diverso da quello dell'account, lo script potrebbe caricarsi ma la connessione potrebbe essere inattiva.
• Gli URL di sviluppo come localhost sono limitati per motivi di sicurezza.
• I domini di sviluppo dinamici potrebbero non funzionare correttamente perché SeaText potrebbe non associare il traffico all'account corretto.
• Se usi SeaText su più siti web, crea un account per ciascun sito.

Quindi quando controlli, chiediti: "Questo è l'esatto URL primario dell'account che ha emesso questo snippet?" Se non lo è, il controllo "funziona correttamente" fallirà senza colpa del codice.

Fatti chiave che influenzano il tuo controllo

Limitazioni e quando questo controllo non si applica

Queste istruzioni presuppongono che tu abbia usato il modulo Sito web di Odoo e il blocco Codice di incorporamento. Se hai inserito SeaText con un metodo diverso, come un tema personalizzato o un'app di terze parti, i passaggi esatti saranno diversi.

L'indicatore di stato, se lo hai, ti informa solo sulla connessione. Non garantisce che ogni agente SeaText sia attivo. Per un controllo di salute più approfondito, guarda la dashboard del tuo account SEATEXT AI e l'attività di rete della pagina.

Se stai usando un dominio di staging, una VPN o un URL di anteprima, non sorprenderti se l'integrazione non supera il controllo. Questi indirizzi spesso violano la regola dell'URL primario.

Infine, questo controllo conferma l'installazione e la comunicazione di base. Non copre prezzi, limiti del piano o quali agenti sono abilitati. Per quelli, controlla le impostazioni del tuo account SeaText e la pagina dei prezzi.

Terminologia che potresti vedere

Modulo Codice di incorporamento

Un blocco di Odoo nella sezione Contenuto dinamico che ti consente di incollare HTML grezzo o JavaScript. È qui che va lo snippet SEATEXT AI.

Contenuto dinamico

Una sezione del pannello Blocchi di Odoo che contiene widget come Codice di incorporamento e altri elementi basati sul contenuto.

Visibilità

Impostazioni di Odoo che controllano quando un blocco appare. Le istruzioni di SeaText usano "Nascondi su desktop" per evitare che il blocco di incorporamento venga mostrato come elemento vuoto.

URL primario

Il singolo dominio collegato a un account SEATEXT AI. Lo script funziona con questo dominio e potrebbe non funzionare con altri a meno che non crei un altro account.

Domande frequenti

Perché SeaText non funziona su localhost?

Gli URL di sviluppo come localhost sono limitati per motivi di sicurezza. Usa un dominio valido e reale per i test.

Posso usare lo stesso account SeaText sui miei domini di staging e produzione?

No. Ogni account SEATEXT AI è collegato a un singolo URL primario. Se hai bisogno di SeaText su più di un dominio, crea un account separato per ciascuno.

Cosa succede se il codice sparisce dalla mia pagina Odoo?

Riapri il blocco Codice di incorporamento, incolla di nuovo lo snippet dal tuo account SEATEXT AI, salva e regola l'impostazione di Visibilità.

Devo davvero selezionare "Nascondi su desktop"?

I passaggi ufficiali dell'integrazione Odoo dicono di selezionare "Nascondi su desktop" nella sezione Visibilità e di salvare di nuovo. Questo nasconde il blocco mentre lo script rimane attivo.

Cosa devo cercare negli Strumenti per sviluppatori del browser?

Ricarica la pagina, apri la scheda Rete e cerca richieste ai server di SeaText. Se non ne vedi nessuna, è probabile che lo snippet non si stia caricando.

Se ho due siti web, mi servono due account?

Sì. Secondo la guida all'integrazione, ogni account è collegato a un URL primario. Crea un account per ciascun sito.