Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Chat Incorporata

Visualizza il widget chat in linea nella tua pagina invece che come bolla flottante

Ottieni il codice di incorporamento
Tutti i piani

Panoramica

Per impostazione predefinita, il widget di chat Asyntai appare come un fumetto flottante nell'angolo del tuo sito web. Con la chat incorporata, puoi anche visualizzare la chat direttamente sulla tua pagina — ad esempio, in una sezione "Chatta con noi" sulla tua homepage.

Il fumetto flottante continua a funzionare insieme alla chat incorporata. I visitatori che non scorrono fino alla sezione incorporata possono comunque usare il fumetto. Entrambi condividono la stessa conversazione.

Come funziona

1
Aggiungi un tag script Posizionalo dove vuoi che la chat appaia nel tuo HTML
2
La chat viene visualizzata in linea Il widget appare in quella posizione, sempre visibile, delle stesse dimensioni della chat normale
3
Il fumetto resta attivo Il fumetto flottante rimane nell'angolo per i visitatori che non vedono la chat incorporata
4
Conversazione condivisa I messaggi si sincronizzano tra la chat incorporata e il widget flottante in tempo reale

Configurazione

Aggiungi questa singola riga di HTML dove vuoi che la chat appaia sulla tua pagina:

<script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Sostituisci YOUR_WIDGET_ID con il tuo widget ID. Puoi trovare il codice di incorporamento con il tuo ID precompilato nella pagina di configurazione della chat incorporata.

Nota: Lo script principale chat-widget.js deve essere presente anche sulla pagina. Se hai già installato il widget Asyntai sul tuo sito, questo è già stato fatto.

Esempio

Ecco come potresti usarlo in una homepage:

<section style="max-width: 500px; margin: 0 auto;">
    <h2>Chat with us</h2>
    <p>Ask us anything — our AI assistant is here to help.</p>

    <!-- The chat will appear right here -->
    <script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</section>

Dettagli

Dimensioni

La chat incorporata viene visualizzata con le stesse dimensioni del widget flottante: 400px di larghezza e 650px di altezza su desktop, larghezza piena e 550px di altezza su mobile. Puoi controllare il posizionamento tramite lo stile del contenitore padre.

Comportamento del fumetto flottante

Quando la chat incorporata è visibile sullo schermo e un visitatore clicca sul fumetto flottante, la pagina scorre fino alla chat incorporata. Se la chat incorporata non è visibile, il fumetto apre la normale sovrapposizione della chat flottante.

Sincronizzazione messaggi

Sia la chat incorporata che quella flottante condividono la stessa conversazione. I messaggi inviati da una qualsiasi delle due appaiono in entrambe. Vengono utilizzati la stessa sessione, contesto IA e cronologia della chat.

Pagine multiple

Puoi usare la chat incorporata su alcune pagine e il widget flottante standard su altre. Basta includere lo script di incorporamento nelle pagine dove vuoi la chat in linea. La conversazione prosegue tra le pagine come di consueto.

Anteprima dal vivo

Ecco una chat incorporata dal vivo così puoi vedere come appare:

Requisiti

Il widget di chat principale Asyntai (chat-widget.js) deve essere installato sulla pagina
Funziona con tutti i piani — nessun aggiornamento richiesto
Compatibile con tutti i browser che supportano Shadow DOM (tutti i browser moderni)

Suggerimento: Testa la chat incorporata posizionandola prima su una pagina di staging. Assicurati che appaia correttamente all'interno del layout della tua pagina prima di passare alla produzione.