Docs

Détection de page

La détection de page permet à votre agent IA de savoir sur quelle page se trouve actuellement le visiteur. Cela permet des réponses plus pertinentes et contextuelles et fournit un contexte plus riche lors de l’escalade vers des agents humains.

La détection de page fonctionne uniquement avec le widget web. Telegram et les autres canaux de messagerie n’ont pas de notion de "page courante".

Vue d’ensemble#

Lorsqu’il est activé, le widget collecte automatiquement l’URL, le titre et la description de la page courante du visiteur. Ce contexte est injecté dans le prompt système de l’IA, lui permettant d’adapter ses réponses en fonction de l’endroit où l’utilisateur navigue.

Contexte de page

L’agent voit l’URL, le titre et la méta-description de la page courante

Contexte d’escalade

Les agents humains reçoivent les informations de la page courante du visiteur lors de l’escalade

Comment ça fonctionne#

Le widget capture automatiquement le contexte de page — aucune modification de code n’est requise sur votre site. Voici ce qui est collecté avec chaque message :

DonnéeSourceExemple
URL de la pagewindow.location.hrefhttps://example.com/pricing
Titre de la pagedocument.titleTarifs — Acme Corp
Cheminwindow.location.pathname/pricing
Descriptionmeta[name=description]Comparez nos formules
Référentdocument.referrerhttps://google.com

Exemple : ce que voit l’agent#

Lorsqu’un visiteur sur /pricing demande "Combien ça coûte ?", le prompt système de l’agent inclut :

Injecté dans le prompt systèmetext
PAGE CONTEXT (where the user is right now):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare our plans and pricing

Use this page context to provide more relevant, page-specific answers.

Configuration#

La détection de page est une fonctionnalité opt-in. Pour l’activer :

  1. Allez dans Canaux et sélectionnez votre canal Widget
  2. Dans le panneau paramètres/apparence du canal, activez Détection de page (« Le widget indique à l’agent la page sur laquelle se trouve le visiteur »)
  3. Enregistrez vos modifications
Aucune modification de votre code d’intégration du widget n’est nécessaire. Le widget envoie automatiquement le contexte de page une fois la fonctionnalité activée sur l’agent.

Contexte d’escalade#

Lorsqu’une conversation est escaladée vers un agent humain, l’email de notification d’escalade inclut automatiquement le contexte de la page courante du visiteur. L’agent humain voit exactement où le visiteur naviguait sans avoir à le demander.

L’email d’escalade comprend :

Email d’escalade

Sujet : [YourBrand] Conversation Escalated

Titre : « Case #123 needs a human » (ou « A customer needs a human » lorsqu’il n’y a pas de numéro de dossier)

Corps : « A customer has been transferred to a human agent. Please review and respond. » — suivi d’un bloc de citation avec le dernier message du client et son nom

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

Open conversation — un bouton menant directement à la conversation dans le tableau de bord

Le contexte de page d’escalade est inclus automatiquement dès que la détection de page est activée — il n’existe pas de bouton bascule séparé.

Dépannage#

Si la détection de page ne semble pas fonctionner, vérifiez les points suivants :

L’agent donne des réponses génériques, ignorant la page courante

Assurez-vous que Détection de page est activée pour votre canal Widget (Canaux → Widget → panneau paramètres/apparence) et que les modifications ont été enregistrées. La fonctionnalité est désactivée par défaut.

L’email d’escalade n’a pas de section de contexte de page

Assurez-vous que Détection de page est activée sur votre canal Widget et enregistrée. Confirmez également que le bouton Alertes d’escalade est activé dans les paramètres de l’agent (il est désactivé par défaut). Les emails d’alerte sont envoyés aux coéquipiers de votre espace de travail — le coéquipier assigné ou l’équipe d’attribution — selon les préférences de notification de chacun ; il n’y a pas d’adresse email d’escalade séparée à configurer.

Le titre de la page affiche une valeur incorrecte

Le widget lit document.title au moment où l’utilisateur envoie un message. Si votre site met à jour le titre après le rendu initial (par ex. de façon asynchrone), le widget capture ce qui est défini au moment de l’envoi.