Documentazione

Consapevolezza della pagina

La Consapevolezza della pagina permette al tuo agente IA di sapere su quale pagina si trova attualmente il visitatore. Ciò abilita risposte più pertinenti e consapevoli del contesto, e fornisce un contesto più ricco durante l’escalation agli operatori.

La Consapevolezza della pagina funziona solo con il widget web. Telegram e altri canali di messaggistica non hanno il concetto di "pagina corrente".

Panoramica#

Quando abilitata, il widget raccoglie automaticamente l’URL, il titolo e la descrizione della pagina corrente del visitatore. Questo contesto viene iniettato nel prompt di sistema dell’IA, permettendole di adattare le risposte in base a dove l’utente sta navigando.

Contesto della pagina

L’agente vede l’URL, il titolo e la meta descrizione della pagina corrente

Contesto di escalation

Gli operatori ricevono le informazioni sulla pagina corrente del visitatore durante l’escalation

Come funziona#

Il widget cattura automaticamente il contesto della pagina — nessuna modifica al codice richiesta sul tuo sito. Ecco cosa viene raccolto con ogni messaggio:

DatoFonteEsempio
URL della paginawindow.location.hrefhttps://example.com/pricing
Titolo della paginadocument.titlePricing — Acme Corp
Percorsowindow.location.pathname/pricing
Descrizionemeta[name=description]Confronta i nostri piani
Referrerdocument.referrerhttps://google.com

Esempio: cosa vede l’agente#

Quando un visitatore su /pricing chiede "Quanto costa?", il prompt di sistema dell’agente include:

Iniettato nel prompt di sistematext
PAGE CONTEXT (dove si trova l'utente in questo momento):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Confronta i nostri piani e prezzi

Usa questo contesto della pagina per fornire risposte più pertinenti e specifiche per la pagina.

Configurazione#

La Consapevolezza della pagina è una funzione opt-in. Per abilitarla:

  1. Vai su Channels e seleziona il tuo canale Widget
  2. Nel pannello impostazioni/aspetto del canale, attiva Consapevolezza della pagina ("Il widget comunica all’agente su quale pagina si trova il visitatore")
  3. Salva le modifiche
Non sono necessarie modifiche al codice di embed del tuo widget. Il widget invia automaticamente il contesto della pagina una volta che la funzione è abilitata sull’agente.

Contesto di escalation#

Quando una conversazione viene passata a un operatore, l’email di notifica dell’escalation include automaticamente il contesto della pagina corrente del visitatore. L’operatore vede esattamente dove il visitatore stava navigando senza doverlo chiedere.

L’email di escalation include:

Email di escalation

Oggetto: [YourBrand] Conversation Escalated

Intestazione: "Case #123 needs a human" (oppure "A customer needs a human" quando non c’è un numero di caso)

Corpo: "A customer has been transferred to a human agent. Please review and respond." — seguito da un blocco citato con l’ultimo messaggio del cliente e il suo nome

Tabella dei fatti: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation — un pulsante che porta direttamente alla conversazione nella dashboard

Il contesto della pagina nell’escalation viene incluso automaticamente ogni volta che la Consapevolezza della pagina è abilitata — non esiste un interruttore separato.

Risoluzione dei problemi#

Se la Consapevolezza della pagina non sembra funzionare, controlla quanto segue:

L’agente dà risposte generiche, ignorando la pagina corrente

Assicurati che Consapevolezza della pagina sia attivata per il tuo canale Widget (Channels → Widget → pannello impostazioni/aspetto) e che le modifiche siano state salvate. La funzione è disabilitata per impostazione predefinita.

L’email di escalation non ha la sezione del contesto della pagina

Assicurati che Consapevolezza della pagina sia abilitata sul tuo canale Widget e salvata. Conferma inoltre che l’interruttore Avvisi di escalation sia abilitato nelle impostazioni dell’agente (è disattivato per impostazione predefinita). Le email di avviso vanno ai membri del tuo workspace — il membro assegnato o il team di assegnazione — in base alle preferenze di notifica di ciascun membro; non c’è un indirizzo email di escalation separato da configurare.

Il titolo della pagina mostra il valore errato

Il widget legge document.title nel momento in cui l’utente invia un messaggio. Se il tuo sito aggiorna il titolo dopo il rendering iniziale (ad es. in modo asincrono), il widget cattura quello impostato al momento dell’invio.