Documentación

Conciencia de página

La Conciencia de página permite que tu agente de IA sepa en qué página se encuentra el visitante en ese momento. Esto habilita respuestas más relevantes y con contexto, y aporta un contexto más rico al escalar a agentes humanos.

La Conciencia de página funciona solo con el widget web. Telegram y otros canales de mensajería no tienen el concepto de "página actual".

Descripción general#

Cuando está activada, el widget recopila automáticamente la URL, el título y la descripción de la página actual del visitante. Este contexto se inyecta en el prompt del sistema de la IA, lo que le permite adaptar las respuestas según dónde esté navegando el usuario.

Contexto de página

El agente ve la URL, el título y la meta descripción de la página actual

Contexto de escalado

Los agentes humanos reciben la información de la página actual del visitante al escalar

Cómo funciona#

El widget captura el contexto de la página automáticamente — sin cambios de código en tu sitio. Esto es lo que se recopila con cada mensaje:

DatoFuenteEjemplo
URL de la páginawindow.location.hrefhttps://example.com/pricing
Título de la páginadocument.titlePricing — Acme Corp
Rutawindow.location.pathname/pricing
Descripciónmeta[name=description]Compara nuestros planes
Referentedocument.referrerhttps://google.com

Ejemplo: lo que ve el agente#

Cuando un visitante en /pricing pregunta "¿Cuánto cuesta?", el prompt del sistema del agente incluye:

Inyectado en el prompt del sistematext
CONTEXTO DE PÁGINA (dónde está el usuario ahora mismo):
- Página: Pricing — Acme Corp
- Ruta: /pricing
- Descripción: Compara nuestros planes y precios

Usa este contexto de página para dar respuestas más relevantes y específicas de la página.

Configuración#

La Conciencia de página es una función opcional. Para activarla:

  1. Ve a Channels y selecciona tu canal de Widget
  2. En el panel de ajustes/apariencia del canal, activa Page awareness ("The widget tells the agent which page the visitor is on")
  3. Guarda tus cambios
No se necesita ningún cambio en el código de inserción de tu widget. El widget envía automáticamente el contexto de la página una vez que la función está activada en el agente.

Contexto de escalado#

Cuando una conversación se escala a un agente humano, el email de notificación de escalado incluye automáticamente el contexto de la página actual del visitante. El agente humano ve exactamente dónde estaba navegando el visitante sin tener que preguntar.

El email de escalado incluye:

Email de escalado

Asunto: [YourBrand] Conversation Escalated

Encabezado: "Case #123 needs a human" (o "A customer needs a human" cuando no hay número de caso)

Cuerpo: "A customer has been transferred to a human agent. Please review and respond." — seguido de un bloque citado con el último mensaje y el nombre del cliente

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

Open conversation — un botón que enlaza directamente con la conversación en el panel

El contexto de página en el escalado se incluye automáticamente siempre que la Conciencia de página está activada — no existe un interruptor aparte.

Resolución de problemas#

Si la Conciencia de página no parece funcionar, comprueba lo siguiente:

El agente da respuestas genéricas, ignorando la página actual

Asegúrate de que Page awareness esté activado para tu canal de Widget (Channels → Widget → panel de ajustes/apariencia) y de que los cambios se hayan guardado. La función está desactivada por defecto.

El email de escalado no tiene la sección de contexto de página

Asegúrate de que Page awareness esté activado en tu canal de Widget y guardado. Confirma también que el interruptor de Alertas de escalado esté activado en los ajustes del agente (está desactivado por defecto). Los emails de alerta van a los compañeros de tu espacio de trabajo — el compañero asignado o el equipo de asignación — según las preferencias de notificación de cada compañero; no hay una dirección de email de escalado aparte que configurar.

El título de la página muestra un valor incorrecto

El widget lee document.title en el momento en que el usuario envía un mensaje. Si tu sitio actualiza el título después del renderizado inicial (por ejemplo, de forma asíncrona), el widget captura lo que esté establecido en el momento del envío.