Documentatie

Paginabewustzijn

Met Paginabewustzijn weet je AI-agent op welke pagina de bezoeker zich op dat moment bevindt. Dit maakt relevantere, contextbewuste antwoorden mogelijk en biedt rijkere context bij escalatie naar menselijke medewerkers.

Paginabewustzijn werkt alleen met de webwidget. Telegram en andere berichtenkanalen kennen geen concept van een "huidige pagina".

Overzicht#

Wanneer ingeschakeld verzamelt de widget automatisch de huidige pagina-URL, titel en beschrijving van de bezoeker. Deze context wordt geïnjecteerd in de systeemprompt van de AI, zodat die antwoorden kan afstemmen op waar de gebruiker aan het browsen is.

Paginacontext

De agent ziet de huidige pagina-URL, titel en meta-beschrijving

Escalatiecontext

Menselijke medewerkers ontvangen bij escalatie de info over de huidige pagina van de bezoeker

Hoe het werkt#

De widget legt paginacontext automatisch vast — geen codewijzigingen nodig op je site. Dit is wat er bij elk bericht wordt verzameld:

DataBronVoorbeeld
Pagina-URLwindow.location.hrefhttps://example.com/pricing
Paginatiteldocument.titlePrijzen — Acme Corp
Padwindow.location.pathname/pricing
Beschrijvingmeta[name=description]Vergelijk onze plannen
Referrerdocument.referrerhttps://google.com

Voorbeeld: wat de agent ziet#

Wanneer een bezoeker op /pricing vraagt "Hoeveel kost het?", bevat de systeemprompt van de agent:

Geïnjecteerd in de systeemprompttext
PAGE CONTEXT (waar de gebruiker zich nu bevindt):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Vergelijk onze plannen en prijzen

Gebruik deze paginacontext om relevantere, paginaspecifieke antwoorden te geven.

Configuratie#

Paginabewustzijn is een opt-infunctie. Om het in te schakelen:

  1. Ga naar Channels en selecteer je Widget-kanaal
  2. Schakel op het instellingen-/appearancepaneel van het kanaal Paginabewustzijn in ("De widget vertelt de agent op welke pagina de bezoeker zich bevindt")
  3. Sla je wijzigingen op
Er zijn geen wijzigingen aan je widget-embedcode nodig. De widget stuurt automatisch paginacontext zodra de functie op de agent is ingeschakeld.

Escalatiecontext#

Wanneer een gesprek naar een menselijke agent wordt geëscaleerd, bevat de escalatie-notificatiemail automatisch de huidige paginacontext van de bezoeker. De menselijke agent ziet precies waar de bezoeker aan het browsen was, zonder ernaar te hoeven vragen.

De escalatiemail bevat:

Escalatiemail

Onderwerp: [YourBrand] Conversation Escalated

Kop: "Case #123 needs a human" (of "A customer needs a human" wanneer er geen casenummer is)

Body: "A customer has been transferred to a human agent. Please review and respond." — gevolgd door een geciteerd blok met het laatste bericht en de naam van de klant

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

Open conversation — een knop die rechtstreeks naar het gesprek in het dashboard linkt

Paginacontext bij escalatie wordt automatisch meegestuurd zodra Paginabewustzijn is ingeschakeld — er is geen aparte schakelaar.

Problemen oplossen#

Als Paginabewustzijn niet lijkt te werken, controleer het volgende:

De agent geeft generieke antwoorden en negeert de huidige pagina

Zorg ervoor dat Paginabewustzijn aan staat voor je Widget-kanaal (Channels → Widget → instellingen-/appearancepaneel) en dat de wijzigingen zijn opgeslagen. De functie is standaard uitgeschakeld.

De escalatiemail heeft geen paginacontextsectie

Zorg ervoor dat Paginabewustzijn is ingeschakeld op je Widget-kanaal en is opgeslagen. Bevestig ook dat de schakelaar Escalatiemeldingen in de agentinstellingen aan staat (deze staat standaard uit). Meldingsmails gaan naar de teamleden van je workspace — het toegewezen teamlid of het toewijzingsteam — op basis van de notificatievoorkeuren van elk teamlid; er is geen apart escalatie-emailadres om te configureren.

De paginatitel toont de verkeerde waarde

De widget leest document.title op het moment dat de gebruiker een bericht verstuurt. Als je site de titel na de initiële render bijwerkt (bijv. async), legt de widget vast wat er op het moment van verzenden is ingesteld.