ドキュメント

ページ認識

ページ認識により、AIエージェントは訪問者が現在どのページにいるかを把握できます。これにより、よりコンテキストに即した関連性の高い回答が可能になり、担当者へエスカレーションする際に、より豊富なコンテキストを提供します。

ページ認識は ウェブウィジェットでのみ 動作します。Telegram やその他のメッセージングチャネルには「現在のページ」という概念がありません。

概要#

有効にすると、ウィジェットは訪問者の現在のページ URL、タイトル、説明を自動的に収集します。このコンテキストは AI のシステムプロンプトに注入され、ユーザーがどこを閲覧しているかに基づいて回答を調整できるようになります。

ページコンテキスト

エージェントは現在のページ URL、タイトル、メタ説明を見ることができます

エスカレーションコンテキスト

担当者は、エスカレーション時に訪問者の現在のページ情報を受け取ります

仕組み#

ウィジェットはページコンテキストを自動的に取得します — あなたのサイトにコード変更は不要です。各メッセージとともに収集される内容は次のとおりです:

データソース例
ページ URLwindow.location.hrefhttps://example.com/pricing
ページタイトルdocument.titlePricing — Acme Corp
パスwindow.location.pathname/pricing
説明meta[name=description]Compare our plans
リファラーdocument.referrerhttps://google.com

例: エージェントが見る内容#

/pricing にいる訪問者が "How much does it cost?" と尋ねると、エージェントのシステムプロンプトには次の内容が含まれます:

システムプロンプトに挿入される内容text
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.

セットアップ#

ページ認識はオプトイン機能です。有効にするには:

  1. Channels に移動し、Widget チャネルを選択します
  2. チャネルの設定/外観パネルで ページ認識 をオンにします(「ウィジェットは訪問者がどのページにいるかをエージェントに伝えます」)
  3. 変更を保存します
ウィジェットの埋め込みコードを変更する必要はありません。エージェントで機能が有効になると、ウィジェットは自動的にページコンテキストを送信します。

エスカレーションコンテキスト#

会話が担当者にエスカレーションされると、エスカレーション通知メールに、訪問者の現在のページコンテキストが自動的に含まれます。担当者は、尋ねることなく訪問者がどこを閲覧していたかを正確に把握できます。

エスカレーションメールには次が含まれます:

エスカレーションメール

件名: [YourBrand] Conversation Escalated

見出し: 「Case #123 needs a human」(ケース番号がない場合は「A customer needs a human」)

本文: 「A customer has been transferred to a human agent. Please review and respond.」 — 続いて、顧客の最後のメッセージと名前を引用したブロックが続きます

ファクトテーブル: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

会話を開く — ダッシュボード内の会話へ直接リンクするボタン

エスカレーションのページコンテキストは、ページ認識が有効であれば常に自動的に含まれます — 個別のトグルはありません。

トラブルシューティング#

ページ認識が動作していないように見える場合は、次の点を確認してください:

エージェントが現在のページを無視して一般的な回答を返す

Widget チャネルで ページ認識 がオンになっていて(Channels → Widget → 設定/外観パネル)、変更が保存されていることを確認してください。この機能はデフォルトで無効です。

エスカレーションメールにページコンテキストのセクションがない

Widget チャネルで ページ認識 が有効になっていて、保存されていることを確認してください。また、エージェント設定で エスカレーションアラート トグルが有効になっていることも確認してください(デフォルトではオフです)。アラートメールは、各チームメンバーの通知設定に基づいて、ワークスペースのチームメンバー — 割り当てられたチームメンバーまたは割り当てチーム — に送信されます。個別のエスカレーションメールアドレスの設定はありません。

ページタイトルが間違った値を表示する

ウィジェットは、ユーザーがメッセージを送信した時点で document.title を読み取ります。サイトが初回レンダリング後(例: 非同期)にタイトルを更新する場合、ウィジェットは送信時点で設定されている値を取得します。