Documentação

Consciência de página

A Consciência de página permite que o seu agente de IA saiba em que página o visitante se encontra. Isso possibilita respostas mais relevantes e sensíveis ao contexto e fornece um contexto mais rico ao escalar para atendentes.

A Consciência de página funciona apenas com o widget web. O Telegram e outros canais de mensagens não têm o conceito de "página atual".

Visão geral#

Quando ativado, o widget recolhe automaticamente o URL, o título e a descrição da página atual do visitante. Este contexto é injetado no prompt do sistema da IA, permitindo-lhe adaptar as respostas com base na página que o usuário está vendo.

Contexto de página

O agente vê o URL, o título e a meta descrição da página atual

Contexto de escalonamento

Os atendentes recebem a informação da página atual do visitante no escalonamento

Como funciona#

O widget captura o contexto da página automaticamente — não são necessárias alterações de código no seu site. Aqui está o que é recolhido em cada mensagem:

DadosFonteExemplo
URL da páginawindow.location.hrefhttps://example.com/pricing
Título da páginadocument.titlePricing — Acme Corp
Caminhowindow.location.pathname/pricing
Descriçãometa[name=description]Compare os nossos planos
Referenciadordocument.referrerhttps://google.com

Exemplo: o que o agente vê#

Quando um visitante em /pricing pergunta "Quanto custa?", o prompt do sistema do agente inclui:

Injetado no prompt do sistematext
PAGE CONTEXT (onde o usuário está neste momento):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare os nossos planos e preços

Use este contexto de página para dar respostas mais relevantes e específicas da página.

Configuração#

A Consciência de página é uma funcionalidade opcional (opt-in). Para a ativar:

  1. Acesse Channels e selecione o seu canal de Widget
  2. No painel de configurações/aparência do canal, ative Consciência de página ("O widget informa ao agente em que página o visitante está")
  3. Salve as suas alterações
Não são necessárias alterações ao código de incorporação do seu widget. O widget envia automaticamente o contexto da página assim que a funcionalidade for ativada no agente.

Contexto de escalonamento#

Quando uma conversa é escalada para um atendente, o e-mail de notificação de escalonamento inclui automaticamente o contexto da página atual do visitante. O atendente vê exatamente onde o visitante estava navegando, sem precisar perguntar.

O e-mail de escalonamento inclui:

E-mail de escalonamento

Assunto: [YourBrand] Conversation Escalated

Título: "Case #123 needs a human" (ou "A customer needs a human" quando não há número de caso)

Corpo: "A customer has been transferred to a human agent. Please review and respond." — seguido de um bloco citado com a última mensagem e o nome do cliente

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

Open conversation — um botão que leva diretamente à conversa no dashboard

O contexto de página no escalonamento é incluído automaticamente sempre que a Consciência de página está ativada — não há um botão separado.

Resolução de problemas#

Se a Consciência de página não parecer funcionar, verifique o seguinte:

O agente dá respostas genéricas, ignorando a página atual

Certifique-se de que Consciência de página está ativada para o seu canal de Widget (Channels → Widget → painel de configurações/aparência) e que as alterações foram salvas. O recurso vem desativado por padrão.

O e-mail de escalonamento não tem seção de contexto de página

Certifique-se de que Consciência de página está ativada no seu canal de Widget e salva. Confirme também que o botão Alertas de escalonamento está ativado nas configurações do agente (vem desativado por padrão). Os e-mails de alerta vão para os colegas de time do seu workspace — o colega atribuído ou a equipe de atribuição — de acordo com as preferências de notificação de cada um; não existe um endereço de e-mail de escalonamento separado para configurar.

O título da página mostra o valor errado

O widget lê document.title no momento em que o usuário envia uma mensagem. Se o seu site atualiza o título após a renderização inicial (por exemplo, de forma assíncrona), o widget captura o que estiver definido no momento do envio.